发布于 2015-08-08 12:56:22 | 281 次阅读 | 评论: 0 | 来源: 网络整理
最基本的响应就是从 Laravel 的路由返回字串:
Route::get('/', function()
{
return 'Hello World';
});
但是以大部分的路由及控制器所执行的动作来说,你需要返回完整的 IlluminateHttpResponse
实例或是一个视图。返回一个完整的 Response
实例时,你能够自定义响应的 HTTP 状态码以及响应头。Response
实例继承了 SymfonyComponentHttpFoundationResponse
类,它提供了很多方法来建立 HTTP 响应。
use IlluminateHttpResponse;
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);
return response($content)->withCookie(cookie('name', 'value'));
切记,大多数的 Response
方法都是可以链式调用的,用以建立流畅的响应:
return response()->view('hello')->header('Content-Type', $type)
->withCookie(cookie('name', 'value'));
重定向响应通常是类 IlluminateHttpRedirectResponse
的实例,并且包含用户要重定向至另一个 URL 所需的响应头。
有几种方法可以产生 RedirectResponse
的实例,最简单的方式就是透过辅助方法 redirect
。当在测试时,建立一个模拟重定向响应的测试并不常见,所以使用辅助方法通常是可行的:
return redirect('user/login');
通常重定向至新的 URL 时会一并将数据存进一次性 Session。所以为了方便,你可以利用方法连接的方式创建一个 RedirectResponse
的实例并将数据存进一次性 Session:
return redirect('user/login')->with('message', 'Login Failed');
你可能希望将用户重定向至前一个位置,例如当表单提交之后。你可以使用 back
方法来达成这个目的:
return redirect()->back();
return redirect()->back()->withInput();
当你调用辅助方法 redirect
且不带任何参数时,将会返回 IlluminateRoutingRedirector
的实例,你可以对该实例调用任何的方法。举个例子,要产生一个 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('AppHttpControllersHomeController@index');
提示: 如果你已经通过
URL::setRootControllerNamespace
注册了根控制器的命名空间,那么就不需要对action()
方法内的控制器指定完整的命名空间。
return redirect()->action('AppHttpControllersUserController@profile', [1]);
return redirect()->action('AppHttpControllersUserController@profile', ['user' => 1]);
使用辅助方法 response
可以轻松的产生其他类型的响应实例。当你调用辅助方法 response
且不带任何参数时,将会返回 IlluminateContractsRoutingResponseFactory
Contract 的实做。Contract 提供了一些有用的方法来产生响应。
json
方法会自动将响应头的 Content-Type
配置为 application/json
:
return response()->json(['name' => 'Abigail', 'state' => 'CA']);
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。
如果你想要自定义可以在很多路由和控制器重复使用的响应,你可以使用 IlluminateContractsRoutingResponseFactory
实做的方法 macro
。
举个例子,来自服务提供者的 boot
方法:
<?php namespace AppProviders;
use Response;
use IlluminateSupportServiceProvider;
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');