需求:為畫布 Canvas 添加「紅色邊框」、「字體 14px」、「陰影」等樣式。傳統做法:
class Canvas {}
class RedCanvas extends Canvas {}
class RedBoldCanvas extends RedCanvas {}
class RedBoldShadowCanvas extends RedBoldCanvas {} // 類爆炸!
每增加一種組合就要新建一個子類,違反「開閉原則」,維護極其困難。
「組合優於繼承」:將核心對象(Component)與裝飾行為(Decorator)分離,運行時動態組合,單一職責、靈活擴展。
| 角色 | PHP 實現 | 職責 |
|---|---|---|
| Component (抽象構件) | 接口/抽象類 DrawDecorator | 定義 beforeDraw()、afterDraw() 鉤子 |
| ConcreteComponent (具體構件) | 類 Canvas | 核心繪製邏輯,持有裝飾器集合 |
| Decorator (抽象裝飾器) | 實現 DrawDecorator 的類 | 持有被裝飾對象引用,轉發調用 |
| ConcreteDecorator (具體裝飾器) | ColorDrawDecorator、SizeDrawDecorator | 實現具體裝飾邏輯(CSS 樣式注入) |
interface DrawDecorator {
public function beforeDraw(): void;
public function afterDraw(): void;
}
class ColorDrawDecorator implements DrawDecorator {
private string $color;
public function __construct(string $color = 'red') { $this->color = $color; }
public function beforeDraw(): void { echo ""; }
public function afterDraw(): void { echo ""; }
}
class SizeDrawDecorator implements DrawDecorator {
private string $size;
public function __construct(string $size = '14px') { $this->size = $size; }
public function beforeDraw(): void { echo ""; }
public function afterDraw(): void { echo ""; }
}
class Canvas {
/** @var DrawDecorator[] */
private array $decorators = [];
public function addDecorator(DrawDecorator $decorator): void {
$this->decorators[] = $decorator;
}
public function draw(int $width = 20, int $height = 10): void {
$this->beforeDraw(); // 1. 正序執行 beforeDraw
for ($i = 0; $i < $height; $i++) {
for ($j = 0; $j < $width; $j++) {
echo '*';
}
echo "
";
}
$this->afterDraw(); // 2. 逆序執行 afterDraw(保證標籤正確嵌套)
}
private function beforeDraw(): void {
foreach ($this->decorators as $decorator) {
$decorator->beforeDraw();
}
}
private function afterDraw(): void {
foreach (array_reverse($this->decorators) as $decorator) {
$decorator->afterDraw();
}
}
}
$canvas = new Canvas();
// 動態組合:先加顏色,再加字體
$canvas->addDecorator(new ColorDrawDecorator('red'));
$canvas->addDecorator(new SizeDrawDecorator('9px'));
$canvas->draw(20, 10);
<div style='color: red;'>
<div style='font-size: 9px;'>
********************<br/>
... (10 行)
</div>
</div>
標籤完美嵌套:外層紅色,內層 9px,符合 CSS 疊加規則。
| 維度 | 繼承方案 | 裝飾器模式 |
|---|---|---|
| 類數量 | 組合數指數增長 | 線性增長(N 個裝飾器類) |
| 靈活性 | 編譯時靜態綁定 | 運行時動態組合 |
| 單一職責 | 違反(樣式邏輯分散在各子類) | 滿足(每個裝飾器只做一件事) |
| 開閉原則 | 違反(新增組合需改代碼/加類) | 滿足(新增裝飾器不修改核心) |
| 疊加順序控制 | 極難 | 自然支援(調整 addDecorator 順序) |
$next($request) 為核心調用)。FileLogger → TimestampDecorator → LevelFilterDecorator → RemoteSenderDecorator。RedisCache → LocalMemoryCacheDecorator → NullCacheDecorator。GzipStream → EncryptStream → FileStream(PHP 內建 stream_filter_append 即此模式)。#[\Attribute]
class Decorate {
public function __construct(public string $class) {}
}
#[Decorate(ColorDrawDecorator::class)]
#[Decorate(SizeDrawDecorator::class)]
class Canvas {
// 編譯時/運行時自動應用裝飾器(需框架/編譯器支援)
}
裝飾器模式以 「接口統一、組合替代繼承、運行時動態疊加」 解決行為組合爆炸問題。關鍵實現細節:
Decorator[] 集合beforeDraw() 正序調用,afterDraw() 逆序調用(保證標籤/邏輯正確嵌套)addDecorator(),零侵入核心代碼下次面對「給這個類加個日誌/緩存/權限/統計」時,請優先想到裝飾器,而非繼承。