<p>PHP 8.1 没有 attribute() 函数，而是通过 #[Attribute] 标记类、#[YourAttribute] 添加元数据、反射 getAttributes() + newInstance() 读取；需指定 TARGET_* 常量限定使用位置。</p>
PHP 8.1 中并没有一个叫 attribute() 的函数。你提到的可能是对 Attributes（属性/注解） 机制的误解。PHP 8.0 引入的是 #[...] 语法（称为 Attributes），不是函数调用，也不是 attribute() 这样的内置函数。
真正用来给类添加元数据的方式，是使用 #[AttributeName(...)] 语法，配合自定义的 Attribute 类，并通过反射（Reflection）在运行时读取。
下面直接说清楚怎么操作：
如何用 Attributes 给类添加元数据
你需要三步：
立即学习“PHP免费学习笔记（深入）”；
- 定义一个带
#[Attribute]标记的类 - 在目标类（或方法、属性等）前用
#[YourAttribute]添加元数据 - 用
ReflectionClass读取它
例如：
#[Attribute(Attribute::TARGET_CLASS)]
class ApiVersion {
public function __construct(public string $version) {}
}
#[ApiVersion("v2")]
class UserController {
// 类体
}这样就为 UserController 类添加了 ApiVersion("v2") 这条元数据。
怎么读取这个元数据？
$reflection = new ReflectionClass(UserController::class);
$attributes = $reflection->getAttributes(ApiVersion::class);
foreach ($attributes as $attr) {
$instance = $attr->newInstance(); // 触发 ApiVersion->__construct()
echo $instance->version; // 输出 "v2"
}注意：
-
getAttributes()返回的是ReflectionAttribute对象列表，不是直接的实例 - 必须调用
newInstance()才会真正构造你的 Attribute 类（不会自动实例化） -
Attribute::TARGET_CLASS表示该 Attribute 只能用在类上，写错位置会报错（如用在方法上但没声明TARGET_METHOD）
常见目标常量（控制能用在哪）
| 常量 | 含义 |
|---|---|
Attribute::TARGET_CLASS |
类定义前 |
Attribute::TARGET_METHOD |
方法定义前 |
Attribute::TARGET_PROPERTY |
属性定义前 |
Attribute::TARGET_PARAMETER |
函数/方法参数前 |
Attribute::TARGET_ALL |
所有位置都允许 |
可组合使用：
#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
class Loggable { ... }小提醒
- 不要写成
attribute(...)或@attribute—— 那是旧式注释或别的语言习惯 - Attributes 是真实可执行的 PHP 类，支持类型声明、构造参数校验，比 DocBlock 更健壮
- IDE 和静态分析工具（如 PHPStan）能识别并校验 Attributes，拼错名会立刻报错，不会静默失效
不复杂但容易忽略：Attribute 类必须加 #[Attribute]，且构造参数需与使用时一致，否则反射时报错。
