访问请求实例
要通过依赖注入获取当前 HTTP 请求实例,需要在控制器的构造函数或方法中对 Illuminate\Http\Request
类进行类型提示,这样当前请求实例会被服务容器自动注入:
input('name');
//
}
}
依赖注入 & 路由参数
如果你的控制器方法还期望获取路由参数,只需要将路由参数置于其它依赖之后即可,例如,如果你的路由定义如下:
Route::put('user/{id}','UserController@update');
你仍然可以对 Illuminate\Http\Request
进行类型提示并通过如下方式定义控制器方法来访问路由参数 id
:
通过路由闭包访问请求
还可以在路由闭包上类型提示 Illuminate\Http\Request
类,在执行的时候服务容器会自动注入输入的请求到闭包:
use Illuminate\Http\Request;
Route::get('/', function (Request $request) {
//
});
请求路径 & 方法
Illuminate\Http\Request
实例提供了多个方法来检测应用的 HTTP 请求,Laravel 的 Illuminate\Http\Request
继承自 Symfony\Component\HttpFoundation\Request
类,下面演示了该类提供的一些有用方法:
获取请求路径
path
方法将会返回请求的路径信息,因此,如果进入的请求路径是 http://domain.com/foo/bar
,则 path
方法将会返回 foo/bar
:
$uri=$request->path();
is
方法允许你验证进入的请求是否与给定模式匹配。使用该方法时可以使用 *
通配符:
if($request->is('admin/*')){
//
}
获取请求URL
想要获取完整的 URL
,而不仅仅是路径信息,可以使用请求实例提供的 url
或 fullUrl
方法,url
方法将会返回不带查询字符串的 URL
,而 fullUrl
方法返回结果则包含查询字符串:
// 不包含查询字符串
$url = $request->url();
// 包含查询字符串
$url = $request->fullUrl();
获取请求方法
method
方法将会返回 HTTP 请求方式。你还可以使用 isMethod
方法来验证 HTTP 请求方式是否匹配给定字符串:
$method=$request->method();if($request->isMethod('post')){ //}
PSR-7 请求
PSR-7 标准指定了 HTTP 消息接口,包括请求和响应。如果你想要获取 PSR-7 请求实例,首先需要安装一些库,Laravel 使用 Symfony HTTP Message Bridge
组件将典型的 Laravel 请求和响应转化为 兼容PSR-7
的实现:
composer require symfony/psr-http-message-bridgecomposer
require zendframework/zend-diactoros
安装完这些库之后,你只需要在路由或控制器中通过对请求类型进行类型提示就可以获取PSR-7
请求:
use Psr\Http\Message\ServerRequestInterface;
Route::get('/', function (ServerRequestInterface $request) {
//
});
注:如果从路由或控制器返回的是
PSR-7
响应实例,则其将会自动转化为 Laravel 响应实例并显示出来。
输入修整 & 正常化
默认情况下,Laravel 在 App\Http\Kernel
的全局中间件堆栈中引入了 TrimStrings
和 ConvertEmptyStringsToNull
中间件。这些中间件会自动对请求中的字符串字段进行处理,前者将字符串两端的空格清除,后者将空字符串转化为 null
。这样,在路由和控制器中我们就不必对字符串字段做额外的处理。
如果你想要禁止该行为,可以从App\Http\Kernel
的中间件堆栈属性 $middleware
中移除这两个中间件。
获取请求输入
获取所有输入值
你可以使用 all
方法以数组格式获取所有输入值:
$input = $request->all();
获取单个输入值
使用一些简单的方法,就可以从 Illuminate\Http\Request
实例中访问用户输入。你不需要关心请求所使用的 HTTP
请求方法,因为对所有请求方式的输入都是通过input
方法获取用户输入:
$name = $request->input('name');
你还可以传递一个默认值作为第二个参数给 input
方法,如果请求输入值在当前请求未出现时该值将会被返回:
$name = $request->input('name', 'Sally');
处理表单数组输入时,可以使用”.”来访问数组输入:
$input = $request->input('products.0.name');
$names = $request->input('products.*.name');
通过动态属性获取输入
此外,你还可以通过使用 Illuminate\Http\Request
实例上的动态属性来访问用户输入。例如,如果你的应用表单包含 name
字段,那么可以像这样访问提交的值:
$name = $request->name;
使用动态属性的时候,Laravel 首先会在请求中查找参数的值,如果不存在,还会到路由参数中查找。
获取JSON输入值
发送JSON请求到应用的时候,只要 Content-Type
请求头被设置为 application/json
,都可以通过input
方法获取 JSON 数据,还可以通过“.”号解析数组:
$name = $request->input('user.name');
获取输入的部分数据
如果你需要取出输入数据的子集,可以使用 only
或 except
方法,这两个方法都接收一个数组或动态列表作为唯一参数:
$input = $request->only(['username', 'password']);
$input = $request->only('username', 'password');
$input = $request->except(['credit_card']);
$input = $request->except('credit_card');
only
方法返回你所请求的所有键值对,即使输入请求中不包含你所请求的键,当对应键不存在时,对应返回值为 null
,如果你想要获取输入请求中确实存在的部分数据,可以使用 intersect
方法:
$input = $request->intersect(['username', 'password']);
判断输入值是否存在
判断值是否在请求中存在,可以使用 has
方法,如果值出现过了且不为空,has
方法返回 true
:
if ($request->has('name')) {
//
}
上一次请求输入
Laravel 允许你在两次请求之间保存输入数据,这个特性在检测校验数据失败后需要重新填充表单数据时很有用,但如果你使用的是 Laravel 自带的验证服务,则不需要手动使用这些方法,因为一些 Laravel 自带的校验设置会自动调用它们。
将输入存储到一次性 Session
Illuminate\Http\Request
实例的 flash
方法会将当前输入存放到一次性 Session(所谓的一次性指的是从 Session 中取出数据后,对应数据会从 Session 中销毁)中,这样在下一次请求时数据依然有效:
$request->flash();
你还可以使用 flashOnly
和 flashExcept
方法将输入数据子集存放到 Session
中,这些方法在 Session
之外保存敏感信息时很有用:
$request->flashOnly('username', 'email');
$request->flashExcept('password');
将输入存储到一次性 Session 然后重定向
如果你经常需要一次性存储输入并重定向到前一页,可以使用 withInput
方法来将输入数据添加到 redirect
后面:
return redirect('form')->withInput();
return redirect('form')->withInput($request->except('password'));
取出上次请求数据
要从 Session
中取出上次请求的输入数据,可以使用 Request 实例的 old
方法。old
方法可以很方便地从Session
中取出一次性数据:
$username = $request->old('username');
Laravel 还提供了一个全局的辅助函数 old
,如果你是在 Blade 模板中显示上次输入数据,使用辅助函数 old
更方便,如果给定参数没有对应输入,返回null
:
文件上传
获取上传的文件
可以使用 Illuminate\Http\Request
实例提供的 file
方法或者动态属性来访问上传文件, file
方法返回Illuminate\Http\UploadedFile
类的一个实例,该类继承自 PHP 标准库中提供与文件交互方法的 SplFileInfo
类:
$file = $request->file('photo');$file = $request->photo;
你可以使用 hasFile
方法判断文件在请求中是否存在:
if ($request->hasFile('photo')) {
//
}
验证文件是否上传成功
使用 isValid
方法判断文件在上传过程中是否出错:
if ($request->file('photo')->isValid()){
//
}
文件路径 & 扩展名
UploadedFile
类还提供了访问上传文件绝对路径和扩展名的方法。 extension
方法可以基于文件内容判断文件扩展名,该扩展名可能会和客户端提供的扩展名不一致:
$path = $request->photo->path();
$extension = $request->photo->extension();
其他文件方法
UploadedFile
实例上还有很多其他可用方法,查看该类的API文档了解更多信息。
保存上传的文件
要保存上传的文件,通常需要使用你所配置的其中一个文件系统, UploadedFile
类有一个 store
方法,该方法会将上传文件移动到相应的磁盘路径上,该路径可以是本地文件系统的某个位置,也可以是云存储(如Amazon S3)上的路径。
store
方法接收一个文件保存的相对路径(相对于文件系统配置的根目录 ),该路径不应该包含文件名,因为系统会自动生成一个唯一ID作为文件名。
store
方法还接收一个可选的参数——用于存储文件的磁盘名称作为第二个参数,该方法会方返回相对于根目录的文件路径:
$path = $request->photo->store('images');
$path = $request->photo->store('images', 's3');
如果你不想自动生成文件名,可以使用 storeAs
方法,该方法接收保存路径、文件名和磁盘名作为参数:
$path = $request->photo->storeAs('images', 'filename.jpg');
$path = $request->photo->storeAs('images', 'filename.jpg', 's3');