Slim 3 默认将路径中的 / 视为分隔符，导致带斜杠的参数（如 2022-123/A/B/C）无法被完整匹配；需通过正则路由约束 /{param:.*} 配合可选段语法 [/{param:.*}] 实现全路径捕获。
slim 3 默认将路径中的 `/` 视为分隔符，导致带斜杠的参数（如 `2022-123/a/b/c`）无法被完整匹配；需通过正则路由约束 `/{param:.*}` 配合可选段语法 `[/{param:.*}]` 实现全路径捕获。
在 Slim 3 中，路由参数默认采用「路径段（path segment）」语义——即每个 {param} 仅匹配两个 / 之间的内容（例如 /usage/abc/def 中的 abc 和 def 会被识别为两个独立段）。因此，当你的参数值本身含多个 /（如 2022-123/A/B/C），Slim 会尝试将其拆分为多个未定义的路由段，最终因路由不匹配而返回 404 Not Found。
✅ 正确解法是使用正则约束（Regex Constraint） 显式声明参数可匹配任意字符（包括 /），并配合可选路由段语法确保空参数也能兼容：
$app->get('/usage[/{protocol:.*}]', function (Request $request, Response $response, array $args) {
// 注意：使用正则约束后，推荐通过 $request->getAttribute() 获取参数
$protocol = $request->getAttribute('protocol');
// 安全处理：过滤空值或进行白名单校验（避免路径遍历等风险）
if ($protocol === null || trim($protocol) === '') {
return $response->withStatus(400)->write('Missing protocol');
}
// 示例：简单 sanitize（生产环境建议使用更严格的验证）
$sanitized = preg_replace('/[^a-zA-Z0-9\-_\/.]+/', '', $protocol);
// 继续业务逻辑...
return $response->withJson(['received' => $sanitized]);
});? 关键说明：
- /{protocol:.*} 中的 .* 是 PCRE 正则表达式，表示“匹配任意字符（含 /）零次或多次”；
- 方括号 [...] 表示该段为可选路由段，因此 /usage 和 /usage/2022-123/A/B/C 均能命中同一处理器；
- 使用 $request->getAttribute('protocol') 而非 $args['protocol'] 更可靠——当启用正则约束时，Slim 将参数注入请求属性（Attribute），而非传统 $args 数组（后者仅适用于无正则的简单段匹配）；
- ⚠️ 安全提醒：允许 / 进入参数会增加路径遍历（../）、目录枚举等风险。务必对 $protocol 做白名单校验（如仅允许 YYYY-MM-DD/[A-Z]+(/[A-Z]+)* 格式）或标准化处理（如 realpath() + 前缀校验），切勿直接拼接文件系统路径。
? 扩展技巧：若需支持多级嵌套但限制层级（如最多 4 级），可用更精确的正则，例如 /{protocol:[^\/]+(?:\/[^\/]+){0,3}}，既提升安全性，又保持语义清晰。
综上，通过正则路由约束与属性获取机制，你不仅能解决 404 问题，还能构建更健壮、可维护的 API 路由设计。
