如何在Laravel中实现类似Lumen的路由参数忽略功能？

问题场景 #

此前使用Lumen框架时，存在一项便捷特性：路由中定义的参数可在控制器方法中选择性忽略，框架会自动根据参数名匹配传递所需参数。但Laravel默认不支持该功能，示例如下：

// 路由定义
Route::get('{category_id}/system/batches/{batch_id}', 'CirculyDb\Settings\BatchSettingController@show');

// 控制器方法（可忽略category_id，仅接收batch_id）
public function show($batch_id): JsonResponse
{
    // 业务逻辑
}

实现方案 #

方案一：路由闭包手动传递参数 #

这是最直接的实现方式，通过路由闭包接收所有路由参数，仅将控制器方法需要的参数传递过去：

Route::get('{category_id}/system/batches/{batch_id}', function ($category_id, $batch_id) {
    // 实例化控制器并调用方法，仅传入所需的batch_id
    return app(\CirculyDb\Settings\BatchSettingController::class)->show($batch_id);
});

方案二：自定义路由宏实现自动参数匹配 #

如果需要全局复用该特性，可以通过自定义路由宏，让Laravel路由自动按参数名匹配控制器方法的参数，忽略未声明的参数：

1. 在RouteServiceProvider中注册路由宏
   在app/Providers/RouteServiceProvider.php的boot方法中添加以下代码：

use Illuminate\Routing\Route;

public function boot()
{
    parent::boot();

    Route::macro('resolveWithNamedParams', function () {
        /** @var Route $this */
        $action = $this->getAction();
        if (!isset($action['controller'])) {
            return;
        }

        list($controller, $method) = explode('@', $action['controller']);
        $controllerInstance = $this->container->make($controller);

        $this->setAction(function (...$routeParams) use ($controllerInstance, $method) {
            // 构建路由参数名与值的映射
            $paramMap = array_combine($this->parameterNames(), $routeParams);
            
            // 通过反射获取控制器方法的参数列表
            $reflectionMethod = new \ReflectionMethod($controllerInstance, $method);
            $methodParams = $reflectionMethod->getParameters();
            
            $resolvedParams = [];
            foreach ($methodParams as $param) {
                $paramName = $param->getName();
                if (isset($paramMap[$paramName])) {
                    $resolvedParams[] = $paramMap[$paramName];
                } elseif ($param->isDefaultValueAvailable()) {
                    $resolvedParams[] = $param->getDefaultValue();
                } else {
                    throw new \RuntimeException("参数 {$paramName} 在方法 {$method} 中是必填项，但未从路由中获取到");
                }
            }

            return $controllerInstance->{$method}(...$resolvedParams);
        });
    });
}

2. 在路由定义中使用该宏
   定义路由时，调用resolveWithNamedParams宏即可自动匹配参数：

Route::get('{category_id}/system/batches/{batch_id}', 'CirculyDb\Settings\BatchSettingController@show')
    ->resolveWithNamedParams();

这样控制器方法就可以只声明需要的参数，无需按路由参数顺序接收，未声明的路由参数会被自动忽略。

内容的提问来源于stack exchange，提问作者Marcos DaSilva