PHP ReflectionAttribute 怎样判断属性是否允许重复声明

在 PHP 8 的 Attribute 元数据扫描中，“属性类是否允许重复声明”和“当前方法上是否真的出现了重复属性”是两个判断。前者由 Attribute::IS_REPEATABLE 控制，后者交给 ReflectionAttribute::isRepeated()。官方地址：https://www.php.net/。不要用反射结果去替代属性类声明，也不要把 isRepeated() 当成配置开关。

先把 IS_REPEATABLE 配对到属性声明

假设路由元数据允许同一个方法绑定多个路径，属性类要同时声明目标类型和可重复标志。下面的位掩码只允许方法使用 Route，并允许同名属性出现多次。

如果去掉 Attribute::IS_REPEATABLE，同一方法上的第二个 Route 就不再是合法的重复声明。这个边界发生在属性使用阶段，不能等到 isRepeated() 返回结果后再补救。

用 isRepeated() 读取当前反射结果

反射阶段先取方法，再按属性类名筛选。不要直接假设数组长度就是全部语义：长度说明找到了多少个对象，isRepeated() 说明这些对象对应的名字是否在当前方法上重复。

getAttributes(Route::class);

foreach ($attributes as $attribute) {
    // isRepeated() 无参数，只判断该属性名在当前代码元素上是否重复。
    printf("%s %s repeated=%s\n",
        $attribute->getName(),
        $attribute->getArguments()['path'],
        $attribute->isRepeated() ? 'true' : 'false'
    );
}

这个示例会得到两个 Route 反射对象；在重复场景下，对应对象的 isRepeated() 为 true。如果方法只保留一个 Route，数组数量为 1，重复状态为 false。实际项目中建议先判断数量，再决定是否合并路由或记录配置冲突。

把数量、名称和重复状态一起处理

筛选名称时使用 getAttributes(Route::class)，不要把其他属性也算进重复数量。读取参数使用 getArguments()，它只返回构造参数，不会改变重复判断。若属性类目标不包含方法，或参数不满足构造函数要求，应该把它们作为配置错误处理，而不是当成重复属性。

常见问题

isRepeated() 能判断属性类是否声明了 IS_REPEATABLE 吗？

不能。它判断的是当前代码元素上的使用结果；是否允许重复要回到属性类的 #[Attribute(...)] 声明检查。

为什么 getAttributes() 返回多个对象但没有直接用 count()？

count() 能发现数量，不能表达属性名和当前对象的重复语义。数量、getName() 与 isRepeated() 联合使用更稳妥。

重复属性的参数顺序重要吗？

通常重要。路由、拦截器或标签规则可能按声明顺序合并，建议遍历返回数组时保留顺序，并在冲突时给出明确错误。