Laravel 如何实现自定义资源路由

最近在开发过程中，发现总有一些路由需要重复定义，比如切换状态，导出，回收站啊之类的。如果使用 Laravel 自带的资源路由方法，还不足以满足重复劳动得过程。所以是否有方法可以自定义项目得资源路由呢？在 Laravel 中，资源路由一般有两种

服务端渲染

Route::resource('xxxxx')

resource 路由包含以下几个方法

• index
• store
• create
• show
• edit
• upate
• destroy

Api 资源路由

Route::apiResource('xxxxx')

而 ApiResource 则是用 Resource 方法生成，仅仅保存了下面几个方法

$only = ['index', 'show', 'store', 'update', 'destroy'];

现在项目一般都采用前后端分离，所以一般都是使用 apiResource 这个方法，这个方法如上所示只提供五个方法，即五个路由。所以如果项目中需要一些特定得每次都加得路由，必须还要自己再添加一条，很不方便。那在 Laravel 中是不是可以自己扩展属于项目独有得 resource 方法呢？答案是当然可以，而且非常简单

如何实现

一般都是在项目中这样定义资源路由的, 通过门面 Route 访问 apiResource 方法进行定义，如下

Route::apiResource('hello', HelloController::class);

实际上通过门面调用的实际是 Illuminate\Routing\Router 的 apiResource 方法，内容如下

public function apiResource($name, $controller, array $options = [])
{
    $only = ['index', 'show', 'store', 'update', 'destroy'];

    if (isset($options['except'])) {
        $only = array_diff($only, (array) $options['except']);
    }

    // 实际调用的是 resource 方法
    return $this->resource($name, $controller, array_merge([
        'only' => $only,
    ], $options));
}

实际上 apiResource 是用 resource 方法包装的，所以再来看看 resource 方法做了啥

public function resource($name, $controller, array $options = [])
{
    // 这里是关键的地方
    if ($this->container && $this->container->bound(ResourceRegistrar::class)) {
        $registrar = $this->container->make(ResourceRegistrar::class);
    } else {
        $registrar = new ResourceRegistrar($this);
    }

    // 这一步不用关注
    return new PendingResourceRegistration(
        $registrar, $name, $controller, $options
    );
}

最关键的地方就是 ResourceRegistrar，这里就叫资源路由注册器吧。

• 首先查找容器中是否有资源路由注册器的绑定实现，如果有，直接从容器中 make 出来
• 如果容器中没有绑定，则直接使用 new 实例化

那就是说，如果自定义自己的资源路由注册器，然后再绑定 ResourceRegistrar 的实现，就可以实现让框架使用自定义的路由注册器了。

这解决了资源路由注册器的问题，还需要一个方法来调用，从上来得知

Route::apiResource('hello', HelloController::class);

实际上就是 Illuminate\Routing\Router 的 apiResource 方法。那么如何在 Illuminate\Routing\Router 添加自定义方法呢？没错，首先就要想到它支不支持
Macroable？