Laravel中使用GuzzleHttp时含斜杠参数的路由匹配问题

1. 修改Laravel路由定义 #

Laravel默认路由参数{param}不会匹配斜杠，必须通过正则约束让它支持任意字符（包括斜杠）。将路由参数改为{param:.*}格式：

// 原路由（无法匹配含斜杠的参数）
Route::get('/api/files/{file_path}', [FileController::class, 'show']);

// 修改后的路由（支持含斜杠的参数）
Route::get('/api/files/{file_path:.*}', [FileController::class, 'show']);

2. Guzzle请求的正确写法 #

无需手动转义或编码参数，直接将含斜杠的参数拼入URL即可，Guzzle会正确传递路径：

use GuzzleHttp\Client;

$client = new Client();
$targetPath = 'docs/v1/api-guide.pdf'; // 含斜杠的目标参数
$response = $client->get("http://your-domain.test/api/files/{$targetPath}");

如果需要更严谨的URI构建，可使用Guzzle的URI工具类：

use GuzzleHttp\Client;
use GuzzleHttp\Psr7\Uri;

$client = new Client();
$baseUri = new Uri('http://your-domain.test/api/files/');
$finalUri = $baseUri->withPath($baseUri->getPath() . 'docs/v1/api-guide.pdf');
$response = $client->get($finalUri);

3. 控制器获取参数 #

在控制器中正常获取路由参数即可，Laravel会自动将含斜杠的内容作为单个参数返回：

public function show(string $file_path)
{
    // $file_path 会完整接收 'docs/v1/api-guide.pdf'
    return response()->json(['path' => $file_path]);
}

注意事项 #

• 带.*约束的路由要放在同前缀的其他路由之后，避免匹配冲突。比如先定义/api/files/create这类明确路由，再定义带参数的路由。

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