Laravel路由多参数调用问题：如何为storageImg路由支持自定义dir参数

API 探路者

2026-10-3

解决方案

你可以根据是否需要兼容旧链接选择以下两种方案：

方案1：将`dir`设为路由可选路径参数（推荐，URL更规范优雅）

直接把dir作为可选路由参数加到路径中，同时添加正则约束避免路径遍历安全风险：

Route::get('/storage/image/{dir?}/{file}', function ($dir = "products", $file) {
    return response()->file(storage_path("app/images/$dir/$file"));
})
->name("storageImg")
// 正则约束参数格式，防止路径穿越攻击
->where([
    'dir' => '[a-zA-Z0-9_-]+',
    'file' => '[a-zA-Z0-9_.-]+'
]);

调用方式和你要求的完全一致：

{{ route("storageImg", ["file" => "fileName", "dir" => "fileDirectoryName"]) }}

不传dir参数时会自动使用默认值products，和原有逻辑一致。

方案2：保留原有路由路径，`dir`作为查询参数传递

如果不想修改已经在使用的旧路由链接，可以选择这种兼容方案，直接从请求查询字符串中读取dir参数：

Route::get('/storage/image/{file}', function ($file) {
    // 从请求中取dir参数，默认值为products
    $dir = request()->get('dir', 'products');
    // 手动校验dir格式，避免安全风险
    if (!preg_match('/^[a-zA-Z0-9_-]+$/', $dir)) {
        abort(400);
    }
    return response()->file(storage_path("app/images/$dir/$file"));
})
->name("storageImg")
->where('file', '[a-zA-Z0-9_.-]+');

这种方案下调用时传入的dir参数会自动转为查询字符串，原有不带dir的调用完全不需要修改。