PHP 8.0 不支持原生装饰器语法，所谓“装饰器”是通过接口+组合手动实现的设计模式；必须定义统一接口，装饰器类实现该接口并持有一个接口类型依赖，调用时显式委托并增强逻辑。
PHP 8.0 本身不支持装饰器语法
PHP 8.0 没有像 Python 的 @decorator 或 TypeScript 的 @Decorator 那样的原生装饰器语法。所谓“PHP 装饰器模式”，实际是手动实现的 设计模式，不是语言特性。直接写 @Cacheable 或 @LogExecution 会报 ParseError: Syntax error。
用组合 + 接口模拟装饰器行为
核心思路：让装饰器类实现与目标对象相同的接口，并持有一个被装饰对象的引用，在方法调用前后插入逻辑。
常见错误是忽略接口一致性，导致类型无法替代（比如传入 UserService 的地方不能安全传入 LoggingUserService）。
- 必须先定义统一接口（如
UserRepositoryInterface），所有具体类和装饰器都实现它 - 装饰器构造函数接收一个该接口类型的实例，而不是具体类（避免耦合）
- 每个方法里显式调用
$this->decorated->methodName()，再包裹额外逻辑 - PHP 8.0 可利用联合类型和返回类型声明增强可靠性，例如：
public function find(int $id): ?User
示例片段：
立即学习“PHP免费学习笔记（深入）”；
interface UserRepositoryInterface
{
public function find(int $id): ?User;
}
<p>class DatabaseUserRepository implements UserRepositoryInterface { /<em> ... </em>/ }</p><div class="aritcle_card flexRow">
<div class="artcardd flexRow">
<a class="aritcle_card_img" href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站"><img
src="https://img.php.cn/upload/skill/000/000/081/179040786932301.jpg" alt="btpanel phpsite 宝塔面板PHP网站" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站">btpanel phpsite 宝塔面板PHP网站</a>
<p>宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理</p>
</div>
<a href="/xiazai/skill5233" title="btpanel phpsite 宝塔面板PHP网站" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span> </a>
</div>
</div><p>class LoggingUserRepository implements UserRepositoryInterface
{
public function __construct(private UserRepositoryInterface $decorated) {}</p><pre class="brush:php;toolbar:false;">public function find(int $id): ?User
{
error_log("Finding user {$id}");
$result = $this->decorated->find($id);
error_log("Found: " . ($result ? 'yes' : 'no'));
return $result;
}}
用 PHP 8.0 新特性简化装饰器链
多个装饰器叠加（如日志 + 缓存 + 权限）时，手动嵌套易出错（new PermissionDecorator(new CacheDecorator(new LogDecorator($repo)))）。PHP 8.0 的命名参数和构造函数属性提升可让组装更清晰。
- 用命名参数明确意图：
new LoggingUserRepository(decorated: $repo) - 构造函数属性提升减少样板代码，但注意
private UserRepositoryInterface $decorated是只读的，不可在方法中重新赋值 - 避免在装饰器中做耗时操作（如文件 I/O、远程请求），否则会拖慢整个调用链
- 缓存装饰器需谨慎处理参数序列化——PHP 8.0 的
var_export()或serialize()对闭包、资源句柄会失败
别把 __invoke 当装饰器用
有人误以为给类加 __invoke() 就算实现了装饰器，这是混淆概念。PHP 的 __invoke 只是让对象可调用，不解决“透明扩展行为”问题。
典型错误场景：
- 写了个
class CacheDecorator { public function __invoke(callable $fn) { ... } }，然后试图$cached = (new CacheDecorator())($originalFn)—— 这本质是高阶函数，不是装饰器模式 - 丢失了接口契约，无法被依赖注入容器自动替换原始服务
- 无法对类的多个方法分别控制（比如只缓存
find()，不缓存save()）
真要动态包装，PHP 8.0 更推荐用 ProxyManager 库生成运行时代理，而非手写 __invoke。
装饰器模式的关键不在“语法糖”，而在「接口一致」和「组合优先」。PHP 8.0 没有装饰器语法，但它的类型系统和构造函数改进，反而让手写装饰器更健壮、更难出错——前提是别跳过接口定义这一步。
