HTTP 响应 - Laravel 5.0 基本功能 - [ Laravel 5.0 ]

基本响应

从路由返回字串

最基本的响应就是从 Laravel 的路由返回字串：

Route::get('/', function()
{
    return 'Hello World';
});

建立自定义响应

但是以大部分的路由及控制器所执行的动作来说，你需要返回完整的 Illuminate\Http\Response 实例或是一个视图。返回一个完整的 Response 实例时，你能够自定义响应的 HTTP 状态码以及响应头。Response 实例继承了 Symfony\Component\HttpFoundation\Response 类，它提供了很多方法来建立 HTTP 响应。

use Illuminate\Http\Response;

return (new Response($content, $status))
              ->header('Content-Type', $value);

为了方便起见，你可以使用辅助方法 response：

return response($content, $status)
              ->header('Content-Type', $value);

提示： 有关 Response 方法的完整列表可以参照 API 文档以及 Symfony API 文档.

在响应送出视图

如果想要使用 Response 类的方法，但最终返回视图给用户，你可以使用简便的 view 方法：

return response()->view('hello')->header('Content-Type', $type);

附加 Cookies 到响应

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

链式方法

切记，大多数的 Response 方法都是可以链式调用的，用以建立流畅的响应：

return response()->view('hello')->header('Content-Type', $type)
                 ->withCookie(cookie('name', 'value'));

重定向

重定向响应通常是类 Illuminate\Http\RedirectResponse 的实例，并且包含用户要重定向至另一个 URL 所需的响应头。

返回重定向

有几种方法可以产生 RedirectResponse 的实例，最简单的方式就是透过辅助方法 redirect。当在测试时，建立一个模拟重定向响应的测试并不常见，所以使用辅助方法通常是可行的：

return redirect('user/login');

返回重定向并且加上快闪数据（ Flash Data ）

通常重定向至新的 URL 时会一并将数据存进一次性 Session。所以为了方便，你可以利用方法连接的方式创建一个 RedirectResponse 的实例并将数据存进一次性 Session：

return redirect('user/login')->with('message', 'Login Failed');

返回根据前一个 URL 的重定向

你可能希望将用户重定向至前一个位置，例如当表单提交之后。你可以使用 back 方法来达成这个目的：

return redirect()->back();

return redirect()->back()->withInput();

返回根据路由名称的重定向

当你调用辅助方法 redirect 且不带任何参数时，将会返回 Illuminate\Routing\Redirector 的实例，你可以对该实例调用任何的方法。举个例子，要产生一个 RedirectResponse 到一个路由名称，你可以使用 route 方法：

return redirect()->route('login');

返回根据路由名称的重定向，并给予路由参数赋值

如果你的路由有参数，你可以放进 route 方法的第二个参数。

// 路由的 URI 为：profile/{id}

return redirect()->route('profile', [1]);

如果你要重定向至路由且路由的参数为 Eloquent 模型的“ID”，你可以直接将模型传入，ID 将会自动被提取：

return redirect()->route('profile', [$user]);

返回根据路由名称的重定向，并给予特定名称路由参数赋值

// 路由的 URI 为：profile/{user}

return redirect()->route('profile', ['user' => 1]);

返回根据控制器动作的重定向

既然可以产生 RedirectResponse 的实例并重定向至路由名称，同样的也可以重定向至控制器动作：

return redirect()->action('App\Http\Controllers\HomeController@index');

提示： 如果你已经通过 URL::setRootControllerNamespace 注册了根控制器的命名空间，那么就不需要对 action() 方法内的控制器指定完整的命名空间。

返回根据控制器动作的重定向，并给予参数赋值

return redirect()->action('App\Http\Controllers\UserController@profile', [1]);

返回根据控制器动作的重定向，并给予特定名称参数赋值

return redirect()->action('App\Http\Controllers\UserController@profile', ['user' => 1]);

其他响应

使用辅助方法 response 可以轻松的产生其他类型的响应实例。当你调用辅助方法 response 且不带任何参数时，将会返回 Illuminate\Contracts\Routing\ResponseFactory Contract 的实做。Contract 提供了一些有用的方法来产生响应。

建立 JSON 响应

json 方法会自动将响应头的 Content-Type 配置为 application/json：

return response()->json(['name' => 'Abigail', 'state' => 'CA']);

建立 JSONP 响应

return response()->json(['name' => 'Abigail', 'state' => 'CA'])
                 ->setCallback($request->input('callback'));

建立文件下载的响应

return response()->download($pathToFile);

return response()->download($pathToFile, $name, $headers);

return response()->download($pathToFile)->deleteFileAfterSend(true);

**提醒：**管理文件下载的扩展包，Symfony HttpFoundation，要求下载文件名必须为 ASCII。

响应宏

如果你想要自定义可以在很多路由和控制器重复使用的响应，你可以使用 Illuminate\Contracts\Routing\ResponseFactory 实做的方法 macro。

举个例子，来自服务提供者的 boot 方法:

<?php namespace App\Providers;

use Response;
use Illuminate\Support\ServiceProvider;

class ResponseMacroServiceProvider extends ServiceProvider {

    /**
     * Perform post-registration booting of services.
     *
     * @return void
     */
    public function boot()
    {
        Response::macro('caps', function($value) use ($response)
        {
            return $response->make(strtoupper($value));
        });
    }

}

macro 函数第一个参数为宏名称，第二个参数为闭包函数。闭包函数会在 ResponseFactory的实做或者辅助方法 response 调用宏名称的时候被执行：

return response()->caps('foo');