PHP 8.1+ 的 #[Route] 属性是运行时可反射的元数据，需显式声明 Attribute::IS_REPEATABLE 和目标类型，独立成行紧贴元素上方，通过 Reflection API 读取并实例化，键名大小写敏感且拼错即失效。
PHP 8 的 #[Route] 等属性不是“更漂亮的注释”，而是运行时可执行、可反射、带类型约束的元数据节点；用错位置、漏写 #[Attribute] 或混进 PHPDoc，直接导致路由注册失败且无提示。
定义 Route Attribute 必须显式声明目标和可重复性
路由通常需在控制器方法上多次使用（如 GET + POST 同路径），也需支持类级前缀。不加 Attribute::IS_REPEATABLE 和组合 target，#[Route] 在方法上重复标注会静默忽略或报错。
-
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]是最常用组合 - 若只写
#[Attribute]，默认允许所有位置，但 IDE 和框架可能无法识别语义意图 - 漏掉
use Attribute;会触发ParseError: syntax error，不是运行时报错，是解析阶段就挂掉 - PHP 8.0 不支持
IS_REPEATABLE，必须升级到 8.1+ 才能安全复用#[Route]
应用 Route Attribute 时位置和语法零容忍
属性必须独立成行、紧贴被修饰元素上方，任何缩进、换行、嵌套在 docblock 或语句后都会失效——PHP 解析器根本不会把它当语法节点处理。
- ✅ 正确：
#[Route("/api/users", methods: ["GET"])]<br>public function list(): array { /* ... */ } - ❌ 错误：
/** #[Route("/api/users")] */（被当作文本注释丢弃） - ❌ 错误：
public function list(): array { #[Route("/x")] ... }（不在声明位置，语法错误） - ❌ 错误：
#[Route("/x")], #[Middleware("auth")]（逗号分隔只在数组形式中合法，单独写必须换行）
读取 Route Attributes 必须走 Reflection API，不能碰 getDocComment()
getDocComment() 返回的是字符串，完全拿不到 #[] 内容；而 getAttributes() 返回的是 ReflectionAttribute 对象，需调用 newInstance() 实例化才能拿到构造参数值。
Skill Weave Chains — 技能链路由引擎
下载
开箱即用的技能链路由引擎。13 条预定义链覆盖搜索、开发、审查、MLOps、法律、创意等场景，三层路由架构（触发词→SAD反馈→DAG编排），recall@10=96.97%。配置驱动（chains.yaml），零代码扩展。pip install skill-weave-chains 一键安装。
立即学习“PHP免费学习笔记（深入）”；
- 获取控制器类上的路由前缀：
(new ReflectionClass(UserController::class))->getAttributes(Route::class) - 获取方法上的完整路由：
(new ReflectionMethod(UserController::class, 'list'))->getAttributes(Route::class) - 不要用
getAttributes()不带参数全量获取再遍历过滤——性能差，且重复标记时容易漏掉某一个 -
newInstance()会执行构造函数，如果Route::__construct(public string $path, public array $methods = [])中$methods类型写成array|string，PHP 8.0 会报错（联合类型需 8.0+，但构造参数类型校验严格）
与框架集成时注意 Attribute 类自动加载和反射时机
Symfony 5.2+、Laravel 9+、Hyperf 等已原生支持属性路由，但前提是你的 Route 类能被自动加载，且反射发生在容器注册路由之前——否则框架压根看不到这些元数据。
- 确保
Route类所在命名空间已配置 autoload（如 composer.json 的"autoload": {"psr-4": {...}}） - 避免在
__construct()或静态初始化块里提前触发反射（比如在类定义时就调用getAttributes()），此时 autoloader 可能未就绪 - 多个
#[Route]堆叠时，框架需按顺序处理：先取类级 prefix，再合并方法级 path，最后解析methods、name等键名参数——参数名拼错（如写成methos）不会报错，但对应字段为null，路由匹配失效
最易被忽略的是：Attribute 构造参数的键名必须与框架反射读取逻辑完全一致，且大小写敏感；没有运行时校验，错一个字母，路由就消失得无声无息。
