前言
Laravel 5.5 也将会是接下来的一个 LTS(长期支持)版本。 这就意味着它拥有两年修复以及三年的安全更新支持。Laravel 5.1 也是如此,不过它两年的错误修复支持将在今年结束。
Laravel 5.5 的路由中增加了一种新的返回类型:可相应接口( Responsable )。该接口允许对象在从控制器或者闭包路由中返回时自动被转化为标准的 HTTP 响应接口。任何实现 Responsable 接口的对象必须实现一个名为 toResponse()
的方法,该方法将对象转化为 HTTP 响应对象。
看示例:
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
|
use Illuminate\Contracts\Support\Responsable;
class ExampleObject implements Responsable
{
public function __construct( $name = null)
{
$this ->name = $name ?? 'Teapot' ;
}
public function status()
{
switch ( strtolower ( $this ->name)) {
case 'teapot' :
return 418;
default :
return 200;
}
}
public function toResponse()
{
return response(
"Hello {$this->name}" ,
$this ->status(),
[ 'X-Person' => $this ->name]
);
}
}
|
在路由中使用这个 ExampleObject 的时候,你可以这样做:
1
2
3
|
Route::get( '/hello' , function () {
return new ExampleObject(request( 'name' ));
});
|
在 Laravel 框架中, Route 类如今可以在准备响应内容时检查这种(实现了 Responsable 接口的)类型:
1
2
3
|
if ( $response instanceof Responsable) {
$response = $response ->toResponse();
}
|
假如你在 App\Http\Responses 命名空间下用多个响应类型来组织你的响应内容,可以参考下面这个示例。该示例演示了如何支持 Posts (多个实例组成的 Collection):
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
|
posts = $posts ;
}
public function toResponse()
{
return response()->json( $this ->transformPosts());
}
protected function transformPosts()
{
return $this ->posts->map( function ( $post ) {
return [
'title' => $post ->title,
'description' => $post ->description,
'body' => $post ->body,
'published_date' => $post ->published_at->toIso8601String(),
'created' => $post ->created_at->toIso8601String(),
];
});
}
}
|
以上只是一个模拟简单应用场景的基础示例:返回一个 JSON 响应,但你希望响应层不是简单地用内置实现把对象 JSON 化,而是要做一些内容处理。以上示例同时假设 App\Http\Responses\Response 这个类能提供一些基础的功能。当然响应层也可以包含一些转换代码(类似 Fractal ),而不是直接在控制器里做这样的转换。
与上面示例中的 PostIndexResponse 类协作的控制器代码类似以下这样:
如果你想了解更多有关这个接口的细节,可以查看项目中 相关代码的 commit .
总结
以上就是这篇文章的全部内容了,希望本文的内容对大家的学习或者工作具有一定的参考学习价值,如果有疑问大家可以留言交流,谢谢大家对服务器之家的支持。
原文链接:https://ofcss.com/2017/10/31/laravel-55-responsable-interface-for-responses.html