PHP 属性的运行时实例化与反射机制解析

<?php
#[Attribute(Attribute::TARGET_FUNCTION)]
class ExampleAttribute
{
    public function __construct()
    {
        echo "ExampleAttribute 构造函数被调用！\n";
    }
}

#[ExampleAttribute()]
function exampleFunction()
{
    // ... 函数体 ...
}

// 此时，ExampleAttribute 的构造函数并不会被自动调用
?>

<?php

// 1. 定义一个属性类
#[Attribute(Attribute::TARGET_FUNCTION | Attribute::TARGET_METHOD | Attribute::TARGET_CLASS)]
class LogCallAttribute
{
    private string $message;

    public function __construct(string $message = "默认日志消息")
    {
        $this->message = $message;
        echo "LogCallAttribute 构造函数被调用，消息: " . $this->message . "\n";
    }

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

    public function executeAction(): void
    {
        echo "执行 LogCallAttribute 的额外动作: " . strtoupper($this->message) . "\n";
    }
}

// 2. 将属性应用到目标函数
#[LogCallAttribute("这是来自 exampleFunction 的自定义日志！")]
function exampleFunction(): void
{
    echo "exampleFunction 正在执行...\n";
}

// 3. 将属性应用到目标类和方法
#[LogCallAttribute("这是来自 MyClass 的日志！")]
class MyClass
{
    #[LogCallAttribute("这是来自 MyClass::myMethod 的日志！")]
    public function myMethod(): void
    {
        echo "MyClass::myMethod 正在执行...\n";
    }
}

echo "--- 运行时实例化属性示例 ---\n";

// 实例化 exampleFunction 的属性
echo "\n--- 处理 exampleFunction 的属性 ---\n";
$reflectionFunction = new ReflectionFunction('exampleFunction');
$functionAttributes = $reflectionFunction->getAttributes(LogCallAttribute::class); // 过滤只获取 LogCallAttribute

foreach ($functionAttributes as $attribute) {
    // $attribute 是一个 ReflectionAttribute 对象
    // 调用 newInstance() 会创建 LogCallAttribute 的实例，并执行其构造函数
    $logInstance = $attribute->newInstance();
    echo "获取到属性实例的消息: " . $logInstance->getMessage() . "\n";
    $logInstance->executeAction();
}

// 实例化 MyClass 的属性
echo "\n--- 处理 MyClass 的属性 ---\n";
$reflectionClass = new ReflectionClass(MyClass::class);
$classAttributes = $reflectionClass->getAttributes(LogCallAttribute::class);

foreach ($classAttributes as $attribute) {
    $logInstance = $attribute->newInstance();
    echo "获取到类属性实例的消息: " . $logInstance->getMessage() . "\n";
}

// 实例化 MyClass::myMethod 的属性
echo "\n--- 处理 MyClass::myMethod 的属性 ---\n";
$reflectionMethod = new ReflectionMethod(MyClass::class, 'myMethod');
$methodAttributes = $reflectionMethod->getAttributes(LogCallAttribute::class);

foreach ($methodAttributes as $attribute) {
    $logInstance = $attribute->newInstance();
    echo "获取到方法属性实例的消息: " . $logInstance->getMessage() . "\n";
}

echo "\n--- 原始函数/方法调用 ---\n";
exampleFunction();
$myObject = new MyClass();
$myObject->myMethod();

?>

--- 运行时实例化属性示例 ---

--- 处理 exampleFunction 的属性 ---
LogCallAttribute 构造函数被调用，消息: 这是来自 exampleFunction 的自定义日志！
获取到属性实例的消息: 这是来自 exampleFunction 的自定义日志！
执行 LOGCALLATTRIBUTE 的额外动作: 这是来自 EXAMPLEFUNCTION 的自定义日志！

--- 处理 MyClass 的属性 ---
LogCallAttribute 构造函数被调用，消息: 这是来自 MyClass 的日志！
获取到类属性实例的消息: 这是来自 MyClass 的日志！

--- 处理 MyClass::myMethod 的属性 ---
LogCallAttribute 构造函数被调用，消息: 这是来自 MyClass::myMethod 的日志！
获取到方法属性实例的消息: 这是来自 MyClass::myMethod 的日志！

--- 原始函数/方法调用 ---
exampleFunction 正在执行...
MyClass::myMethod 正在执行...