接收请求
要通过依赖注入获取当前 HTTP 请求实例,你应该在控制器上引入Illuminate\Http\Request
类。传入的请求实例将会由 服务容器 自动注入:
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
class UserController extends Controller
{
/**
* 存储一个新用户
*
* @param Request $request
* @return Response
*/
public function store(Request $request)
{
$name = $request->input('name');
//
}
}
依赖注入 & 路由参数
如果你的控制器需要从路由参数中获取数据,你应该在其他依赖项之后列入参数。举个例子,你的路由是这样定义的:
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 string $id
* @return Response
*/
public function update(Request $request, $id)
{
//
}
}
通过闭包路由获取参数
你也可以在路由闭包中使用 Illuminate\Http\Request
类, 服务容器会自动的将请求参数注入到路由闭包中:
use Illuminate\Http\Request;
Route::get('/', function (Request $request) {
//
});
请求路径 & 方法
Illuminate\Http\Request
提供了各种方法来检查应用程序的 http 请求,并扩展了 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 请求, 那么你首先需要安装几个库。Laravel 使用 Symfony HTTP Message Bridge 组件将典型的 Laravel 请求和响应转换为 PSR-7 的兼容实现:
composer require symfony/psr-http-message-bridge
composer require nyholm/psr7
安装这些库后,可以通过路由闭包和控制器方法的请求接口类型提示来获取 PSR-7 请求:
use Psr\Http\Message\ServerRequestInterface;
Route::get('/', function (ServerRequestInterface $request) {
//
});
技巧:如果从路由或控制器返回 PSR-7 响应实例,框架将会自动将其转换为 Laravel 的响应实例并显示。
输入过滤 & 规范化
默认情况下,Laravel 应用程序的全局中间件堆栈中包含了 TrimStrings
和 ConvertEmptyStringsToNull
中间件。 它们被放在 App\Http\Kernel
类的栈列表中。这些中间件将自动过滤掉请求中的字符串字段,并将空字符串字段转换为 null
。 这样一来,你将不用担心路由和控制器的约束规范问题。
如果你想禁用这些行为, 你可以在应用程序中 App\Http\Kernel
类的 $middleware
属性中移除这两个中间件。
获取输入
获取所有输入数据
你可以使用 all
方法来获取 array
类型的全部输入数据:
$input = $request->all();
获取其中一个输入数据
使用一些简单的方法,你可以从 Illuminate\Http\Request
获取所有的用户输入数据,而不用在意用户使用的是哪种 HTTP 动词。不管是什么 HTTP 动词, input
方法都可以用来获取用户的输入数据:
$name = $request->input('name');
你可以在 input
方法第二个参数传入一个默认值。这个值将会在当前请求不包含所需要的字段时返回:
$name = $request->input('name', 'Sally');
当处理包含数组的表单时,可以使用 「.」 运算符来访问数组的数据:
$name = $request->input('products.0.name');
$names = $request->input('products.*.name');
从查询字符串获取输入
input
方法可以从整个请求体中获取数据(包括查询字符串), 而 query
方法仅仅从查询字符串中获取输入值:
$name = $request->query('name');
如果请求中所需要的查询字符串字段不存在,第二个参数将会被返回:
$name = $request->query('name', 'Helen');
你也可以使用无参数的 query
方法来获取全部查询条件的关联数组:
$query = $request->query();
通过动态属性获取输入
你也可以通过 Illuminate\Http\Request
接口实例的动态属性访问用户的输入。例如你的一个表单中包含 name
字段,则可以通过下面这种方式获取:
$name = $request->name;
获取 JSON 输入
当向应用传递 JSON 请求时,只要将请求头中的 Content-Type
设置为 application/json
后你便可以使用 input
方法来获取 JSON 数据。你也可以使用「.」语法获取 JSON 数组内容:
$name = $request->input('user.name');
获取输入的布尔值
当处理诸如 checkbox 类的 HTML 元素时,你的应用可能获取到以字符串形式传递的 “真假值”,例如 “true” 或者 “on”。为了方便,你可以使用 bool 方法来将这些值转换布尔类型。boolean
方法将会把 1
、"1"
、true
、"true"
、"on"
和 "yes"
返回为 true
。而其他值将会返回 false
:
$archived = $request->boolean('archived');
获取部分输入数据
如果需要获取输入数据的子集,你可以使用 only
或 except
方法。它们接受单个 array
或者动态参数列表:
$input = $request->only(['username', 'password']);
$input = $request->only('username', 'password');
$input = $request->except(['credit_card']);
$input = $request->except('credit_card');
技巧:
only
方法返回请求中的全部键值对;但是它不返回请求中不存在的键值对。
判断输入值是否存在
你可以使用 has
来判断当前请求中是否含有指定的值。如果请求中存在该值则 has
方法将会返回 true
:
if ($request->has('name')) {
//
}
当给定一个数组时,has
将会判断指定的值是否全部存在:
if ($request->has(['name', 'email'])) {
//
}
hasAny
方法将会在指定的值有一个存在的情况下返回 true
:
if ($request->hasAny(['name', 'email'])) {
//
}
如果你想要判断一个值在请求中是否存在,并且不为空,可以使用 filled
方法:
if ($request->filled('name')) {
//
}
如果你想要判断一个值在请求中是否缺失,可以使用 missing
方法:
if ($request->missing('name')) {
//
}
旧数据
Laravel 允许你在两次请求之间保持数据。这个特性在有效性校验出错后重新填充表单时非常有用。不过,如果你使用 Laravel 自带的 特性验证, 不需要自己手动调用这些方法,因为一些 Laravel 内置的验证功能会自动调用它们。
将输入数据闪存到 Session
Illuminate\Http\Request
类的 flash
方法可以把当前的输入闪存到 session,因此在用户向应用发起的下一次请求时它们仍然可用:
$request->flash();
你也可以使用 flashOnly
方法和 flashExcept
方法将请求数据的子集传送给 session。这些方法在将密码之类的敏感数据排除在 session 外的情况下挺实用的:
$request->flashOnly(['username', 'email']);
$request->flashExcept('password');
闪存数据并跳转
如果你需要经常保存输入到 session 然后重定向到之前的页面,可以通过在跳转函数后链式调用 withInput
方法轻易地实现:
return redirect('form')->withInput();
return redirect('form')->withInput(
$request->except('password')
);
获取旧数据
若要获取上一次请求所保存的旧数据,可以在 Request
的实例上使用 old
方法。old
方法会从 session 取出之前被闪存的输入数据:
$username = $request->old('username');
Laravel 也提供了全局辅助函数 old
。如果你要在 Blade 模板 中显示旧的输入,使用 old
辅助函数将会更加方便。如果给定字段没有旧的输入,则会返回 null
:
<input type="text" name="username" value="{{ old('username') }}">
Cookies
从请求中获取 Requests
所有从 Laravel 框架创建的 cookies 都是加密的,并且使用授权码进行签名,这意味着如果它们被客户端改变就会失效。若要从请求汇总获取 cookie,在 Illuminate\Http\Request
实例使用 cookie
方法即可:
$value = $request->cookie('name');
或者,你也可以使用 Cookie
门面来访问 cookie 值:
use Illuminate\Support\Facades\Cookie;
$value = Cookie::get('name');
将 Cookie 附加到响应中
你可以将一个 cookie 通过 cookie 方法附加到传出的 Illuminate\Http\Response
实例。你需要传入名称、值、cookie
的过期时间(以分钟为单位)给该方法:
return response('Hello World')->cookie(
'name', 'value', $minutes
);
cookie
同样也接受一些不太频繁使用的参数。通常而言,这些参数和 PHP 内置的 setcookie 方法有着相同的作用和意义:
return response('Hello World')->cookie(
'name', 'value', $minutes, $path, $domain, $secure, $httpOnly
);
或者,你可以使用 Cookie
门面来 “排列” 用于从应用中附加到传出响应的 cookies。queue
方法接受一个 Cookie
实例或者用于创建 Cookie
实例的参数。这些 cookies 将会在发送到浏览器之前被附加到传出响应:
Cookie::queue(Cookie::make('name', 'value', $minutes));
Cookie::queue('name', 'value', $minutes);
生成 Cookie 实例
如果你想要在生成一个将会被附加到响应实例的 Symfony\Component\HttpFoundation\Cookie
实例,你可以使用全局辅助函数 cookie
。 除非这个 cookie 被附加到响应实例,否则不会发送回客户:
$cookie = cookie('name', 'value', $minutes);
return response('Hello World')->cookie($cookie);
提前终止 Cookies
你可以通过 Cookie
门面的 forget
函数来使一个 cookie 过期而删除它:
Cookie::queue(Cookie::forget('name'));
或者,你可以把过期的 cookie 附加到一个响应实例上:
$cookie = Cookie::forget('name');
return response('Hello World')->withCookie($cookie);
文件
获取上传的文件
你可以使用 file
方法或使用动态属性从 Illuminate\Http\Request
实例中访问上传的文件。 该 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');
配置可信代理
如果你的应用程序运行在失效的 TLS / SSL 证书的负载均衡器后,你可能会注意到你的应用程序有时不能生成 HTTPS 链接。通常这是因为你的应用程序正在从端口 80 上的负载均衡器转发流量,却不知道是否应该生成安全链接。
解决这个问题需要在 Laravel 应用程序中包含 App\Http\Middleware\TrustProxies
中间件,这使得你可以快速自定义应用程序信任的负载均衡器或代理。你的可信代理应该作为这个中间件的 $proxies
属性的数组列出。除了配置受信任的代理之外,还可以配置应该信任的代理 $header
:
<?php
namespace App\Http\Middleware;
use Fideloper\Proxy\TrustProxies as Middleware;
use Illuminate\Http\Request;
class TrustProxies extends Middleware
{
/**
* 此应用的信任代理
*
* @var string|array
*/
protected $proxies = [
'192.168.1.1',
'192.168.1.2',
];
/**
* 应被用于侦测代理的headers配置
*
* @var int
*/
protected $headers = Request::HEADER_X_FORWARDED_ALL;
}
技巧:如果你使用 AWS 弹性负载平衡,你的
$header
值应该是Request::HEADER_X_FORWARDED_AWS_ELB
。如果您想查看更多可用于 $headers 的属性信息,请查阅 Symfony 的文档 信任代理。
信任所有代理
如果你使用 Amazon AWS 或其他的「云」的负载均衡服务,你可能不知道负载均衡器的实际 IP 地址。在这种情况下,你可以使用 *
来信任所有代理:
/**
* 此应用的信任代理
*
* @var string|array
*/
protected $proxies = '*';
猜你喜欢: