在控制器方法中获取路由参数,只需要将路由参数置于其它依赖之后即可,例如,如果你的路由定义如下:
use App\Http\Controllers\UserController;
Route::put('user/{id}', [UserController::class, 'update']);
你仍然可以对 Illuminate\Http\Request 进行依赖注入并通过如下方式定义控制器方法来访问路由参数 id:
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
class UserController extends Controller
{
/**
* 更新指定用户
*
* @param Request $request
* @param int $id
* @return Response
*/
public function update(Request $request, $id)
{
// do something
}
}
use Illuminate\Http\Request;
Route::get('/', function (Request $request) {
// do something
});
Illuminate\Http\Request 继承自 Symfony\Component\HttpFoundation\Request 类,提供了多个方法来检测应用的 HTTP 请求,下面我们来演示其提供的一些获取请求路径和请求方式的方法
// path 方法将会返回请求的路径信息不会返回查询字符串,因此,如果请求URL是 http://blog.test/user/1?age=23,则 path 方法将会返回 user/1
$path = $request->path();
is 方法允许你验证请求路径是否与给定模式匹配。该方法参数支持 * 通配符:
if($request->is('user/*')){
// do something
}
想要获取完整的 URL,而不仅仅是路径信息,可以使用请求实例提供的 url 或 fullUrl 方法, url 方法返回不带查询字符串的 URL,而 fullUrl 方法返回结果则包含查询字符串:
// 不包含查询字符串
$url = $request->url();
// 包含查询字符串
$url_with_query = $request->fullUrl();
//例如,我们请求 http://blog.test/user/1?age=100,
//则上述 $url 的值是 http://blog.test/user/1,
//$url_with_query 的值是 http://blog.test/user/1?age=100
method 方法将会返回 HTTP 请求方式。你还可以使用 isMethod 方法来验证 HTTP 请求方式是否匹配给定字符串:
$method = $request->method(); // GET/POST
if($request->isMethod('post')){
// true or false
}
if($request->isMethod('GET')){
// do something 大小写都可以
}
默认情况下,Laravel 在 App\Http\Kernel 的全局中间件堆栈中引入了 TrimStrings 和 ConvertEmptyStringsToNull 中间件。这些中间件会自动对请求中的字符串字段进行处理,前者将字符串两端的空格清除,后者将空字符串转化为 null。这样,在路由和控制器中我们就不必对字符串字段做额外的处理
可以使用 all 方法以数组格式获取所有输入值
$input = $request->all(); // 这样可以
$input = $request->input(); //这样也可以
// 若请求的地址为http://laravel8.test/user/info/1?age=12&name=jojo
//则$input值为['age'=>'12','name'=>'jojo']
$name = $request->input('name', 'default');
// 这样可以 第二个参数为name不存在时的默认值可省略 若name=null
//则返回"null"字符串而不是'default'
$name = $request->name; // 这样也可以,使用动态属性的时候,
//Laravel 首先会在请求中查找参数的值,如果不存在,还会到路由参数中查找。 不存在时返回null
// 若请求的地址为http://laravel8.test/user/info/1?age=12&name=jojo
//则$name值为"jojo"
处理表单数组输入时,可以使用”.”来访问数组输入:
// 若请求的地址为http://laravel8.test/user/info/1?products[][name]=jkjk&products[][name]=jojo
$input = $request->input('products.0.name');
// 则$input值为'jkjk'
$names = $request->input('products.*.name');
// $names的值为 [0=>'jkjk',1=>'jojo'] 相当于 ['jkjk','jojo']
input 方法会从 整个请求负载(包括查询字符串) 中获取数值,query则只会从查询字符串中获取数值:
$name = $request->query('name','default');
//第二个参数同input一样
$query = $request->query();
//不加参数以关联数组的方式获取整个查询字符串的值
query 方法就是从 query 属性对象中获取参数值,input 方法会从 query + request 属性对象中获取参数值,请求实例上还有个 post 方法用于从 request 属性对象中获取参数值,讲到这里我们应该有点眉目了,query 方法用于获取 GET 请求查询字符串参数值,input 方法用于获取所有 HTTP 请求参数值,post 方法用于获取 POST 请求参数值。感兴趣的同学可以去底层查看下源码:vendor/laravel/framework/src/Illuminate/Http/Concerns/InteractsWithInput.php。
发送 JSON 请求到应用的时候,只要 Content-Type 请求头被设置为 application/json,都可以通过 input 方法获取 JSON 数据,还可以通过“.”号解析数组:
// {"msg":"hi laravel", "user":{"name":"jojo", "age":89}}
$name = $request->input('user.name'); //$name为"jojo"
$user = $request->input('user'); //$user为["name"=>"jojo", "age"=>89]
$user = $request->user; //$user为["name"=>"jojo", "age"=>89]
当处理类似复选框这种 HTML 元素时,你可能期望传递的布尔值,但接收到的是永远为真的字符串类型值,例如,"true" 或者 "on"。为了方便,你可以使用 boolean 方法以布尔类型获取这些值,如果传入的值是 1、"1"、true、"true"、"on" 以及 "yes" 的话,boolean 方法统统返回 true,其他情况则都返回 false
$archived = $request->boolean('archived');
如果你需要取出输入数据的子集,可以使用 only 或 except 方法,这两个方法都接收一个数组或动态列表作为唯一参数,这和我们在上一篇控制器中提到的控制器中间件使用语法类似
// only 方法返回所有你想要获取的参数键值对,不过,如果你想要获取的参数不存在,则对应参数会被过滤掉。
$input = $request->only(['username', 'password']);
// 返回['username'=>'jojo','password'=>'123']
$input = $request->only('username', 'password','donotexist'); // 只会返回['username'=>'jojo','password'=>'123']
$input = $request->except(['credit_card']);
$input = $request->except('credit_card');
判断参数在请求中是否存在,可以使用 has 方法,如果参数存在则返回 true:
if ($request->has('name')) {
// 存在name do something
}
if ($request->has(['name', 'email'])) {
//都存在name和email do something
}
if ($request->hasAny(['name', 'email'])) {
// 有一个存在 name 或 email do something
}
如果你想要判断参数存在且参数值不为空,可以使用 filled 方法 要判断给定键在请求中不存在,可以使用 missing 方法:
if ($request->filled('name')) {
// 参数存在且参数值不为空
}
if ($request->missing('name')) {
// 给定键在请求中不存在
}
Illuminate\Http\Request 实例的 flash 方法会将当前输入存放到一次性 Session(所谓的一次性指的是从 Session 中取出数据后,对应数据会从 Session 中销毁)中,这样在下一次请求时上一次输入的数据依然有效,你还可以使用 flashOnly 和 flashExcept 方法将输入数据子集存放到 Session 中,这些方法在 Session 之外保存敏感信息时很有用,该功能适用于登录密码填写错误的场景,你经常需要一次性存储输入请求输入并返回到表单填写页,可以在 redirect 之后调用 withInput 方法实现这样的功能:
$request->flash();
$request->flashOnly('username', 'email');
$request->flashExcept('password');
return redirect('form')->withInput();
return redirect('form')->withInput($request->except('password'));
Session 中取出上次请求的输入数据,可以使用 Request 实例提供的 old 方法。old 方法可以很方便地从 Session 中取出一次性数据,Laravel 还提供了一个全局的辅助函数 old(),如果你是在 Blade 模板中显示上次输入数据,使用辅助函数 old() 更方便,如果给定参数没有对应输入,返回 null:
$username = $request->old('username');
<input type="text" name="username" value="{{ old('username') }}">
为了安全起见,Laravel 框架创建的所有 Cookie 都经过加密并使用一个认证码进行签名,这意味着如果客户端修改了它们则需要对其进行有效性验证。我们使用 Illuminate\Http\Request 实例的 cookie 方法从请求中获取 Cookie 的值,还可以使用 Cookie 门面获取 Cookie 值:
$value = $request->cookie('name');
$value = \Cookie::get('name');
你可以使用 cookie 方法将一个 Cookie 添加到返回的 Illuminate\Http\Response 实例,你需要传递 Cookie 名称、值、以及有效期(分钟)到这个方法:
return response('hello laravel')->cookie(
'name', 'laravel', $minutes, $path, $domain, $secure, $httpOnly
);
如果你想要生成一个 Symfony\Component\HttpFoundation\Cookie 实例以便后续添加到响应实例,可以使用全局辅助函数 cookie,该 Cookie 只有在添加到响应实例上才会发送到客户端,此外,你还可以使用 Cookie 门面将应用于附件的 Cookie 推送到输出响应队列。queue 方法接收一个 Cookie 实例或者创建一个 Cookie 实例的必要参数。这些 Cookie 会在响应发送到浏览器之前添加上:
$cookie = cookie('name', '学院君', $minutes);
return response('欢迎访问学院君网站')->cookie($cookie);
Cookie::queue(Cookie::make('name', 'value', $minutes));
Cookie::queue('name', 'value', $minutes);
你可以通过 Cookie 门面的 forget 方法移除 Cookie 让其过期,此外,还可以添加过期 Cookie 到响应实例
Cookie::queue(Cookie::forget('name'));
$cookie = Cookie::forget('name');
return response('Hello World')->withCookie($cookie);
可以使用 Illuminate\Http\Request 实例提供的 file 方法或者动态属性来访问上传文件, file 方法返回 Illuminate\Http\UploadedFile 类的一个实例,该类继承自 PHP 标准库中提供与文件交互方法的 SplFileInfo 类:
$file = $request->file('photo');
$file = $request->photo;
if ($request->hasFile('photo')) {
// 可以使用 hasFile 方法判断文件在请求中是否存在:
}
if ($request->file('photo')->isValid()){
// isValid 方法判断文件在上传过程中是否出错
}
/*
laravel 默认使用 local 配置存放上传文件,即本地文件系统,默认根目录是 storage/app,
//public 也是本地文件系统,只不过存放在这里的文件可以被公开访问,其对应的根目录是 storage/app/public,
//要让 Web 用户访问到该目录下存放文件的前提是在应用入口 public
//目录下建一个软链 storage 链接到 storage/app/public。
//UploadedFile 类有一个 store 方法,该方法会将上传文件移动到相应的磁盘路径上,
//该路径可以是本地文件系统的某个位置,也可以是云存储(如 Amazon S3)上的路径。
//store 方法接收一个文件保存的相对路径(相对于文件系统配置的根目录 ),该路径不需要包含文件名,
//因为系统会自动生成一个唯一 ID 作为文件名。
store 方法还接收一个可选的参数 —— 用于存储文件的磁盘名称作为第二个参数
//(对应文件系统配置 disks 的键名,默认值是 local),该方法会返回相对于根目录的文件路径
如果你不想自动生成文件名,可以使用 storeAs 方法,
//该方法接收保存路径、文件名和磁盘名作为参数
*/
$path = $request->photo->store('images');
$path = $request->photo->store('images', 's3');
$path = $request->photo->storeAs('images', 'filename.jpg');
$path = $request->photo->storeAs('images', 'filename.jpg', 's3');