HTTP 响应

基本响应

所有的路由及控制器必须返回某个类型的响应,并发送回用户的浏览器。Laravel 提供了几种不同的方法来返回响应。最基本的响应就是从路由或控制器简单的返回一个字符串:

  1. Route::get('/', function () {
  2. return 'Hello World';
  3. });

指定的字符串会被框架自动转换成 HTTP 响应。

响应对象

但是对于大部分的路由及控制器所运行的动作来说,一般需要的是返回完整的 Illuminate\Http\Response 实例或是一个 视图

返回一个完整的 Response 实例时,就能够自定义响应的 HTTP 状态码以及标头。Response 实例继承了 Symfony\Component\HttpFoundation\Response 类,其提供了很多创建 HTTP 响应的方法:

  1. use Illuminate\Http\Response;
  2. Route::get('home', function () {
  3. return (new Response($content, $status))
  4. ->header('Content-Type', $value);
  5. });

为了方便起见,你可以使用辅助函数 response

  1. Route::get('home', function () {
  2. return response($content, $status)
  3. ->header('Content-Type', $value);
  4. });

注意:有关 Response 方法的完整列表可以参照 API 文档 以及 Symfony API 文档

附加标头至响应

大部份的响应方法是可链式调用的,这让你可以顺畅的创建响应。举例来说,你可以在响应发送给用户之前,使用 header 方法增加一系列的标头至响应:

  1. return response($content)
  2. ->header('Content-Type', $type)
  3. ->header('X-Header-One', 'Header Value')
  4. ->header('X-Header-Two', 'Header Value');

或者你可以使用 withHeaders 来设置数组标头:

  1. return response($content)
  2. ->withHeaders([
  3. 'Content-Type' => $type,
  4. 'X-Header-One' => 'Header Value',
  5. 'X-Header-Two' => 'Header Value',
  6. ]);

附加 Cookies 至响应

通过响应实例的 cookie 辅助方法可以让你轻松的附加 cookies 至响应。举个例子,你可以使用 cookie 方法来生成 cookie 并附加至响应实例:

  1. return response($content)
  2. ->header('Content-Type', $type)
  3. ->cookie('name', 'value');

cookie 方法可以接受额外的可选参数,让你进一步自定义 cookies 的属性:

  1. ->cookie($name, $value, $minutes, $path, $domain, $secure, $httpOnly)

你可以可以使用 Cookie facadequeue 方法来创建 cookie:

  1. <?php
  2. namespace App\Http\Controllers;
  3. use Cookie;
  4. use App\Http\Controllers\Controller;
  5. class DashboardController extends Controller
  6. {
  7. /**
  8. * Show the application dashboard.
  9. *
  10. * @return Response
  11. */
  12. public function index()
  13. {
  14. Cookie::queue('saw_dashboard', true, 15);
  15. return view('dashboard');
  16. }
  17. }

在此例子中,saw_dashboard cookie 会自动添加到返回实例中。

默认情况下,所有 Laravel 生成的 cookies 都会被加密并加上认证标识,因此无法被用户读取及修改。如果你想停止对某个 cookies 的加密,则可以利用 App\Http\Middleware\EncryptCookies 中间件的 $except 属性:

  1. /**
  2. * 无需被加密的 cookies 名称。
  3. *
  4. * @var array
  5. */
  6. protected $except = [
  7. 'cookie_name',
  8. ];

其它响应类型

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

视图响应

如果你想要控制响应状态码及标头,同时也想要返回一个 视图 作为返回的内容时,则可以使用 view 方法:

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

当然,如果你没有自定义 HTTP 状态码及标头的需求,则可以简单的使用全局的 view 辅助函数。

JSON 响应

json 方法会自动将标头的 Content-Type 设置为 application/json,并通过 PHP 的 json_encode 函数将指定的数组转换为 JSON:

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

如果你想创建一个 JSONP 响应,则可以使用 json 方法并加上 setCallback

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

文件下载

