PHP 8 Attributes与反射机制：深入理解元数据注解的运行时访问

<?php

use Attribute; // 导入内置的 Attribute 类
use ReflectionClass; // 导入反射类，用于运行时访问属性
use ReflectionAttribute; // 导入反射属性类

// 1. 定义一个自定义Attribute类
// 必须使用内置的 #[Attribute] 标记来声明这是一个属性类
// 这里的 Attribute::TARGET_CLASS 表示 MyAttribute 只能应用于类
#[Attribute(Attribute::TARGET_CLASS)]
class MyAttribute
{
    private string $message;

    public function __construct(string $message)
    {
        $this->message = $message;
        // 重要提示：此构造函数不会在 SomeClass 被定义时自动执行。
        // 它只会在通过反射明确创建 MyAttribute 实例时才会被调用。
        // 因此，如果你在这里放置 echo 语句，它也不会在类定义时输出。
        // echo "MyAttribute 构造函数被调用，消息: {$message}\n"; // 示例，通常不在此处输出
    }

    public function getMessage(): string
    {
        return $this->message;
    }
}

// 2. 将Attribute应用于一个类
// 在这里，我们将 MyAttribute 应用于 SomeClass
#[MyAttribute('Hello from the Attribute!')]
class SomeClass
{
    // ... 类的其他定义，例如属性、方法等 ...
}

// ... 后续代码将演示如何通过反射访问这个 Attribute ...

?>

<?php
// ... （接上文的 MyAttribute 和 SomeClass 定义） ...

// 3. 通过反射机制访问并实例化Attributes

echo "--- 开始访问 SomeClass 的 Attributes ---\n";

// 首先，创建一个 ReflectionClass 实例来检查 SomeClass
$reflection = new ReflectionClass(SomeClass::class);

// 获取应用于 SomeClass 的所有属性（Attributes）
// getAttributes() 方法返回一个 ReflectionAttribute 对象的数组
$attributes = $reflection->getAttributes();

// 遍历获取到的属性
if (!empty($attributes)) {
    echo "为 SomeClass 找到了 " . count($attributes) . " 个 Attribute(s):\n";
    foreach ($attributes as $attribute) {
        // $attribute 是 ReflectionAttribute 的一个实例
        echo "- Attribute 名称: " . $attribute->getName() . "\n";
        // 你可以通过 getArguments() 获取构造函数参数
        // print_r($attribute->getArguments());

        // 实例化 Attribute 对象。此时，MyAttribute 的构造函数才会被调用。
        $myAttributeInstance = $attribute->newInstance();

        // 检查实例类型并访问其方法
        if ($myAttributeInstance instanceof MyAttribute) {
            echo "  从 Attribute 实例获取的消息: " . $myAttributeInstance->getMessage() . "\n";
        }
    }
} else {
    echo "未在 SomeClass 上找到任何 Attribute。\n";
}

echo "--- 访问结束 ---\n";

?>

--- 开始访问 SomeClass 的 Attributes ---
为 SomeClass 找到了 1 个 Attribute(s):
- Attribute 名称: MyAttribute
  从 Attribute 实例获取的消息: Hello from the Attribute!
--- 访问结束 ---

// 假设 SomeClass 中有一个方法
// #[MyAttribute('Method Attribute')]
// public function myMethod() {}

// $reflectionMethod = $reflection->getMethod('myMethod');
// $methodAttributes = $reflectionMethod->getAttributes();
// // ... 同样的方式遍历和实例化 ...