PHP 8 Attributes 是可执行、可类型检查的代码对象，非注释替代品；定义需显式声明 #[Attribute] 并 use Attribute;，构造函数支持类型提示，反射获取后须调用 newInstance() 实例化。
PHP 8 的 Attributes 不是“更好用的注释”，而是把元数据从字符串升级为可执行、可类型检查、可反射读取的代码对象——不升级，你就还在用正则去 parse 注释。
定义自定义 Attribute 时必须加 #[Attribute]，且要 use Attribute;
很多新手直接写 #[MyRoute] 却没声明类本身是属性，结果运行时完全不生效。关键点只有两个：
-
#[Attribute]必须显式写在自定义类上，它是 PHP 识别“这是个属性”的唯一开关 -
use Attribute;不可省略（PHP 内置类，非命名空间别名），否则会报Fatal error: Uncaught Error: Class "Attribute" not found - 构造函数参数支持类型提示（如
public string $path），IDE 能自动补全、静态分析能提前捕获传参错误
错例：
class Route { public function __construct(public string $path) {} }→ 这个类根本不会被当作属性使用。正例：
use Attribute;<br>#[Attribute]<br>class Route { public function __construct(public string $path) {} }
getAttributes() 返回的是 ReflectionAttribute 对象，不是实例化后的属性类
调用 $reflection->getAttributes() 拿到的是未执行构造函数的 ReflectionAttribute 实例，必须显式调用 newInstance() 才会触发构造逻辑并返回你定义的属性对象。这点和旧注释解析完全不同——属性不是“自动运行”，而是按需实例化。
立即学习“PHP免费学习笔记（深入）”；
- 漏掉
newInstance()是最常见静默失败原因：$attr->getName()可用，但$attr->getArguments()返回空数组或报错 - 正确链式写法：
$route = $reflection->getAttributes(Route::class)[0]->newInstance(); - 如果属性类构造函数有必填参数，而目标代码里没传值（如
#[Route]没给$path），newInstance()会直接抛ArgumentCountError
用 Attribute::TARGET_XXX 控制作用域，避免误用和反射爆炸
不设 flags 的属性默认允许用在所有位置（类、方法、参数……），但实际业务中几乎不需要这么宽泛。比如路由属性只该出现在类或方法上，若被误标在参数里，不仅语义错乱，还会让反射遍历多出无效节点，拖慢启动性能。
- 常用组合：
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)] - 需要重复使用（如多个验证规则）必须加
Attribute::IS_REPEATABLE，否则第二次使用会报Attribute cannot be used multiple times - PHP 8.2+ 支持
Attribute::TARGET_PARAMETER，但要注意：函数参数上的属性只能通过ReflectionParameter::getAttributes()获取，不能从方法反射里“顺带”拿到
框架集成时别绕过原生属性，硬套旧注释解析器
有些项目为了兼容老代码，把 #[Route] 和 /** @Route */ 同时支持，结果反射层写了两套逻辑，还引入 Doctrine Annotations 这种额外依赖。这反而破坏了 Attributes 的核心优势——原生、轻量、无第三方解析开销。
- Symfony 5.2+、Laravel 9+、Doctrine ORM 3+ 都已原生支持属性，直接删掉注释解析器即可
- 迁移时注意：旧注释里的字符串写法（如
@ORM\Column(type="string")）要转成等价的属性调用（#[ORM\Column(type: 'string')]），引号、冒号、括号都要对齐 PHP 语法 - 混合使用时 IDE 可能只识别其中一种，导致补全失效或类型推导中断——建议一次性切换干净
真正麻烦的从来不是写法，而是反射访问路径的分散性：类、方法、属性、参数各自的 getAttributes() 方法互不相通，且必须手动判空、取索引、调 newInstance()。这些细节不踩一遍，很容易以为“属性没生效”。
