Laravel 5 中文手册（六）：请求 Requests

获取请求的实例

通过 Facade

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

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

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

通过依赖注入

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

<?php namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Routing\Controller;

class UserController extends Controller {

    /**
     * 保存新的用户
     *
     * @param  Request  $request
     * @return Response
     */
    public function store(Request $request)
    {
        $name = $request->input('name');

        //
    }

}

如果你的控制器方法期待来自路由参数上的 input（值），可以在其它的依赖的后面列出这些路由参数：

<?php namespace App\Http\Controllers;

use Illuminate\Http\Request;
use Illuminate\Routing\Controller;

class UserController extends Controller {

    /**
     * Store a new user.
     *
     * @param  Request  $request
     * @param  int  $id
     * @return Response
     */
    public function update(Request $request, $id)
    {
        //
    }

}

检索输入

检索输入的值

使用几个简单的方法，你可以得到在 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();