將請求封裝為對象,從而用不同請求參數化客戶;支持請求排隊、日誌記錄、可撤銷操作。
—— 《設計模式》GoF
execute()、undo()。execute() 調用 Receiver 動作,undo() 反向操作。execute(),可管理歷史棧支持撤銷/重做。<?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 角色 | Receiver | Invoker | 價值 |
|---|---|---|---|---|
| GUI 菜單/工具欄按鈕 | OpenCommand, SaveCommand | Document | MenuItem | 解耦 UI 與業務,支持插件擴展 |
| 任務隊列/異步處理 | SendEmailCommand, GenerateReportCommand | EmailService, ReportService | QueueWorker | 命令序列化入隊,Worker 反序列化執行,支持重試、延遲、優先級 |
| 資料庫遷移 | CreateTableCommand, AddIndexCommand | SchemaBuilder | Migrator | 支持 up/down (undo),版本控制、回滾 |
| 編輯器撤銷/重做 | InsertTextCommand, DeleteTextCommand | TextBuffer | Editor | 每次操作生成命令入棧,Ctrl+Z 彈棧 undo |
| 事務腳本 | TransferMoneyCommand | AccountService | TransactionRunner | 封裝業務邏輯,支持補償事務 (Saga 模式) |
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); // 同步執行