PHP attributes 读取类参数时怎么处理重复属性

PHP attributes 读取类参数时遇到“同一个属性不能重复使用”，根因通常不在 ReflectionParameter，而在属性类声明没有开放重复能力。需要重复标注时，先给属性类加上 Attribute::IS_REPEATABLE，再用参数反射的 getAttributes() 取得全部实例；不要把第二个值当成覆盖第一个值。

官方资料：https://www.php.net/manual/en/language.attributes.classes.php

重复属性报错，根因在属性类的声明契约

假设一个控制器参数既可以从查询字符串读取，也可以从请求头读取。若 From 只写了普通的 #[Attribute]，第二次挂载同名属性就会被 PHP 拒绝。这里要同时声明目标是参数，并允许重复：

TARGET_PARAMETER 解决“能挂在哪里”，IS_REPEATABLE 解决“同一位置能挂几次”。只加前者仍然不能重复；只加后者则会让属性的适用范围过宽。两者表达的是不同约束。

把多个 From 实例放到同一个方法参数上

重复属性的价值是保留多份独立配置，而不是把值拼成一个难以解释的数组。下面的 $id 同时声明两个来源，构造参数仍然各自独立：

这里不能使用“后声明覆盖前声明”的思路：两个 From 都是有效元数据。业务层可以规定优先级，也可以要求至少一个来源存在，但那是读取策略，不是 Attribute 语法自动提供的覆盖规则。

ReflectionParameter 如何拿到每一个属性实例

反射时先定位方法参数，再按属性类过滤。返回的是多个 ReflectionAttribute 描述对象；调用 newInstance() 之后，才真正创建 From 对象并触发构造参数检查：

getParameters()[0];
$attributes = $parameter->getAttributes(From::class);

foreach ($attributes as $attribute) {
    // getArguments 不实例化对象，适合做轻量检查或日志记录。
    $arguments = $attribute->getArguments();
    // newInstance 会按构造函数生成类型化的 From 对象。
    $source = $attribute->newInstance();
    echo $source->source . PHP_EOL;
}

如果只需读取配置原文，可使用 getArguments()；如果后续代码依赖属性类的公开属性、构造校验或类型约束，使用 newInstance() 更合适。两者都要放在循环中，否则重复声明仍会被无意压缩成一个结果。

落地时检查四个容易混淆的边界

框架做参数注入时，建议先把每个 From 映射成统一的候选来源，再定义缺失和冲突规则。例如 required=true 的来源全部缺失时抛出参数错误；多个来源同时命中时则明确优先级，避免依赖数组顺序产生隐蔽差异。

相关问题

不加 IS_REPEATABLE 能否在读取时合并两个属性？

不能。属性类未允许重复时，声明阶段就会失败，读取端没有机会合并。先修正 Attribute 元数据契约。

getAttributes() 和 getArguments() 是一回事吗？

不是。前者从反射目标取得属性描述对象数组，后者读取某一个描述对象携带的构造参数。

什么时候应该调用 newInstance()？

需要得到属性类对象、依赖构造函数类型检查或复用属性类方法时调用；只做名称和原始参数扫描时可以先不实例化。

把“是否可重复”放在属性类声明中，把“重复后如何取值”放在读取策略中，PHP attributes 的职责边界就清楚了：声明端保证数据能合法存在，反射端完整保留每一份配置，业务端再决定优先级和缺失处理。