裝飾者模式:不修改原類、不使用繼承動態擴展功能
裝飾者模式是結構型設計模式的經典代表,通過組合而非繼承實現功能動態疊加。本文通過完整代碼示例展示如何在 PHP 中實現裝飾者模式,解決繼承導致的類爆炸問題。
模式角色定義
| 角色 | 說明 | 代碼映射 |
| Component | 抽象組件接口,定義核心操作 | interface Component |
| ConcreteComponent | 具體組件,被裝飾的原始對象 | class ConcreteComponent |
| Decorator | 抽象裝飾者,持有 Component 引用 | abstract class Decorator |
| ConcreteDecorator | 具體裝飾者,添加具體功能 | class ConcreteDecoratorA/B |
完整代碼實現
<?php
// 1. 抽象組件接口
interface Component {
public function operation();
}
// 2. 具體組件
class ConcreteComponent implements Component {
public function operation() {
echo 'do operation' . PHP_EOL;
}
}
// 3. 抽象裝飾者
abstract class Decorator implements Component {
protected $component;
public function __construct(Component $component) {
$this->component = $component;
}
// 默認委託給被裝飾對象
public function operation() {
$this->component->operation();
}
}
// 4. 具體裝飾者 A:添加操作 A
class ConcreteDecoratorA extends Decorator {
public function operation() {
parent::operation(); // 執行原有操作
$this->addedOperationA(); // 新增功能
}
private function addedOperationA() {
echo 'Add Operation A' . PHP_EOL;
}
}
// 5. 具體裝飾者 B:添加操作 B
class ConcreteDecoratorB extends Decorator {
public function operation() {
parent::operation();
$this->addedOperationB();
}
private function addedOperationB() {
echo 'Add Operation B' . PHP_EOL;
}
}
// 6. 客戶端使用
class Client {
public static function main() {
// 單層裝飾
$decoratorA = new ConcreteDecoratorA(new ConcreteComponent());
$decoratorA->operation();
/* 輸出:
do operation
Add Operation A
*/
// 多層裝飾鏈(洋蔥模型)
$decoratorB = new ConcreteDecoratorB($decoratorA);
$decoratorB->operation();
/* 輸出:
do operation
Add Operation A
Add Operation B
*/
}
}
Client::main();
?>
裝飾者 vs 繼承對比
| 維度 | 繼承 | 裝飾者模式 |
| 靈活性 | 靜態、編譯時確定 | 動態、運行時組合 |
| 類數量 | 指數級增長 (M×N) | 線性增長 (M+N) |
| 功能組合 | 單一繼承鏈 | 任意組合排列 |
| 單一職責 | 違反(父類承擔過多) | 符合(每個裝飾者單一功能) |
| 開閉原則 | 修改原類擴展 | 新增裝飾類擴展 |
PHP 實戰應用場景
- 流處理管道:
GzipDecorator、EncryptionDecorator、LoggingDecorator 組合處理數據流
- HTTP 中間件:認證、限流、日誌、CORS 等中間件鏈
- 實體擴展:為商品添加促銷標籤、會員價、庫存狀態等動態屬性
- 日誌記錄器:文件日誌、數據庫日誌、遠程日誌、格式化器鏈式組合
現代 PHP 改進:使用 Traits 簡化
<?php
trait DecoratorTrait {
protected $component;
public function __construct(Component $component) { $this->component = $component; }
public function operation() { $this->component->operation(); }
}
class LoggingDecorator implements Component {
use DecoratorTrait;
public function operation() {
parent::operation();
error_log('Operation executed');
}
}
?>
注意事項
- 裝飾者必須實現與被裝飾對象相同的接口
- 避免過度設計:簡單功能擴展直接修改類或使用繼承即可
- 裝飾鏈順序影響最終行為(如:加密後壓縮 vs 壓縮後加密)
- PHP 8.0+ 可使用
readonly 屬性確保不可變性