1、创建响应
所有路由和控制器都会返回一个被发送到用户浏览器的响应,Laravel 提供了多种不同的方式来返回响应。
字符串 & 数组
最基本的响应就是从路由或控制器返回一个简单的字符串,框架会将这个字符串转化为一个完整的 HTTP 响应:
Route::get('/', function () {
return 'Hello World';
});
除了从路由或控制器返回字符串之外,还可以返回数组。框架会自动将数组转化为一个 JSON 响应:
Route::get('/', function () {
return [1, 2, 3];
});
Response对象
通常,我们并不只是从路由动作简单返回字符串和数组,大多数情况下,都会返回一个完整的 Illuminate\Http\Response
实例或视图。
返回一个完整的 Response
实例允许你自定义响应的 HTTP 状态码
和头信息
。Response
实例继承自 Symfony\Component\HttpFoundation\Response
类,该类提供了一系列方法用于创建 HTTP 响应:
Route::get('home', function () {
return response('Hello World', 200)
->header('Content-Type', 'text/plain');
});
添加响应头
大部分响应方法都是可以以方法链形式调用的,从而可以平滑地构建响应(流接口模式)。例如,在发送响应给用户前可以使用 header
方法来添加一系列响应头:
return response($content)
->header('Content-Type', $type)
->header('X-Header-One', 'Header Value')
->header('X-Header-Two', 'Header Value');
或者你可以使用 withHeaders
方法来指定头信息数组并添加到响应:
return response($content)
->withHeaders([
'Content-Type' => $type,
'X-Header-One' => 'Header Value',
'X-Header-Two' => 'Header Value',
]);
添加 Cookie 到响应
使用响应实例上的 cookie
方法可以轻松添加 Cookie
到响应。例如,你可以使用 cookie
方法生成 Cookie
并添加将其添加到响应实例:
return response($content)
->header('Content-Type', $type)
->cookie('name', 'value', $minutes);
cookie
方法还可以接收更多使用频率较低的额外可选参数,一般来说,这些参数和 PHP 原生提供的setcookie
方法目的和意义差不多:
->cookie($name, $value, $minutes, $path, $domain, $secure, $httpOnly)
Cookie & 加密
默认情况下,Laravel 框架生成的 Cookie
都经过了加密和签名,以免在客户端被篡改。如果你想要让特定的 Cookie 子集在生成时取消加密,可以使用 app/Http/Middleware
目录下的中间件 App\Http\Middleware\EncryptCookies
提供的 $except
属性来排除这些 Cookie
:
/**
* 不需要被加密的cookies名称
*
* @var array
*/
protected $except = [
'cookie_name',
];
2、重定向
重定向响应是 Illuminate\Http\RedirectResponse
类的实例,其中包含了必须的头信息将用户重定向到另一个 URL,有很多方式来生成 RedirectResponse
实例,最简单的方法就是使用全局辅助函数 redirect
:
Route::get('dashboard', function () {
return redirect('home/dashboard');
});
有时候你想要将用户重定向到上一个请求的位置,比如,表单提交后,验证不通过,你就可以使用辅助函数 back
返回到前一个 URL
(由于该功能使用了 Session,使用该方法之前确保路由使用了 web
中间件组或者都使用了 session
中间件):
Route::post('user/profile', function () {
// 验证请求...
return back()->withInput();
});
重定向到命名路由
如果调用不带参数的 redirect
方法,会返回一个 Illuminate\Routing\Redirector
实例,然后就可以调用 Redirector
实例上的所有方法。例如,要生成一个 RedirectResponse
到命名路由,可以使用 route
方法:
return redirect()->route('login');
如果路由中有参数,可以将其作为第二个参数传递到 route
方法:
// For a route with the following URI: profile/{id}
return redirect()->route('profile', ['id'=>1]);
通过Eloquent模型填充参数
如果要重定向到带 ID 参数的路由( Eloquent 模型绑定 ),可以传递模型本身,ID 会被自动解析出来:
return redirect()->route('profile', [$user]);
如果你想要自定义这个路由参数中的默认值(默认是id),需要重写模型实例上的 getRouteKey
方法:
/**
* 获取模型路由键的值
*
* @return mixed
*/
public function getRouteKey(){
return $this->slug;
}
重定向到控制器动作
你还可以生成重定向到控制器动作,只需简单传递控制器和动作名到 action
方法即可。记住,你不需要指定控制器的完整命名空间,因为 Laravel 的 RouteServiceProvider
将会自动设置默认的控制器命名空间:
return redirect()->action('HomeController@index');
当然,如果控制器路由要求参数,你可以将参数作为第二个参数传递给 action
方法:
return redirect()->action('UserController@profile', ['id'=>1]);
带一次性 Session 数据的重定向
重定向到一个新的 URL 并将数据存储到一次性 Session
中通常是同时完成的,为了方便,可以创建一个 RedirectResponse
实例然后在同一个方法链上将数据存储到 Session
,这种方式在 action
之后存储状态信息时特别方便:
Route::post('user/profile', function () {
// 更新用户属性...
return redirect('dashboard')->with('status', 'Profile updated!');
});
当然,用户重定向到新页面之后,你可以从 Session
中取出并显示这些一次性信息,例如,使用 Blade 语法
实现如下:
@if (session('status'))
<div class="alert alert-success">
{{ session('status') }}
</div>
@endif
3、其它响应类型
辅助函数 response
可以很方便地用来生成其他类型的响应实例,当无参数调用 response
时会返回 Illuminate\Contracts\Routing\ResponseFactory
契约的一个实现,该 契约 提供了一些有用的方法来生成响应。
视图响应
如果你需要控制响应状态和响应头,并且还需要返回一个视图作为响应内容,可以使用 view
方法:
return response()
->view('hello', $data, 200)
->header('Content-Type', $type);
当然,如果你不需要传递自定义的 HTTP 状态码和头信息,只需要简单使用全局辅助函数 view
即可。
JSON响应
json
方法会自动将 Content-Type
头设置为 application/json
,并使用 PHP 函数 json_encode
方法将给定数组转化为 JSON:
return response()->json([ 'name' => 'Abigail', 'state' => 'CA']);
如果你想要创建一个 JSONP
响应,可以在 json
方法之后调用 setCallback
方法:
return response()
->json(['name' => 'Abigail', 'state' => 'CA'])
->withCallback($request->input('callback'));
文件下载
download
方法用于生成强制用户浏览器下载给定路径文件的响应。download
方法接受文件名作为第二个参数,该参数决定用户下载文件的显示名称,你还可以将 HTTP
头信息作为第三个参数传递到该方法:
return response()->download($pathToFile);
return response()->download($pathToFile, $name, $headers);
注:管理文件下载的
Symfony HttpFoundation
类要求被下载文件有一个ASCII
文件名。
文件响应
file
方法可用于直接在用户浏览器显示文件,例如图片或PDF,而不需要下载,该方法接收文件路径作为第一个参数,头信息数组作为第二个参数:
return response()->file($pathToFile);
return response()->file($pathToFile, $headers);
4、响应宏
如果你想要定义一个自定义的可以在多个路由和控制器中复用的响应,可以使用 Response
门面上的 macro
方法。例如,在某个服务提供者的 boot
方法中编写代码如下:
<?php
namespace App\Providers;
use Illuminate\Support\Facades\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) {
return Response::make(strtoupper($value));
});
}
}
macro
方法接收响应名称作为第一个参数,闭包函数作为第二个参数,响应宏的闭包在 ResponseFactory
实现类或辅助函数 response
中调用宏名称的时候被执行:
return response()->caps('foo');