PHP属性的实例化机制与反射应用

<?php
#[Attribute(\Attribute::TARGET_FUNCTION)] // 明确指定属性目标为函数
class ExampleAttribute
{
    public function __construct()
    {
        echo "ExampleAttribute 构造函数被调用！" . PHP_EOL;
    }
}

#[ExampleAttribute()]
function exampleFunction()
{
    echo "exampleFunction 执行中..." . PHP_EOL;
}

// 此时，直接调用 exampleFunction() 不会触发 ExampleAttribute 的构造函数
exampleFunction();
// 输出: exampleFunction 执行中...
// 可以看到 "ExampleAttribute 构造函数被调用！" 并未出现
?>

<?php
#[Attribute(\Attribute::TARGET_FUNCTION)]
class ExampleAttribute
{
    private string $message;

    public function __construct(string $msg = "默认消息：ExampleAttribute 构造函数被调用！")
    {
        $this->message = $msg;
        echo $this->message . PHP_EOL;
    }

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

#[ExampleAttribute("自定义消息：这是exampleFunction的属性！")]
function exampleFunction()
{
    echo "exampleFunction 执行中..." . PHP_EOL;
}

// --- 通过反射机制来处理属性 ---

// 1. 获取目标函数的反射对象
$reflectionFunction = new ReflectionFunction('exampleFunction');

// 2. 获取附着在该函数上的所有 ExampleAttribute 属性
// 可以选择性地传递属性类名作为参数，以过滤特定类型的属性
$attributes = $reflectionFunction->getAttributes(ExampleAttribute::class);

echo "--- 开始处理属性 ---" . PHP_EOL;

foreach ($attributes as $attribute) {
    // 3. 实例化属性对象，这将触发 ExampleAttribute 的构造函数
    $instance = $attribute->newInstance();

    // 此时，$instance 是 ExampleAttribute 的一个对象
    // 我们可以进一步调用其方法或访问属性
    echo "从属性实例获取消息: " . $instance->getMessage() . PHP_EOL;
}

echo "--- 属性处理结束 ---" . PHP_EOL;

// 正常调用函数
exampleFunction();
?>

--- 开始处理属性 ---
自定义消息：这是exampleFunction的属性！
从属性实例获取消息: 自定义消息：这是exampleFunction的属性！
--- 属性处理结束 ---
exampleFunction 执行中...