前言
Laravel 5.5 也將會是接下來的一個 LTS(長期支持)版本。 這就意味著它擁有兩年修復以及三年的安全更新支持。Laravel 5.1 也是如此,不過它兩年的錯誤修復支持將在今年結束。
Laravel 5.5 的路由中增加了一種新的返回類型:可相應接口( Responsable )。該接口允許對象在從控制器或者閉包路由中返回時自動被轉化為標準的 HTTP 響應接口。任何實現 Responsable 接口的對象必須實現一個名為 toResponse()
的方法,該方法將對象轉化為 HTTP 響應對象。
看示例:
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 的時候,你可以這樣做:
Route::get('/hello', function() { return new ExampleObject(request('name')); });
在 Laravel 框架中, Route 類如今可以在準備響應內容時檢查這種(實現了 Responsable 接口的)類型:
if ($response instanceof Responsable) { $response = $response->toResponse(); }
假如你在 App\Http\Responses 命名空間下用多個響應類型來組織你的響應內容,可以參考下面這個示例。該示例演示了如何支持 Posts (多個實例組成的 Collection):
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 .
總結
以上就是這篇文章的全部內容了,希望本文的內容對大家的學習或者工作具有一定的參考學習價值,如果有疑問大家可以留言交流,謝謝大家對的支持。