注解是PHP8可执行的元数据而非注释，需用#[Attribute]显式声明作用域，配合反射实现框架自动化，如路由注册与参数校验，生产中应缓存反射结果以优化性能。
注解不是注释，是可执行的元数据
很多人刚接触 PHP8 注解（Attributes）时，会下意识把它当成带格式的注释——其实完全不是。注解是语言级语法特性，写在代码里会被 PHP 解析器识别、编译，并可通过反射（ReflectionAttribute）在运行时读取和处理。它不参与逻辑执行，但能驱动框架行为，比如自动注册路由、注入依赖、校验参数。
基本写法很直观：#[Route("/api/users", methods: ["GET"])]。这看起来像类实例化，但省略了 new 关键字；括号内支持命名参数（PHP8 新特性），参数顺序无关，语义清晰。
自定义注解类必须用 #[Attribute] 明确作用域
定义一个注解类时，必须用内置注解 #[Attribute] 标记，否则 PHP 无法识别其用途，也无法控制它能用在哪儿。
- 不加 #[Attribute]：PHP 会按使用位置“猜”作用域（如修饰方法就当 TARGET_METHOD），但这是隐式行为，不可靠，也不利于 IDE 提示和静态分析
-
显式声明：例如
#[Attribute(Attribute::TARGET_METHOD | Attribute::TARGET_FUNCTION)]，明确限定只能用于方法或函数 -
允许重复：加
Attribute::IS_REPEATABLE才能多次使用同一注解，比如一个接口多个别名路由：#[Route("/v1/user")] #[Route("/v2/user")]
注解 + 反射 = 框架自动化核心
注解本身不干活，真正起作用的是配合反射遍历并解析它们。典型流程是：
立即学习“PHP免费学习笔记（深入）”；
- 在应用启动或控制器加载时，用
ReflectionClass或ReflectionMethod获取目标元素 - 调用
getAttributes()提取所有注解实例 - 对每个注解调用
newInstance()实例化（支持命名参数，自动绑定） - 根据注解内容注册路由、绑定中间件、设置验证规则等
例如：#[Validate(rules: ["required", "email"])] 可让框架在请求到来前自动校验字段，无需在方法体内手写 if 判断。
生产环境要兼顾性能与可维护性
注解带来便利，但也引入反射开销。实际项目中建议：
- 首次加载时缓存反射结果（如用 APCu 或 OPcache 存储已解析的路由映射）
- 避免在高频循环中动态读取注解，把解析逻辑移到初始化阶段
- 结合 JIT 编译（启用
opcache.jit=1205）可缓解反射带来的性能损耗 - 注解值尽量保持简单（字符串、数组、布尔），避免嵌套对象或闭包——反射不支持序列化复杂结构
注解不是炫技工具，而是为减少样板代码、统一横切关注点服务的。用得克制，才真正提升工程效率。
