Hyperf路由参数正则约束怎么写-php教程-PHP中文网

hyperf路由参数正则约束必须写在path花括号内，如{id:\d+}，不加则非法值直入控制器；加了则路由层拦截返回404，不触发后续逻辑。

hyperf路由参数正则约束怎么写

Hyperf 路由参数的正则约束必须写在 path 字符串的花括号内，用冒号分隔参数名和正则表达式，例如 {id:\d+}。这不是可选项，而是路由匹配阶段的硬性校验规则——不加正则，非法值会直接进入控制器；加了，不匹配的请求在路由层就被拦截（返回 404），根本不会触发控制器逻辑。

在 #[HttpGet]、#[HttpPost] 等注解的 path 参数里直接写：

#[HttpGet(path: "/user/{id:\d+}")] → 只匹配 /user/123，/user/abc 直接 404
#[HttpGet(path: "/post/{slug:[a-z\-]+}")] → 要求 slug 全小写+连字符，如 /post/my-article
#[HttpGet(path: "/file/{name:.+}")] → 允许任意非空字符（注意点号要转义）

⚠️ 注意：{id} 单独写没有约束；{id:\d*} 会匹配空字符串，容易引发隐患；{id:\d+} 才是安全的“至少一位数字”。

使用 Router::addRoute() 时，路径字符串支持相同语法：

Router::addRoute('GET', '/order/{sn:[A-Z]{2}\d{6}}', 'App\Controller\OrderController::show'); → 匹配 SN 如 AB123456
Router::get('/api/v1/users', ...) 不支持正则，只能用于静态路径
多方法需显式列出：Router::addRoute(['GET', 'HEAD'], '/health/{zone:[a-z]+}', ...)

❌ 错误写法：Router::post('/callback/{id:\d+}', ...) —— Router::post() 忽略花括号里的正则，必须改用 addRoute。

当代理已经知道网站路由或内容URL，并且在启动前需要有效的sitemap XML、sitemap索引或robots.txt引用时，请使用sitemap。这是一个发布构件技能，而不是爬虫或SEO平台。

下载

推荐用明确、无歧义的模式，避免过度宽松：

\d+：纯数字，至少一位（最常用）
[a-z]+：小写字母，适合 slug 或 code
[a-zA-Z0-9_\-]+：用户名、标识符常用
[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}：手动写 UUID 格式（比 uuid 别名更可控）

? 提示：Hyperf 不提供 Laravel 那样的 ->where('id', 'digits') 链式调用，也不支持预设别名（如 alpha），所有约束都靠原生正则实现。