Laravel 5.5 为响应请求提供的可响应接口

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):

namespace App\Http\Responses;

class PostIndexResponse extends Response
{
    public function __construct($posts)
    {
        $this->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 类协作的控制器代码类似以下这样:

namespace App\Http\Controllers;

use App\Http\Responses;

class PostsController extends Controller
{
    public function index()
    {
        $posts = \App\Post::all();

        return new Responses\PostIndexResponse($posts);
    }
}

如果你想了解更多有关这个接口的细节,可以查看项目中相关代码的 commit.