PHP中如何实现基于方法返回值的后置注解？

针对你的需求——在布尔返回型方法返回true时自动执行额外逻辑，同时保持关注点分离，以下是几种实用方案：

一、自定义注解+原生反射实现 #

PHP原生提供完整的反射API（ReflectionMethod等），完全可以模拟Java式的注解触发逻辑，不需要依赖第三方库。核心思路是：通过注释定义自定义注解，用反射解析注解内容，在方法调用后判断返回值并执行对应逻辑。

实现步骤： #

1. 在目标方法的文档注释中添加自定义注解，指定回调逻辑
2. 封装代理工具类，负责解析注解、调用原方法、触发回调

示例代码： #

// 代理工具类
class MethodCallbackProxy {
    public static function invoke(object $instance, string $method, ...$args) {
        $reflection = new ReflectionMethod($instance, $method);
        $docComment = $reflection->getDocComment() ?: '';

        // 解析@OnReturnTrue注解，提取回调函数
        if (preg_match('/@OnReturnTrue\(callback="([^"]+)"\)/', $docComment, $matches)) {
            $callback = $matches[1];
            // 执行原方法
            $result = $instance->$method(...$args);
            
            if ($result === true && is_callable($callback)) {
                // 触发成功回调，可传递上下文参数
                call_user_func($callback, $instance, $method, $args);
            }

            return $result;
        }

        // 无注解时直接调用原方法
        return $instance->$method(...$args);
    }
}

// 业务类
class OrderService {
    /**
     * 尝试创建订单
     * @OnReturnTrue(callback="\App\Handlers\OrderSuccessHandler::notifyUser")
     */
    public function createOrder(array $params): bool {
        // 原业务逻辑：创建订单成功返回true，失败返回false
        return true;
    }
}

// 回调处理类
class OrderSuccessHandler {
    public static function notifyUser(object $instance, string $method, array $args) {
        // 这里写返回true后要执行的逻辑，比如发送通知、记录日志
        echo "订单创建成功，已通知用户";
    }
}

// 使用方式
$orderService = new OrderService();
MethodCallbackProxy::invoke($orderService, 'createOrder', ['id' => 123]);

二、装饰器模式（无反射，纯OOP） #

如果不想用反射，装饰器模式是更直观的关注点分离方案，通过包装原对象，在不修改原方法的前提下添加额外逻辑。

示例代码： #

// 定义业务接口
interface OrderInterface {
    public function createOrder(array $params): bool;
}

// 原业务类
class OrderService implements OrderInterface {
    public function createOrder(array $params): bool {
        return true;
    }
}

// 装饰器类，包装原业务对象
class OrderSuccessDecorator implements OrderInterface {
    private $orderService;
    private $successAction;

    public function __construct(OrderInterface $orderService, callable $successAction) {
        $this->orderService = $orderService;
        $this->successAction = $successAction;
    }

    public function createOrder(array $params): bool {
        $result = $this->orderService->createOrder($params);
        
        if ($result === true) {
            call_user_func($this->successAction);
        }

        return $result;
    }
}

// 使用方式
$originalService = new OrderService();
$decoratedService = new OrderSuccessDecorator($originalService, function() {
    echo "订单创建成功，执行后续逻辑";
});
$decoratedService->createOrder(['id' => 123]);

三、框架生态方案（如果用Laravel/Symfony） #

如果你的项目基于主流框架，可以利用框架自带的扩展能力：

• Laravel：可以使用观察者模式监听模型事件，或者通过AOP扩展实现切面，在方法返回后触发逻辑；也可以自定义命令或任务，结合方法返回值调用。
• Symfony：利用事件分发器，在方法调用后抛出自定义事件，监听事件并根据返回值执行逻辑。

关于PHP反射的说明 #

PHP原生反射API完全具备类似Java反射的能力，你之前找不到合适的库，完全可以自己实现轻量版的注解解析逻辑——就像方案一中的代码，只需要几十行就能满足需求，不需要依赖复杂的第三方库。

内容的提问来源于stack exchange，提问作者Ahmet Deniz GÜNER