Laravel 11手动配置多语言时可选路由参数失效问题

问题根源 #

你的两个路由传递的参数数量不一致：

• 不带locale的路由/products/{slug}仅传递1个参数（slug）
• 带locale的路由/{locale?}/products/{slug}传递2个参数（locale和slug）

而PHP函数要求带默认值的参数必须放在无默认值参数之后，你把带默认值的$locale放在了$slug前面，导致访问单参数路由时，传入的slug会被赋值给$locale，$slug参数缺失，触发"参数不足"错误——哪怕$locale设了默认值也没用，因为此时已经传入了一个参数，默认值不会生效。

可行解决方案 #

方案一：通过请求对象获取locale（推荐） #

修改控制器方法，只接收slug参数，通过请求对象获取路由中的locale参数，没有则使用应用默认locale：

public function fetchProduct($slug) {
    $locale = request()->route('locale') ?? app()->getLocale();
    dd($slug, $locale);
}

这种方式无需修改路由，兼容两种路由的参数传递逻辑，代码更简洁。

方案二：给单参数路由添加默认locale参数 #

修改第一个路由的定义，为其添加默认的locale参数，让它和带locale的路由传递相同数量的参数：

Route::group(['middleware' => ['setLocale']], function () {
    Route::get('/products/{slug}', [ProductController::class, 'fetchProduct'])
        // 设置locale参数默认值为当前应用的默认语言
        ->defaults('locale', app()->getLocale());
});

这样修改后，你的原控制器方法fetchProduct($locale = null, $slug)就能正常工作，因为两个路由都会传递两个参数（第一个路由的locale用默认值，第二个路由用URL中的值）。

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