一、Attributes技术解析

PHP8引入的Attributes（注解）彻底改变了传统通过文档注释实现元编程的方式。与PHP5.4+的DocBlock注释不同，Attributes是原生语法结构，具有以下核心优势：

• 编译时验证语法
• 可通过反射API直接读取
• 支持强类型参数
• 不依赖字符串解析

二、路由注解实战案例

下面实现一个轻量级路由注解系统：

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

class UserController {
    #[Route('/users', 'GET')]
    public function listUsers() {
        return json_encode(['users' => [...]);
    }
}

// 路由解析器
$reflection = new ReflectionMethod(UserController::class, 'listUsers');
$attributes = $reflection->getAttributes(Route::class);

foreach ($attributes as $attribute) {
    $route = $attribute->newInstance();
    echo "注册路由：{$route->method} {$route->path}";
}

三、性能优化对比

与传统DocBlock相比，Attributes在100万次调用测试中：

四、高级应用：验证器注解

结合类型系统实现自动验证：

#[Attribute(Attribute::TARGET_PROPERTY)]
class EmailValidation {
    public function validate(string $value): bool {
        return filter_var($value, FILTER_VALIDATE_EMAIL) !== false;
    }
}

class User {
    #[EmailValidation]
    public string $email;
}

// 自动验证逻辑
$user = new User();
$user->email = 'test@example.com';

$reflection = new ReflectionProperty($user, 'email');
foreach ($reflection->getAttributes() as $attr) {
    $validator = $attr->newInstance();
    if (!$validator->validate($user->email)) {
        throw new InvalidArgumentException("邮箱格式错误");
    }
}