PHP 8 Attributes是可执行元数据而非注释，需用#[Attribute]显式声明作用域，通过反射读取并调用newInstance()实例化使用，生产中须缓存反射结果以优化性能。
PHP 8 的 Attributes（属性/注解）不是注释，而是可被解析、参与运行时逻辑的元数据。用法核心就三点：定义注解类、在代码上标注、用反射读取并处理。
定义一个可用的注解类
必须用 #[Attribute] 显式声明，并明确它能用在哪儿。构造函数参数建议全设为 public 属性，方便反射自动绑定：
- 基础写法：
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)] - 支持重复使用需加
Attribute::IS_REPEATABLE - 构造函数里用
public string $path这种语法，PHP 8.1+ 才能通过newInstance()自动赋值 - 参数带默认值（如
array $methods = ['GET']）时，注解中不写该参数也不会报错，直接用默认值
在类、方法或属性上添加注解
语法简洁，类似实例化但省略 new：
-
#[Route('/api/users', methods: ['GET', 'POST'])]—— 支持命名参数，顺序无关 -
#[Middleware('AuthMiddleware')]可以和 Route 并存，甚至多次出现（如果加了IS_REPEATABLE） - 可同时标注多个不同注解：
#[Route(...)] #[Validate(...)] #[Cache(60)]
用反射读取并实例化注解
Attributes 本身不执行逻辑，靠反射提取后调用 newInstance() 才真正起作用：
立即学习“PHP免费学习笔记（深入）”；
- 获取类上的注解：
$ref = new ReflectionClass(UserController::class); $attrs = $ref->getAttributes(Route::class); - 获取方法上的注解：
$method = $ref->getMethod('index'); $attrs = $method->getAttributes(); - 实例化并取值：
$route = $attrs[0]->newInstance(); echo $route->path; - 注意：
getAttributes()返回的是ReflectionAttribute对象数组，不是注解实例本身
实际用起来要注意的细节
几个容易踩坑的地方：
- 写错参数名会直接报
TypeError，比如注解写了method: 'POST'，但构造函数只接受methods - IDE 提示依赖显式声明作用域，不加 #[Attribute] 或只写空括号，提示可能失效
- 生产环境务必缓存反射结果，否则每次请求都遍历反射，性能损耗明显
- 别和 XML 的
attributes()方法混淆——那是 SimpleXMLElement 的方法，和 PHP8 注解完全无关
