萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> PHP 程式設計

PHP 設計模式:裝飾器模式實戰——動態組合行為,告別繼承爆炸

痛點:繼承帶來的剛性

需求:為畫布 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 樣式注入)

完整代碼實現

1. 裝飾器接口

interface DrawDecorator {
    public function beforeDraw(): void;
    public function afterDraw(): void;
}

2. 具體裝飾器:顏色、字體大小

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 "
"; } }

3. 核心構件:畫布

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(); } } }

4. 客戶端使用

$canvas = new Canvas();
// 動態組合:先加顏色,再加字體
$canvas->addDecorator(new ColorDrawDecorator('red'));
$canvas->addDecorator(new SizeDrawDecorator('9px'));

$canvas->draw(20, 10);

輸出 HTML 結構

<div style='color: red;'>
  <div style='font-size: 9px;'>
    ********************<br/>
    ... (10 行)
  </div>
</div>

標籤完美嵌套:外層紅色,內層 9px,符合 CSS 疊加規則。

對比:繼承 vs 裝飾器

維度繼承方案裝飾器模式
類數量組合數指數增長線性增長(N 個裝飾器類)
靈活性編譯時靜態綁定運行時動態組合
單一職責違反(樣式邏輯分散在各子類)滿足(每個裝飾器只做一件事)
開閉原則違反(新增組合需改代碼/加類)滿足(新增裝飾器不修改核心)
疊加順序控制極難自然支援(調整 addDecorator 順序)

實戰應用場景

  1. HTTP 中間件管道:Laravel Middleware、PSR-15 Request Handler 皆為裝飾器模式($next($request) 為核心調用)。
  2. 日誌記錄器:FileLogger → TimestampDecorator → LevelFilterDecorator → RemoteSenderDecorator。
  3. 緩存層疊:RedisCache → LocalMemoryCacheDecorator → NullCacheDecorator。
  4. 流處理:GzipStream → EncryptStream → FileStream(PHP 內建 stream_filter_append 即此模式)。

PHP 8.1+ 新寫法:屬性鉤子簡化裝飾

#[\Attribute]
class Decorate {
    public function __construct(public string $class) {}
}

#[Decorate(ColorDrawDecorator::class)]
#[Decorate(SizeDrawDecorator::class)]
class Canvas {
    // 編譯時/運行時自動應用裝飾器(需框架/編譯器支援)
}

總結

裝飾器模式以 「接口統一、組合替代繼承、運行時動態疊加」 解決行為組合爆炸問題。關鍵實現細節:

  • 核心類持有 Decorator[] 集合
  • beforeDraw() 正序調用,afterDraw() 逆序調用(保證標籤/邏輯正確嵌套)
  • 客戶端按需 addDecorator(),零侵入核心代碼

下次面對「給這個類加個日誌/緩存/權限/統計」時,請優先想到裝飾器,而非繼承。

copyright © 萬盛學電腦網 all rights reserved