PHP 反射获取类注解 attribute，解析自定义标记做元编程-php教程-PHP中文网

php 8.0+ 支持原生 attribute，配合 reflection 可实现元编程；通过 getattributes() 获取并用 newinstance() 实例化自定义注解类，支持类、方法、参数等多目标标记，适用于路由、权限、日志等行为增强。

php 反射获取类注解 attribute，解析自定义标记做元编程

PHP 8.0+ 支持原生 Attribute（即注解），配合反射（Reflection）可实现轻量级元编程。要获取类、方法或属性上的自定义 attribute 并解析执行逻辑，核心是使用 ReflectionClass、ReflectionMethod 等的 getAttributes() 方法。

定义自定义 Attribute 类

Attribute 必须用 #[Attribute] 标记，并指定作用域（如 Attribute::TARGET_CLASS）。它本身是一个普通类，可带构造参数：

#[Attribute(Attribute::TARGET_CLASS | Attribute::TARGET_METHOD)]
class Route
{
    public function __construct(
        public string $path,
        public string $method = 'GET'
    ) {}
}

用反射读取并匹配 Attribute

通过反射对象调用 getAttributes() 获取所有 attribute 实例，再用 isInstance() 或直接类型检查筛选目标 attribute：

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

$ref = new ReflectionClass(UserController::class);
$attrs = $ref->getAttributes(Route::class);

foreach ($attrs as $attr) {
    $route = $attr->newInstance(); // 触发构造，拿到实例
    echo "Route: {$route->method} {$route->path}\n";
}

getAttributes() 返回 ReflectionAttribute[] 数组，不传参则返回全部，传类名则只返回该类型
newInstance() 安全执行构造逻辑，支持带参、默认值、类型约束
若 attribute 构造失败（如类型不匹配），会抛出 Error，建议加 try-catch

在方法或参数上使用 Attribute 做行为增强

Attribute 不仅能标记类，还能标记方法、参数、属性等，适合做权限校验、日志、自动绑定等：

class Auth
{
    public function __construct(public string $role) {}
}

class AdminController
{
    #[Auth('admin')]
    public function deleteUser(int $id): void
    {
        // ...
    }
}

// 反射检查方法是否需鉴权
$method = new ReflectionMethod(AdminController::class, 'deleteUser');
$authAttr = $method->getAttributes(Auth::class)[0] ?? null;

if ($authAttr) {
    $auth = $authAttr->newInstance();
    if (!hasRole($auth->role)) {
        throw new PermissionDeniedException();
    }
}