PHP 8.1支持通过ReflectionClass等的getAttributes()获取带参Attribute，并调用newInstance()实例化以读取完整参数值，需正确声明Attribute目标、参数顺序及默认值限制。
<p>PHP 8.1 支持在反射中读取带参数的 Attribute（属性注解），关键在于使用 <strong>ReflectionClass</strong>、<strong>ReflectionMethod</strong> 等反射类的 <code>getAttributes()</code> 方法，并调用 <code>newInstance()</code> 实例化注解对象。</p>
<H3>定义一个带参数的 Attribute 类</H3>
<p>需加 <code>#[Attribute]</code> 声明，构造参数按需设为 public 属性或通过 getter 访问：</p>
<font color="#888">
<pre>
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
class Route
{
public function __construct(
public string $path,
public string $method = 'GET',
public ?string $name = null
) {}
}
</pre>
</font>
<H3>在类或方法上使用该 Attribute</H3>
<p>支持位置参数、命名参数混合写法：</p>
<font color="#888">
<pre>
#[Route('/api/users', method: 'POST', name: 'create_user')]
class UserController
{
#[Route('/api/users/{id}', method: 'PUT')]
public function update($id) {}
}
</pre>
</font>
<H3>通过反射读取并获取完整参数值</H3>
<p>调用 <code>getAttributes()</code> 获取匹配的 Attribute 实例，再用 <code>newInstance()</code> 解析传入参数：</p>
<font color="#888">
<pre>
// 反射类
$reflectionClass = new ReflectionClass(UserController::class);
// 获取类上的 Route 注解（支持多实例）
foreach ($reflectionClass->getAttributes(Route::class) as $attribute) {
$route = $attribute->newInstance(); // 自动绑定构造参数
echo "Class route: {$route->path} ({$route->method})\n";
}
// 反射方法
$reflectionMethod = $reflectionClass->getMethod('update');
foreach ($reflectionMethod->getAttributes(Route::class) as $attribute) {
$route = $attribute->newInstance();
echo "Method route: {$route->path} ({$route->method})\n";
}
</pre>
</font>
<H3>注意事项与常见问题</H3>
<p>确保以下几点才能正确读取参数：</p>
<ul>
<li>Attribute 类必须有 <code>#[Attribute]</code> 声明，且目标（如 <code>Attribute::TARGET_CLASS</code>）匹配实际使用位置</li>
<li><code>getAttributes()</code> 默认只返回「精确匹配」类型；若要获取继承链上的注解，加第二个参数 <code>ReflectionAttribute::IS_INSTANCEOF</code></li>
<li>构造函数参数若含默认值，未传参时自动回退，默认值必须是字面量（不能是表达式或常量引用）</li>
<li>命名参数（如 <code>method: 'POST'</code>）和位置参数可混用，但位置参数必须在前</li>
</ul>
