PHP属性不是语法糖，而是编译期可读、运行时需反射提取的元数据机制；必须用#[Attribute]标记并继承Attribute基类，显式声明作用域（如TARGET_PROPERTY）和可重复性（IS_REPEATABLE），构造参数须类型安全且不可含运行时逻辑。
PHP 属性（Attributes）不是语法糖，是元数据从字符串注释升级为可执行对象的关键分水岭。用错地方或忽略反射开销，反而会让代码更难维护。
#[Attribute] 类必须显式声明作用域和可重复性
不加 flags 参数的 #[Attribute] 默认只允许标记类，且不可重复使用——这和多数业务场景冲突。比如你想在同一个属性上叠加多个验证规则，或同时标注路由和缓存策略，就必须手动指定目标和重复标识。
-
#[Attribute(Attribute::TARGET_PROPERTY | Attribute::TARGET_METHOD)]：明确限定可用位置，避免误标到函数参数上导致运行时报错 -
#[Attribute(Attribute::IS_REPEATABLE)]：否则第二次使用同名 Attribute 会触发Fatal error: Duplicate attribute - 混合使用时顺序无关，但推荐写成
#[Attribute(Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]，语义清晰
构造函数参数必须类型安全，且不能依赖运行时解析
Attribute 构造函数里写的每个参数，都会在编译期被 PHP 引擎校验。传错类型、少传必填参数、用错命名参数名，都会直接报 ParseError 或 TypeError，而不是等到反射时才发现。
- 支持命名参数：
#[EmailValidation(checkDNS: true, allowedDomains: ['gmail.com'])]，比位置参数可读性强得多 - 数组/对象不能作为构造参数（PHP 不支持字面量对象），
allowedDomains只能是array字面量或字符串 - 避免在构造函数里做复杂逻辑（如远程请求、文件读取），Attribute 实例化发生在解析阶段，非运行时上下文
反射获取 Attributes 有性能代价，别在热路径反复调用
ReflectionClass::getAttributes() 看似轻量，但底层要扫描 AST 节点并实例化 Attribute 对象。在高频请求中（如每次 HTTP 请求都反射控制器方法），可能成为瓶颈。
立即学习“PHP免费学习笔记（深入）”；
- 缓存反射结果：用
static $cache = [];存ReflectionMethod实例，避免重复创建 - 按需加载：不要一次性获取所有 Attribute，而是先用
getAttributes(EmailValidation::class)精准过滤 - 注意
getArguments()返回的是原始字面量值，不是求值后的结果；checkDNS: true拿到的是布尔true，不是字符串"true"
Laravel/Symfony 中 Attribute 与框架约定的兼容边界
主流框架尚未完全切换到原生 Attribute，目前多是“双轨制”：旧注释仍支持，新 Attribute 需显式启用或通过适配层桥接。直接替换 @Route 为 #[Route] 很可能无效。
- Laravel 10+ 支持
#[Middleware]，但#[Route]仍需laravel/attributes扩展包或自定义服务提供者 - Symfony 6.2+ 提供
Symfony\Component\Attribute\AsEventListener，但 Doctrine ORM 的#[Column]还没进核心，得靠doctrine/ormv3.0+ 配合 - 自定义 Attribute 若想被框架识别，必须继承框架约定的基类（如
Symfony\Contracts\Service\Attribute\Required），光有#[Attribute]不够
真正难的不是写一个 #[Validate]，而是让它的生命周期嵌入到请求处理链中——从解析、缓存、校验到错误映射，每一步都得对齐框架的扩展机制。跳过这层，Attribute 就只是个带语法高亮的装饰品。
