萬盛學電腦網

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

PHP 設計模式實戰:命令模式封裝請求、支持撤銷與隊列

模式定義

將請求封裝為對象,從而用不同請求參數化客戶;支持請求排隊、日誌記錄、可撤銷操作。
—— 《設計模式》GoF

角色結構

  1. Command (命令接口): 聲明 execute()、undo()。
  2. ConcreteCommand (具體命令): 綁定 Receiver + 參數,實現 execute() 調用 Receiver 動作,undo() 反向操作。
  3. Receiver (接收者): 執行具體業務邏輯的對象。
  4. Invoker (調用者/請求者): 持有命令對象,觸發 execute(),可管理歷史棧支持撤銷/重做。
  5. Client (客戶端): 創建命令、設置接收者、裝配調用者。

核心代碼實現

<?php
// 1. 命令接口
interface Command {
    public function execute(): void;
    public function undo(): void;
}

// 2. 接收者:具體業務邏輯
class Light {
    private bool $on = false;
    public function turnOn(): void {
        $this->on = true;
        echo "燈已開啟\n";
    }
    public function turnOff(): void {
        $this->on = false;
        echo "燈已關閉\n";
    }
    public function isOn(): bool { return $this->on; }
}

// 3. 具體命令:開燈
class LightOnCommand implements Command {
    private Light $light;
    public function __construct(Light $light) { $this->light = $light; }
    public function execute(): void { $this->light->turnOn(); }
    public function undo(): void { $this->light->turnOff(); }
}

// 4. 具體命令:關燈
class LightOffCommand implements Command {
    private Light $light;
    public function __construct(Light $light) { $this->light = $light; }
    public function execute(): void { $this->light->turnOff(); }
    public function undo(): void { $this->light->turnOn(); }
}

// 5. 調用者:持有命令、支持撤銷棧
class RemoteControl {
    private ?Command $command = null;
    private array $history = []; // 命令歷史棧
    
    public function setCommand(Command $command): void {
        $this->command = $command;
    }
    
    public function pressButton(): void {
        if ($this->command) {
            $this->command->execute();
            $this->history[] = $this->command; // 記錄歷史
        }
    }
    
    public function pressUndo(): void {
        $cmd = array_pop($this->history);
        if ($cmd) {
            echo "執行撤銷: ";
            $cmd->undo();
        } else {
            echo "無可撤銷操作\n";
        }
    }
}

// 6. 客戶端裝配
$light = new Light();
$remote = new RemoteControl();

$remote->setCommand(new LightOnCommand($light));
$remote->pressButton();  // 燈已開啟

$remote->setCommand(new LightOffCommand($light));
$remote->pressButton();  // 燈已關閉

$remote->pressUndo();    // 執行撤銷: 燈已開啟
$remote->pressUndo();    // 執行撤銷: 燈已關閉

進階:宏命令(組合多個命令)

class MacroCommand implements Command {
    private array $commands = [];
    
    public function add(Command $cmd): void {
        $this->commands[] = $cmd;
    }
    
    public function execute(): void {
        foreach ($this->commands as $cmd) {
            $cmd->execute();
        }
    }
    
    public function undo(): void {
        // 逆序撤銷
        foreach (array_reverse($this->commands) as $cmd) {
            $cmd->undo();
        }
    }
}

// 使用:一鍵開啟派對模式
$party = new MacroCommand();
$party->add(new LightOnCommand($light));
$party->add(new MusicOnCommand($music));
$party->add(new AcOnCommand($ac));

$remote->setCommand($party);
$remote->pressButton(); // 依次執行所有
$remote->pressUndo();   // 逆序撤銷所有

實際應用場景

場景Command 角色ReceiverInvoker價值
GUI 菜單/工具欄按鈕OpenCommand, SaveCommandDocumentMenuItem解耦 UI 與業務,支持插件擴展
任務隊列/異步處理SendEmailCommand, GenerateReportCommandEmailService, ReportServiceQueueWorker命令序列化入隊,Worker 反序列化執行,支持重試、延遲、優先級
資料庫遷移CreateTableCommand, AddIndexCommandSchemaBuilderMigrator支持 up/down (undo),版本控制、回滾
編輯器撤銷/重做InsertTextCommand, DeleteTextCommandTextBufferEditor每次操作生成命令入棧,Ctrl+Z 彈棧 undo
事務腳本TransferMoneyCommandAccountServiceTransactionRunner封裝業務邏輯,支持補償事務 (Saga 模式)

Laravel 框架中的命令模式

Laravel Command (Artisan 命令) / Job (隊列任務) 即是命令模式的現代實踐:

// app/Jobs/SendWelcomeEmail.php
class SendWelcomeEmail implements ShouldQueue {
    use Dispatchable, InteractsWithQueue, Queueable, SerializesModels;
    
    public function __construct(public User $user) {}
    
    public function handle(): void {
        Mail::to($this->user->email)->send(new WelcomeMail($this->user));
    }
}

// 控制器中分發(Invoker)
SendWelcomeEmail::dispatch($user); // 異步入隊
SendWelcomeEmail::dispatchSync($user); // 同步執行

優缺點總結

  • ✅ 解耦調用者與接收者
  • ✅ 易於添加新命令,符合開閉原則
  • ✅ 支持撤銷、重做、隊列、日誌、事務
  • ✅ 可組合宏命令
  • ❌ 類數量膨脹(每個動作一個類)
  • ❌ 簡單場景過度設計,增加複雜度
copyright © 萬盛學電腦網 all rights reserved