Laravel 5 中文手册(六):请求 Requests

获取请求的实例

通过 Facade

Request 这个 facade 可以让我们得到绑定在容器里的当前这个请求。比如:

$name = Request::input('name');

注意,如果你在一个命名空间里,你需要在类文件的顶部使用 use Request; 这条声明来导入 Request 这个 facade 。

通过依赖注入

要通过依赖注入得到当前 HTTP 请求的实例,需要在你的控制器构造函数或者方法里 type-hint 类。当前请求的这个实例会被 Service Container 自动注入进来。

检索输入

检索输入的值

使用几个简单的方法,你可以得到在 Illuminate\Http\Request 实例上的用户的所有的输入。你不用管请求使用的 HTTP 动作是什么,可以使用同样的方法来得到所有的输入的值。

$name = Request::input('name');

在缺少输入值的时候去获取到默认值

$name = Request::input('name', 'Sally');

确定一个输入值是否出现

if (Request::has('name')){  //}

得到请求里的所有输入的值

$input = Request::all();

得到请求里的部分输入值

$input = Request::only('username', 'password');$input = Request::except('credit_card');

如果输入里面包含数组类型的值,可以使用点的形式访问到这个数组里的值:

$input = Request::input('products.0.name');

以前输入的值

Laravel 会存储在一次请求与下一次请求之间的输入值。比如,你可能需要在验证了输入错误之后重新填写表单。

把输入值闪存到会话里

flash 方法可以把当前的输入的值闪存(flash)到会话( session) 里。这样,在用户下一次对应用发出请求的时候可以用到这些输入值:

Request::flash();

把一部分输入值闪存到会话里

Request::flashOnly('username', 'email');Request::flashExcept('password');

闪存与重定向

你想闪存输入值并且用一个重定向(redirect)到前一个页面上,可以把输入闪存链到一个重定向上。

return redirect('form')->withInput();return redirect('form')->withInput(Request::except('password'));

得到以前的数据

得到前一个请求里的闪存的输入值,可以使用在 Request 实例上的 old 这个方法。

$username = Request::old('username');

如果你打算用 Blade 模板显示以前的输入值,可以使用 old 这个帮手:

{{ old('username') }}

Cookies

Laravel 框架创建的所有的 Cookies 都是加密的,并且会签上一个认证的代码,意思就是如果这些 Cookies 在客户端那里被修改过,就会被认为是无效的 Cookies。

检索 Cookie 值

$value = Request::cookie('name');

把一个新 Cookie 附加给一个响应

cookie 这个帮手的作用就是去生成新的 Symfony\Component\HttpFoundation\Cookie 实例。可以使用 withCookie 方法把Cookies 附加到 Response 实例上:

$response = new Illuminate\Http\Response('Hello World');$response->withCookie(cookie('name', 'value', $minutes));

创建永恒的 Cookie

永恒,我们的意思其实就是 5 年。

$response->withCookie(cookie()->forever('name', 'value'));

文件

检索一个上传了的文件

$file = Request::file('photo');

确定一个文件是不是被上传了

if (Request::hasFile('photo')){  //}

file 方法返回来的对象是 Symfony\Component\HttpFoundation\File\UploadedFile 类的一个实例,这个类继承了 PHP 的 SplFileInfo 类,提供了很多方法可以跟文件交互。

确定上传的文件是否有效

if (Request::file('photo')->isValid()){  //}

移动一个上传的文件

Request::file('photo')->move($destinationPath);Request::file('photo')->move($destinationPath, $fileName);

其它文件方法

在 UploadedFile 实例上还有一些其它的方法。具体可以看一下 Class API 的文档 。
其它的请求信息
Request 类为你的应用提供了很多方法可以检查 HTTP 请求,它继承了 Symfony\Component\HttpFoundation\Request 类。下面是几个亮点。
检索请求 URI

$uri = Request::path();

检索请求方法

$method = Request::method();if (Request::isMethod('post')){  //}

确定请求路径是否匹配一个模式

if (Request::is('admin/*')){  //}

得到当前请求的地址

$url = Request::url();

你可能感兴趣的:(Laravel 5 中文手册(六):请求 Requests)