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