請求
請求
HTTP 請求
接受請求
要通過依賴注入獲取當(dāng)前 HTTP 請求實(shí)例,你應(yīng)該在控制器上引入 Illuminate\Http\Request
類, 傳入的請求實(shí)例將會由 服務(wù)容器 自動(dòng)注入:
<?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ù)容器會自動(dòng)的將請求參數(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 動(dòng)作。還可以使用 isMethod
方法校驗(yàn) HTTP 動(dòng)作是否與給定的客串上匹配:
$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í)例,框架會自動(dòng)將其轉(zhuǎn)換回 Laravel 響應(yīng)實(shí)例并顯示。
輸入的裁剪和標(biāo)準(zhǔn)化
默認(rèn)情況下,Laravel 在應(yīng)用的全局中間件堆棧中包含了 TrimStrings
和 ConvertEmptyStringsToNull
中間件。這些中間件被放在 App\Http\Kernel
類的堆棧列表中。它們自動(dòng)裁剪請求中的所有輸入字符串域,同時(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 動(dòng)作。無論哪種 HTTP 動(dòng)作, 用戶的請求都能被 input
方法獲取:
$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();
通過動(dòng)態(tài)屬性獲取輸入
可以通過 Illuminate\Http\Request
實(shí)例的動(dòng)態(tài)屬性訪問用戶輸入。例如,如果應(yīng)用表單包含 name
域,可以像下面這樣訪問該域的值:
$name = $request->name;
在使用動(dòng)態(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
或者動(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
方法返回請求中的全部鍵值對;但是它不返回請求中不存在的鍵值對。
判斷輸入值是否存在
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)證特性,不需要自己手動(dòng)調(diào)用這些方法因?yàn)橐恍?Laravel 內(nèi)置的驗(yàn)證功能會自動(dòng)調(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
方法或者動(dòng)態(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
方法把上傳文件移動(dòng)到你的某個(gè)磁盤上,該文件可能是本地文件系統(tǒng)中的一個(gè)位置,甚至像 Amazon S3 這樣的云存儲位置。
store
方法接受相對于文件系統(tǒng)配置的存儲文件根目錄的路徑。這個(gè)路徑不能包含文件名,因?yàn)橄到y(tǒng)會自動(dòng)生成唯一的 ID 作為文件名。
store
方法還接受可選的第二個(gè)參數(shù),用于存儲文件的磁盤名稱。這個(gè)方法會返回相對于磁盤根目錄的文件路徑:
$path = $request->photo->store('images'); $path = $request->photo->store('images', 's3');
如果你不想自動(dòng)生成文件名,那么可以使用 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 = '*';