請求
請求
HTTP 請求
接受請求
要通過依賴注入獲取當(dāng)前 HTTP 請求實(shí)例，你應(yīng)該在控制器上引入 Illuminate\Http\Request 類， 傳入的請求實(shí)例將會由 服務(wù)容器 自動注入：
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
class UserController extends Controller{
/**
* 存儲一個(gè)新用戶。
*
* @param Request $request
* @return Response
*/
public function store(Request $request)
{
$name = $request->input('name');
//
}
}依賴注入 & 路由參數(shù)
如果你的控制器需要從路由參數(shù)中獲取數(shù)據(jù)，你應(yīng)該在其他依賴項(xiàng)之后列入?yún)?shù)。舉個(gè)例子，你的路由是這樣定義的：
Route::put('user/{id}', 'UserController@update');你可以通過下面的方法來定義控制器，使用 Illuminate\Http\Request 類來獲取你的路由參數(shù) id：
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
class UserController extends Controller{
/**
* 更新指定用戶
*
* @param Request $request
* @param string $id
* @return Response
*/
public function update(Request $request, $id)
{
//
}
}通過閉包路由獲取參數(shù)
你也可以在路由閉包中使用 Illuminate\Http\Request 類， 服務(wù)容器會自動的將請求參數(shù)注入到路由閉包中：
use Illuminate\Http\Request;
Route::get('/', function (Request $request) {
//
});請求路徑 & 方法
Illuminate\Http\Request 實(shí)例提供了一系列方法來驗(yàn)證 HTTP 請求參數(shù)，并繼承了 Symfony\Component\HttpFoundation\Request 類 。下面是該類的一些重要方法：
獲取請求路徑
path 方法返回請求的路徑信息。所以，如果請求的路徑是 http://domain.com/foo/bar， path 方法將會返回 foo/bar:
$uri = $request->path();
is 可以驗(yàn)證傳入的請求路徑是否與給定的模式匹配。 在這個(gè)方法中，你也可以使用 * 字符作為通配符：
if ($request->is('admin/*')) {
//
}獲取請求 URL
可以使用 url 或 fullUrl 方法獲取完整的請求 URL。 url 方法返回不含有查詢串的 URL， fullUrl 獲取包含查詢串的 URL：
// 不附帶查詢串... $url = $request->url(); // 附帶查詢串... $url = $request->fullUrl();
獲取請求 Method
method 方法返回請求的 HTTP 動作。還可以使用 isMethod 方法校驗(yàn) HTTP 動作是否與給定的客串上匹配：
$method = $request->method();if ($request->isMethod('post')) {
//
}PSR-7 請求
PSR-7 standard 定義了 HTTP 消息接口，包括 請求 和 響應(yīng)。如果你想用 PSR-7 請求代替 Laravel 請求，需要先安裝幾個(gè)庫。 Laravel 使用 Symfony HTTP Message Bridge 組件將典型的 Laravel 請求 和 響應(yīng) 轉(zhuǎn)換為 PSR-7 兼容實(shí)現(xiàn)：
composer require symfony/psr-http-message-bridge composer require zendframework/zend-diactoros
一旦安裝了這些庫，就可以通過在路由閉包或控制器方法中的請求接口類型提示來獲取 PSR-7 請求：
use Psr\Http\Message\ServerRequestInterface;
Route::get('/', function (ServerRequestInterface $request) {
//
});{tip} 如果從路由或控制器返回 PSR-7 響應(yīng)實(shí)例，框架會自動將其轉(zhuǎn)換回 Laravel 響應(yīng)實(shí)例并顯示。
輸入的裁剪和標(biāo)準(zhǔn)化
默認(rèn)情況下，Laravel 在應(yīng)用的全局中間件堆棧中包含了 TrimStrings 和 ConvertEmptyStringsToNull 中間件。這些中間件被放在 App\Http\Kernel 類的堆棧列表中。它們自動裁剪請求中的所有輸入字符串域，同時(shí)將空字符串域轉(zhuǎn)換為 null。這樣一來，你就不必?fù)?dān)心路由和控制器中的標(biāo)準(zhǔn)化規(guī)約問題。
如果想要禁用這個(gè)行為，只需要通過從 App\Http\Kernel 類的 $middleware 屬性中移除它（相當(dāng)于從應(yīng)用的中間件堆棧中移除）。
獲取輸入
獲取所有的輸入數(shù)據(jù)
可以使用 all 方法獲取所有輸入數(shù)據(jù)數(shù)組：
$input = $request->all();
獲取單個(gè)輸入值
使用一些簡便方法，就可以通 實(shí)例過 Illuminate\Http\Request 實(shí)例獲取用戶的全部輸入，不需要擔(dān)心用戶請求用的是哪種 HTTP 動作。無論哪種 HTTP 動作， 用戶的請求都能被 input 方法獲?。?/p>
$name = $request->input('name');可以將默認(rèn)值作為傳遞給 input 方法的第二個(gè)參數(shù)。這個(gè)值將在請求沒有包含該參數(shù)時(shí)被返回：
$name = $request->input('name', 'Sally');當(dāng)與包含數(shù)組輸入的表單協(xié)作時(shí)，使用 「點(diǎn)」 運(yùn)算符訪問數(shù)組元素：
$name = $request->input('products.0.name');
$names = $request->input('products.*.name');不帶參數(shù)調(diào)用 input 方法，能夠獲取全部輸入值（關(guān)聯(lián)數(shù)組形式）：
$input = $request->input();
從查詢串中獲取輸入
input 方法從整個(gè)請求載體中獲取值（包括查詢串）， query 方法則僅從查詢串中獲取值：
$name = $request->query('name');如果查詢串值不存在，query 方法的第二個(gè)參數(shù)將被作為該參數(shù)的默認(rèn)值被返回：
$name = $request->query('name', 'Helen');不帶參數(shù)調(diào)用 query 方法，能夠獲取查詢串的所有值（關(guān)聯(lián)數(shù)組形式）：
$query = $request->query();
通過動態(tài)屬性獲取輸入
可以通過 Illuminate\Http\Request 實(shí)例的動態(tài)屬性訪問用戶輸入。例如，如果應(yīng)用表單包含 name 域，可以像下面這樣訪問該域的值：
$name = $request->name;
在使用動態(tài)屬性時(shí)，Laravel 首先會在請求載體中查找參數(shù)的值。如果該值不存在，Lavarel 將在路由參數(shù)中搜索。
獲取 JSON 輸入
當(dāng)向應(yīng)用傳遞 JSON 請求時(shí)，可以通過 input 方法訪問 JSON 數(shù)據(jù)，只要將請求的 Content-Type 頭設(shè)置為 application/json。 同樣可以使用 「點(diǎn)」語法訪問 JSON 數(shù)組：
$name = $request->input('user.name');獲取部分輸入數(shù)據(jù)
如果需要獲取輸入數(shù)據(jù)的子集，可以使用 only 或 except 方法。它們接受單個(gè) array 或者動態(tài)參數(shù)列表：
$input = $request->only(['username', 'password']);
$input = $request->only('username', 'password');
$input = $request->except(['credit_card']);
$input = $request->except('credit_card');{tip}
only方法返回請求中的全部鍵值對；但是它不返回請求中不存在的鍵值對。
判斷輸入值是否存在
has 方法用于判定請求中是否存在指定的值。如果請求中存在該值， has 方法返回 true ：
if ($request->has('name')) {
//
}如果給出一個(gè)數(shù)組， has 方法將判斷在請求中，指定的值是否全部存在：
if ($request->has(['name', 'email'])) {
//
}如果想要判斷一個(gè)值在請求中是否存在，并且不為空，需要使用 filled 方法：
if ($request->filled('name')) {
//
}舊數(shù)據(jù)
Laravel 允許你在兩次請求之間保持?jǐn)?shù)據(jù)。這個(gè)特性在有效性校驗(yàn)出錯(cuò)后重新填充表單時(shí)非常有用。不過，如果你使用 Lavarel 自帶 驗(yàn)證特性，不需要自己手動調(diào)用這些方法因?yàn)橐恍?Laravel 內(nèi)置的驗(yàn)證功能會自動調(diào)用它們。
將輸入數(shù)據(jù)傳送到 Session
Illuminate\Http\Request 類的 flash 方法將把當(dāng)前的輸入傳送到 session ，在用戶向應(yīng)用發(fā)出這一次請求時(shí)它們?nèi)匀豢捎茫?/p>
$request->flash();
可以使用 flashOnly 或 flashExcept 方法將請求數(shù)據(jù)的子集傳送給 session。這些方法常用于將密碼之類的敏感數(shù)據(jù)排除在 session 保持之外：
$request->flashOnly(['username', 'email']);$request->flashExcept('password');傳送數(shù)據(jù)并跳轉(zhuǎn)
當(dāng)你經(jīng)常需要將輸入傳送至 session 并緊接著跳轉(zhuǎn)至之前的頁面，可以通過在跳轉(zhuǎn)函數(shù)后鏈接調(diào)用 withInput 方法輕易地實(shí)現(xiàn)：
return redirect('form')->withInput();
return redirect('form')->withInput(
$request->except('password')
);獲取舊數(shù)據(jù)
要獲取前一次請求傳送的數(shù)據(jù)，可以使用 Request 實(shí)例的 old 方法。 old 方法將從 session 拉取之前傳送的值：
$username = $request->old('username');Laravel 還提供了全局的 old 助手。如果要在 Blade 模板中 顯示舊數(shù)據(jù)， old 助手更易用。如果給定域的舊值不存在，它將返回 null ：
<input type="text" name="username" value="{{ old('username') }}">Cookies
從請求中獲取 Cookies
Lavarel 框架生成的全部 cookies 都是加密的，并且已經(jīng)用授權(quán)碼簽名，這意味著如果它們被客戶端改變就會失效。使用 Illuminate\Http\Request 實(shí)例的 cookie 方法可以從請求中獲取 cookie 值：
$value = $request->cookie('name');也可以使用 Cookie facade 訪問 cookie 值：
$value = Cookie::get('name');將 Cookies 附加到響應(yīng)中
可以使用 cookie 方法向輸出的 Illuminate\Http\Response 實(shí)例附加 cookie。需要傳遞 名稱、值、cookie 的過期時(shí)間（以分鐘為單位）給該方法：
return response('Hello World')->cookie(
'name','value',$minutes
);cookie 還可以接受另外幾個(gè)不太常用的參數(shù)。通常這些參數(shù)和 PHP 內(nèi)置的 setcookie 方法的參數(shù)有著相同的作用和意義：
return response('Hello World')->cookie(
'name', 'value', $minutes, $path, $domain, $secure, $httpOnly
);同樣，你可以使用 Cookie facade 來 「排列」 用于從應(yīng)用中附加到輸出響應(yīng)的 cookies。queue 方法接受一個(gè) Cookie 實(shí)例或者用于創(chuàng)建 Cookie 所需的參數(shù)列表。這些 cookies 將在輸出響應(yīng)被發(fā)送至瀏覽器前被附加：
Cookie::queue(Cookie::make('name', 'value', $minutes));
Cookie::queue('name', 'value', $minutes);生成 Cookie 實(shí)例
如果想要生成一個(gè)隨后可以提供給響應(yīng)實(shí)例的 Symfony\Component\HttpFoundation\Cookie 實(shí)例，可以使用全局的 cookie 助手。這個(gè) cookie 在沒有附加到響應(yīng)實(shí)例前不會傳回客戶端：
$cookie = cookie('name', 'value', $minutes);
return response('Hello World')->cookie($cookie);文件
獲取上傳的文件
可以使用 Illuminate\Http\Request 實(shí)例的 file 方法或者動態(tài)屬性訪問上傳文件。 file 方法返回 Illuminate\Http\UploadedFile 類的實(shí)例，這個(gè)類擴(kuò)展自 PHP 的 SplFileInfo 類并提供用于文件交互的多個(gè)方法：
$file = $request->file('photo');
$file = $request->photo;可以使用 hasFile 方法判斷請求中是否存在指定文件：
if ($request->hasFile('photo'))
{
//
}驗(yàn)證成功上傳
除了驗(yàn)證文件是否存在，還可以使用 isValid 方法校驗(yàn)上傳的文件有沒有問題：
if ($request->file('photo')->isValid()) {
//
}文件路徑 & 擴(kuò)展名
UploadedFile 類還包含訪問文件的全路徑和擴(kuò)展名的方法。 extension 方法基于文件的內(nèi)容猜測匹配的文件擴(kuò)展名。這個(gè)擴(kuò)展名有可能和客戶端提供的擴(kuò)展名不同：
$path = $request->photo->path(); $extension = $request->photo->extension();
其它的文件方法
UploadedFile 實(shí)例還有另外幾個(gè)方法可用。瀏覽 這個(gè)類的 API 文檔 可以獲取這些方法的更多信息。
存儲上傳文件
要存儲上傳的文件，先配置好 文件系統(tǒng)。你可以使用 UploadedFile 的 store 方法把上傳文件移動到你的某個(gè)磁盤上，該文件可能是本地文件系統(tǒng)中的一個(gè)位置，甚至像 Amazon S3 這樣的云存儲位置。
store 方法接受相對于文件系統(tǒng)配置的存儲文件根目錄的路徑。這個(gè)路徑不能包含文件名，因?yàn)橄到y(tǒng)會自動生成唯一的 ID 作為文件名。
store 方法還接受可選的第二個(gè)參數(shù)，用于存儲文件的磁盤名稱。這個(gè)方法會返回相對于磁盤根目錄的文件路徑：
$path = $request->photo->store('images');
$path = $request->photo->store('images', 's3');如果你不想自動生成文件名，那么可以使用 storeAs 方法，它接受路徑、文件名和磁盤名作為其參數(shù)：
$path = $request->photo->storeAs('images', 'filename.jpg');
$path = $request->photo->storeAs('images', 'filename.jpg', 's3');配置可信代理
如果你的應(yīng)用程序運(yùn)行在失效的 TLS / SSL 證書的負(fù)載均衡器后，你可能會注意到你的應(yīng)用程序有時(shí)不能生成 HTTPS 鏈接。通常這是因?yàn)槟愕膽?yīng)用程序正在從端口 80 上的負(fù)載均衡器轉(zhuǎn)發(fā)流量，卻不知道是否應(yīng)該生成安全鏈接。
解決這個(gè)問題需要在 Laravel 應(yīng)用程序中包含 App\Http\Middleware\TrustProxies 中間件，這使得你可以快速自定義應(yīng)用程序信任的負(fù)載均衡器或代理。你的可信代理應(yīng)該作為這個(gè)中間件的 $proxies 屬性的數(shù)組列出。除了配置受信任的代理之外，還可以配置應(yīng)該信任的代理 $header:
<?php
namespace App\Http\Middleware;
use Illuminate\Http\Request;
use Fideloper\Proxy\TrustProxies as Middleware;
class TrustProxies extends Middleware{
/**
* 應(yīng)用程序的可信代理列表
*
* @var array
*/
protected $proxies = [
'192.168.1.1',
'192.168.1.2',
];
/**
* 應(yīng)該用來檢測代理的頭信息
*
* @var string
*/
protected $headers = Request::HEADER_X_FORWARDED_ALL;}{tip} 如果你使用 AWS 彈性負(fù)載平衡，你的
$header值應(yīng)該是Request::HEADER_X_FORWARDED_AWS_ELB。常量的更多信息，可用于$headers屬性，看看 Symfony 的 文檔 信任代理.
信任所有代理
如果你使用 Amazon AWS 或其他的「云」負(fù)載均衡器提供程序，你可能不知道負(fù)載均衡器的實(shí)際 IP 地址。在這種情況下，你可以使用 * 來信任所有代理：
/** * 應(yīng)用程序的可信代理列表 * * @var array */ protected $proxies = '*';