Laravel可选路由参数问题：省略参数时api被注入控制器方法

你遇到的问题根源在于Laravel的路由解析逻辑：当可选参数{config?}不在路由的最后一段时，省略该参数会导致框架误把前面的api片段当作可选参数的值传入方法。

下面是两种靠谱的解决方法：

方法1：拆分路由定义 #

直接定义两个独立路由，分别处理带参数和不带参数的请求：

public function boot(){
    $router = $this->app['router'];
    // 处理不带config参数的请求
    $router->get('captcha/api','\Hpd\Captcha\CaptchaController@getCaptchaApi')->middleware('web');
    // 处理带config参数的请求
    $router->get('captcha/api/{config}','\Hpd\Captcha\CaptchaController@getCaptchaApi')->middleware('web');
}

这种方式让路由规则更清晰，框架能准确匹配两种请求场景，不会出现参数错位。

方法2：调整路由结构，将可选参数移到末尾 #

如果允许修改路由的URL格式，把可选参数放到路由的最后一段：

public function boot(){
    $router = $this->app['router'];
    $router->get('captcha/api/{config?}','\Hpd\Captcha\CaptchaController@getCaptchaApi')->middleware('web');
    // 改为下面的结构
    $router->get('captcha/{config?}/api','\Hpd\Captcha\CaptchaController@getCaptchaApi')->middleware('web');
}

注意这种方法需要同步修改前端的请求地址，适合还未大规模使用该路由的场景。

另外还有个临时兼容方案（不推荐作为长期解决办法）：在控制器方法里做参数校验，若传入的参数是api则手动重置为默认值：

public function getCaptchaApi($config = null)
{
    if ($config === 'api') {
        $config = null;
    }
    // 后续业务逻辑...
}

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