PHP中无原生装饰器语法，应使用__call魔术方法结合对象组合实现动态行为扩展；需通过构造函数注入被包装对象，避免属性重写与无限递归，并注意__call仅拦截非public方法调用。
PHP 里没有原生装饰器语法，__call 和组合才是正解
PHP 不支持 Python 那种 @decorator 语法，也不像 TypeScript 有实验性装饰器提案。想动态扩展对象行为，得靠手动组合 + 魔术方法。核心思路是：让一个类“包裹”另一个类，把调用转发过去，再在前后加逻辑。
常见错误是硬套 Java 的 Decorator 抽象类写法，结果每个新功能都要写一堆继承类，反而更僵硬。PHP 更适合用“对象包装 + 方法代理”来实现轻量级扩展。
- 必须实现
__call方法来拦截未知方法调用，否则扩展后对象直接报Fatal error: Uncaught Error: Call to undefined method - 被包装对象（
$this->wrapped）应通过构造函数注入，避免硬编码或全局依赖 - 不要在装饰器里重写被包装对象的 public 属性——PHP 对象属性不走
__get/__set，会绕过装饰逻辑
用 __call 实现日志装饰器的最小可行示例
比如给一个 PaymentService 加上自动日志记录，又不想改它源码。装饰器只关心“调用前记开始、调用后记结果”，不碰业务逻辑。
class LoggingDecorator
{
private $wrapped;
public function __construct($wrapped)
{
$this->wrapped = $wrapped;
}
public function __call($name, $arguments)
{
error_log("Calling {$name} with " . json_encode($arguments));
$result = $this->wrapped->{$name}(...$arguments);
error_log("{$name} returned " . json_encode($result));
return $result;
}
}
// 使用
$service = new PaymentService();
$loggedService = new LoggingDecorator($service);
$loggedService->process(123, 'USD'); // 自动触发日志
注意：__call 只捕获非 public 方法调用。如果 PaymentService 有 public 方法但你忘了声明，PHP 不会进 __call，装饰逻辑就失效了。
立即学习“PHP免费学习笔记（深入）”；
- 确保被装饰类没有同名 public 方法，否则会被优先调用，跳过装饰器
-
...$arguments是必须的，PHP 7.4+ 才支持展开数组参数，旧版本要用call_user_func_array - 别在
__call里做耗时操作（比如远程日志），会影响所有被装饰方法的响应时间
多个装饰器叠加时，顺序决定执行流
装饰器本质是链式包装：new AuthDecorator(new LoggingDecorator(new PaymentService()))。最外层的先收到调用，最后返回结果。这和中间件很像，但 PHP 没有自动链式机制，全靠你手写嵌套。
典型陷阱是搞反顺序。比如想“先鉴权、再记日志”，却写成 new LoggingDecorator(new AuthDecorator(...))，结果日志里连失败的鉴权请求都记了，还可能暴露敏感信息。
- 调试时可临时在每个
__call开头加echo "[Logging]..."，看输出顺序确认是否符合预期 - 避免无限递归：装饰器 A 包裹 B，B 又试图调用 A 的某个方法（比如通过
$this），容易触发循环__call - 性能敏感场景慎用多层装饰：每次方法调用都多一层函数栈 +
__call判断，比直接调用慢 10%~20%
替代方案：Trait 能解决一部分问题，但不是装饰器
有人用 Trait 注入方法，比如 use Loggable;。这确实能复用逻辑，但它是在编译期混入，不是运行时动态包装。对象一旦实例化，Trait 就固定了，没法像装饰器那样按需开关。
比如你只想对某次支付请求开日志，其他时候关闭——Trait 做不到，必须靠装饰器实例的创建/销毁来控制生命周期。
-
Trait适合“这个类天生就该有这些能力”，装饰器适合“这次调用我临时需要加点东西” - 别把
Trait当装饰器用：它不能拦截方法调用，也不能修改已有方法行为（除非用insteadof冲突解决，但太重） - 如果项目已大量用
Trait，突然切装饰器，要注意方法命名冲突——比如两个装饰器都定义了log()，而被包装对象也有同名方法
__call，看不出原始调用点在哪。建议在关键位置加 debug_print_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS, 2) 快速定位。 
