PHP 8.1 中自定义 attribute 需通过 ReflectionClass 等反射类调用 getAttributes() 获取 ReflectionAttribute 数组，再用 newInstance() 实例化或 getArguments() 提取参数；需正确设置 Attribute 目标类型且构造函数兼容反射。
在 PHP 8.1 中，通过 #[Attribute] 标记的类（即自定义注解/属性），需借助反射 API 的 ReflectionClass、ReflectionMethod 等获取其元数据。核心是使用 getAttributes() 方法，它返回 ReflectionAttribute 实例数组，再调用 newInstance() 或 getArguments() 提取实际值。
获取类上声明的 attribute 实例
若目标类被某个 attribute 标记，例如：
#[MyAttribute("hello", mode: "dev")]
class UserService {}
可通过 ReflectionClass 获取：
- 创建
ReflectionClass实例：$ref = new ReflectionClass(UserService::class); - 调用
$ref->getAttributes(MyAttribute::class)得到匹配的ReflectionAttribute数组 - 对每个结果调用
$attr->newInstance()实例化该 attribute 类（要求其构造函数参数可被自动解析） - 若需原始参数（如命名参数或无法自动实例化），可用
$attr->getArguments()返回键值对数组
获取方法、属性或参数上的 attribute
attribute 可标注在多种上下文，反射方式类似但入口不同：
立即学习“PHP免费学习笔记（深入）”；
- 方法：
(new ReflectionMethod(UserService::class, 'save'))->getAttributes(Permission::class) - 属性：
(new ReflectionProperty(UserService::class, 'logger'))->getAttributes(Inject::class) - 函数参数：
(new ReflectionParameter([UserService::class, 'save'], 'user'))->getAttributes(Validate::class)
注意：PHP 默认只保留 Attribute::TARGET_CLASS | Attribute::TARGET_METHOD 等目标类型，定义 attribute 类时需显式指定 #[Attribute(Attribute::TARGET_PROPERTY)] 才能用于属性。
attribute 类定义与反射兼容性要点
为确保能顺利通过反射获取，定义自定义 attribute 时注意：
- 必须使用
#[Attribute]标记，且传入合法的Attribute::TARGET_*常量组合 - 若希望
newInstance()正常工作，构造函数参数应有默认值，或全部为标量/可序列化类型；含对象依赖会失败 - 支持命名参数（PHP 8.0+），
getArguments()返回关联数组，键为参数名，值为传入的实际值 - 若未指定
Attribute::IS_REPEATABLE，同位置重复声明相同 attribute 会被后声明覆盖
完整示例：读取并使用 attribute 元数据
假设定义了如下 attribute：
#[Attribute(Attribute::TARGET_CLASS)]
class Route {
public function __construct(
public string $path,
public string $method = 'GET'
) {}
}
然后在类上使用：
#[Route('/api/users', method: 'POST')]
class UserController {}
反射读取方式：
$ref = new ReflectionClass(UserController::class);
$attrs = $ref->getAttributes(Route::class);
if (!empty($attrs)) {
$route = $attrs[0]->newInstance(); // 实例化 Route('/api/users', 'POST')
echo $route->path; // '/api/users'
echo $route->method; // 'POST'
}
