ThinkPHP可选参数需语法标记（如[:name]）与方法参数默认值协同生效，正则约束须键名一致且格式合规，pattern仅作用于请求匹配不参与URL生成，CLI路由需单独配置。
可选参数怎么写才真正生效
ThinkPHP 的可选参数不是靠“写不写”决定的，而是靠语法标记 + 顺序匹配共同控制。用 [:name] 或 <name></name> 是基础，但仅这样还不够——控制器方法参数必须保持对应位置可为空，否则仍会报错或取不到值。
-
[:name]和<name></name>效果一致，TP6 推荐后者；hello/[:name]匹配/hello和/hello/tom都成功 - 控制器方法签名必须兼容：若路由是
user/[:id]/[:name]，方法就得写成public function info($id = null, $name = null)，不能只写$id - 可选参数不能跳过中间项：
user/[:id]/[:name]/[:type]中，如果只传/user/123//admin（空段），框架不会自动对齐，$name会是空字符串，$type才拿到admin，极易出错 - 更稳妥的做法是用
->default(['name' => 'guest'])显式设默认值，配合非空参数签名：public function info($id, $name)，避免判空逻辑散落在各处
正则约束为什么加了也不生效
最常见的情况是 key 对不上、写法越界、或误以为框架会自动识别变量名。pattern() 不是装饰器，它只认键名和正则片段的严格匹配。
- 占位符叫
<uid></uid>，->pattern()里就必须写['uid' => '\d+']；写成['id' => '\d+']完全无效 - 正则不能带
^、$、括号()、修饰符如/i；['id' => '\d+']✅，['id' => '^\d+$']❌，['id' => '(\d+)']❌ - 中文必须用 Unicode 范围 + 框架隐式
u修饰：['title' => '[\x{4e00}-\x{9fa5}a-zA-Z0-9_-]+']，写[\u4e00-\u9fa5]在 PHP 正则里不合法 - 斜杠类参数（如 Base64、文件路径）禁用
.*，改用\S+：['path' => '\S+']，避免吞掉后续路由段
多个参数时 pattern 和顺序怎么协同
ThinkPHP 按路径段顺序注入参数，不看键名，pattern 只校验单个字段格式。一旦顺序错、约束漏、类型声明强，PHP 8+ 直接 TypeError。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
- 路由
blog/<year>/<month>/<id></id></month></year>→ 控制器方法必须是public function detail($year, $month, $id)，错一位（比如写成$id, $year, $month）所有参数都为null - pattern 必须覆盖全部动态段：
->pattern(['year' => '\d{4}', 'month' => '\d{1,2}', 'id' => '\d+'])，漏一个就可能让非法值穿透进来 - 若方法有类型声明
public function detail(int $year, string $month, int $id)，对应 pattern 就不能宽松：比如month写成'[a-z]+'，传13就触发TypeError - CLI 环境下路由不加载？检查是否在
app/route/cli.php单独定义，web 路由文件（如app/route/app.php）对 CLI 无效
route() 生成链接时 pattern 为啥不起作用
这是最容易被忽略的单向性设计：pattern 只在请求进来的路由匹配阶段生效，反向生成 URL（如 url('user', ['id' => 'abc'])）完全不校验。
立即学习“PHP免费学习笔记（深入）”；
- 前端拼出
/user/abc，后端没报错，但用户点进去直接 404 —— 因为pattern(['id' => '\d+'])拦住了这个请求，而生成环节毫无感知 - 测试时不能只测 controller 返回，必须真实发 HTTP 请求，或手动调用
Route::parseUrl('/user/abc')看是否返回 false - 想让
url()也受控？只能靠业务层提前过滤：if (!preg_match('/^\d+$/', $id)) { throw new HttpException(400); }，框架不提供双向约束 - 闭包路由中引用模型，记得用完整命名空间：
\app\model\User::get($id)，写User::get()会被自动补前缀，报Class not found
