PHP 8.1 中需用 ReflectionClass::getAttributes() 获取自定义 Attribute，再调用 newInstance() 实例化以读取参数值；getArguments() 仅返回原始参数数组，不推荐直接使用。
PHP8.1 中用 ReflectionClass 读取带参数的自定义注解（Attribute）
PHP8.1 的 Attribute 是真反射可读的，但必须用 ReflectionClass::getAttributes()（不是旧版的 doc comment 解析），且类/方法/属性上得用 #[SomeAttr(...)] 语法显式声明，否则 getAttributes() 返回空数组。
关键点：带参数的 Attribute 必须定义为「具名参数」或「位置参数」，且在反射后需调用 newInstance() 才能真正实例化并读取参数值；直接访问 $attr->getArguments() 只返回原始未解析的参数数组（含键名或索引），不推荐直接依赖它。
- 自定义 Attribute 类必须加
#[Attribute]，且建议指定Attribute::TARGET_CLASS | Attribute::TARGET_METHOD等目标 -
getAttributes()默认只查当前类，不递归父类；要继承父类注解，得手动遍历getDeclaringClass()链 - 如果参数是对象、闭包或动态表达式（如
new DateTime()），newInstance()会失败 —— PHP8.1 仅支持字面量参数（字符串、数字、bool、null、数组、其他 Attribute）
#[Route("user", methods: ["GET"])] 这种命名参数怎么取值
命名参数（如 methods: ["GET"]）在 newInstance() 后会变成对象属性，直接访问即可。不要试图从 getArguments() 里手动解析键值对，那只是内部调试用的原始结构。
#[Attribute(Attribute::TARGET_CLASS)]
class Route
{
public function __construct(
public string $path,
public array $methods = ['GET']
) {}
}
// 反射读取
$ref = new ReflectionClass(UserController::class);
$attrs = $ref->getAttributes(Route::class);
if ($attrs) {
$route = $attrs[0]->newInstance(); // 实例化，自动注入 path/methods
echo $route->path; // "user"
print_r($route->methods); // ['GET']
}
- 构造函数参数必须全为
public属性，否则newInstance()不会赋值（PHP8.1 不支持私有属性自动绑定） - 如果构造函数有默认值（如
array $methods = ['GET']），但注解里没写该参数，newInstance()仍会用默认值，不会报错 - 若注解写了不存在的参数名（如
#[Route("u", method: "POST")]），PHP 报TypeError：`Argument method is not allowed`
批量读取多个同类型注解（比如多个 #[Middleware]）
getAttributes() 天然支持重复注解 —— 只要 Attribute 类没加 Attribute::IS_REPEATABLE 标志，重复声明会报致命错误；加了才允许同一个目标上出现多次。
立即学习“PHP免费学习笔记（深入）”；
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD | Attribute::IS_REPEATABLE)]
class Middleware
{
public function __construct(public string $name) {}
}
// 类上声明两个
#[Middleware("auth")]
#[Middleware("log")]
class AdminController {}
// 反射获取全部
$attrs = (new ReflectionClass(AdminController::class))
->getAttributes(Middleware::class);
foreach ($attrs as $attr) {
$mw = $attr->newInstance();
echo $mw->name . "\n"; // auth\nlog\n
}
- 不加
Attribute::IS_REPEATABLE却写了多个同名注解，PHP 直接 Fatal error：`Cannot declare multiple instances of attribute` -
getAttributes()返回顺序 = 源码中声明顺序，不是按类继承层级；父类和子类的同名注解需分别获取 - 如果只想取第一个，用
$attrs[0]->newInstance()即可，不用循环
常见错误：getAttributes() 返回空，但代码明明写了 #[MyAttr]
最常踩的坑不是语法，而是「没启用 Attribute 支持」或「作用域不匹配」。PHP8.1 默认开启，但某些 SAPI（如 CLI 带 opcache 预加载）可能跳过解析；更大概率是目标类型不一致。
- 检查
#[MyAttr]是否写在类、方法、属性等getAttributes()调用目标的正确位置（比如对ReflectionMethod调用却在类上写了注解） - 确认 Attribute 类本身也用了
#[Attribute]，且没拼错名字（大小写敏感，MyAttr≠myattr） - CLI 下运行时，如果用了
opcache.enable_cli=1且预加载了文件，部分版本（如 8.1.0–8.1.2）存在 Attribute 丢失 bug，升级到 8.1.3+ 或关掉 CLI opcache - IDE 或静态分析工具（如 PHPStan）可能误报「Attribute not found」，但实际运行正常 —— 它们不执行
newInstance()，只做语法扫描
真正难调试的是参数嵌套：比如 #[Config(host: DatabaseConfig::class)]，其中 DatabaseConfig::class 是合法字面量，但如果你传的是 new DatabaseConfig()，PHP 会在解析阶段就拒绝，连反射都进不去。