download 方法可以用于生成强制让用户的浏览器下载指定路径文件的响应。download 方法接受文件名称作为方法的第二个参数,此名称为用户下载文件时看见的文件名称。最后,你可以传递一个 HTTP 标头的数组作为第三个参数传入该方法:

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

注意:管理文件下载的扩展包 Symfony HttpFoundation,要求下载文件必须是 ASCII 文件名。

文件响应

file 方法可以被用来显示一个文件,例如图片或者 PDF,直接在用户的浏览器中显示,而不是下载。这个方法的第一个参数是文件的路径,第二个参数是表头数组:

  1. return response()->file($pathToFile);
  2. return response()->file($pathToFile, $headers);

重定向

重定向响应是类 Illuminate\Http\RedirectResponse 的实例,并且包含用户要重定向至另一个 URL 所需的标头。有几种方法可以生成 RedirectResponse 的实例。最简单的方式就是通过全局的 redirect 辅助函数:

  1. Route::get('dashboard', function () {
  2. return redirect('home/dashboard');
  3. });

有时你可能希望将用户重定向至前一个位置,例如当提交一个无效的表单之后。这时可以使用全局的 back 辅助函数来达成这个目的:

  1. Route::post('user/profile', function () {
  2. // 验证该请求...
  3. return back()->withInput();
  4. });

重定向至命名路由

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

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

如果你的路由有参数,则可以将参数放进 route 方法的第二个参数:

  1. // 重定向到以下 URI: profile/{id}
  2. return redirect()->route('profile', ['id' => 1]);

如果你要重定向至路由且路由的参数为 Eloquent 模型的「ID」,则可以直接将模型传入,ID 将会自动被提取:

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

重定向至控制器行为

你可能会希望生成重定向至 控制器的行为。要做到这一点,只需传递控制器及行为名称至 action 方法。请记得,你不需要指定完整的命名空间,因为 Laravel 的 RouteServiceProvider 会自动设置默认的控制器命名空间:

  1. return redirect()->action('HomeController@index');

当然,如果你的控制器路由需要参数的话,你可以传递它们至 action 方法的第二个参数:

  1. return redirect()->action('UserController@profile', ['id' => 1]);

重定向并加上 Session 闪存数据

通常重定向至新的 URL 时会一并 写入闪存数据至 session。所以为了方便,你可以利用链式调用的方式创建一个 RedirectResponse 的实例 闪存数据至 Session。这对于在一个动作之后保存状态消息相当方便:

  1. Route::post('user/profile', function () {
  2. // 更新用户的个人数据...
  3. return redirect('dashboard')->with('status', 'Profile updated!');
  4. });

当然,在用户重定向至新的页面后,你可以获取并显示 session 的闪存数据。举个例子,使用 Blade 的语法

  1. @if (session('status'))
  2. <div class="alert alert-success">
  3. {{ session('status') }}
  4. </div>
  5. @endif

响应宏

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

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

  1. <?php
  2. namespace App\Providers;
  3. use Illuminate\Support\ServiceProvider;
  4. use Illuminate\Contracts\Routing\ResponseFactory;
  5. class ResponseMacroServiceProvider extends ServiceProvider
  6. {
  7. /**
  8. * 提供注册后运行的服务。
  9. *
  10. * @param ResponseFactory $factory
  11. * @return void
  12. */
  13. public function boot(ResponseFactory $factory)
  14. {
  15. $factory->macro('caps', function ($value) use ($factory) {
  16. return $factory->make(strtoupper($value));
  17. });
  18. }
  19. }

macro 函数第一个参数为宏名称,第二个参数为闭包函数。宏的闭包函数会在 ResponseFactory 的实现或者辅助函数 response 调用宏名称的时候被运行:

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

{note} 欢迎任何形式的转载,但请务必注明出处,尊重他人劳动共创开源社区。

转载请注明:本文档由 Laravel China 社区 [laravel-china.org] 组织翻译。

文档永久地址: http://d.laravel-china.org