PHP8.3中命令接口必须声明返回类型，如execute(): void，否则触发Fatal error；具体命令类推荐属性提升和构造器类型约束；调用者需支持异常隔离执行；宏命令undo()须逆序撤销。
PHP8.3中命令接口必须声明返回类型
PHP8.3默认启用严格类型检查，interface Command 若不显式标注返回类型，会触发 TypeError 或致命错误。比如旧写法 public function execute() 在 PHP8.3+ 中已不合法。
必须补全返回类型，哪怕只是 void；若需支持撤销，undo() 同样要加 void 或对应类型：
interface Command
{
public function execute(): void;
public function undo(): void;
}
- 漏写
: void会导致Fatal error: Uncaught Error: Return type of Command::execute() must be void - 如果命令有返回值（如操作 ID、状态码），应明确写成
: string|int|bool，不能依赖隐式返回 - PHP8.3 不再容忍接口方法签名与实现类不一致——哪怕只是返回类型缺失
具体命令类要用属性提升 + 构造器参数类型约束
PHP8.3 推荐用属性提升（property promotion）简化构造逻辑，同时强制接收者（Receiver）类型安全。例如支付命令绑定订单对象：
class PayCommand implements Command
{
public function __construct(
private Order $order,
private Logger $logger,
) {}
<pre class="brush:php;toolbar:false;">public function execute(): void
{
$this->order->pay();
$this->logger->log('Payment executed');
}
public function undo(): void
{
$this->order->cancelPayment();
$this->logger->log('Payment reverted');
}}
- 省略
private $order声明和手动赋值，靠构造器参数自动提升即可 - 类型提示
Order $order能在实例化时立刻捕获传入非Order对象的错误，而不是等到execute()才报错 - 避免在构造器里做副作用操作（如远程调用、DB 查询），否则
new PayCommand(...)就可能失败，违背“封装请求”的本意
调用者（Invoker）要支持可选批量执行与异常隔离
真实场景中，多个命令串行执行时，一个失败不该中断全部。PHP8.3 可借助 try/catch + array_reduce 或简单循环控制流：
立即学习“PHP免费学习笔记（深入）”；
class CommandInvoker
{
/** @var Command[] */
private array $commands = [];
<pre class="brush:php;toolbar:false;">public function add(Command $command): void
{
$this->commands[] = $command;
}
public function executeAll(): array
{
$results = [];
foreach ($this->commands as $i => $cmd) {
try {
$cmd->execute();
$results[$i] = ['status' => 'ok'];
} catch (Throwable $e) {
$results[$i] = [
'status' => 'error',
'message' => $e->getMessage(),
];
}
}
return $results;
}}
- 返回结构化数组比单纯抛异常更利于上层做补偿或重试决策
- 不要在
executeAll()里吞掉所有异常后静默失败——至少记录日志，否则调试时无从定位哪个命令崩了 - 若需事务语义（全成功/全回滚），得额外维护命令执行顺序和状态快照，PHP8.3 的
WeakMap或ArrayObject可辅助跟踪
宏命令（MacroCommand）在 PHP8.3 需显式类型协变支持
组合多个命令时，常见做法是让宏命令也实现 Command，但 PHP8.3 对子类返回类型更严格。若宏命令的 execute() 内部调用其他命令，需确保它不意外改变父接口契约：
class MacroCommand implements Command
{
/** @var Command[] */
private array $commands;
<pre class="brush:php;toolbar:false;">public function __construct(Command ...$commands)
{
$this->commands = $commands;
}
public function execute(): void
{
foreach ($this->commands as $cmd) {
$cmd->execute();
}
}
public function undo(): void
{
// 注意：逆序撤销！
foreach (array_reverse($this->commands) as $cmd) {
$cmd->undo();
}
}}
- 宏命令本身不是“原子操作”，它的
undo()必须严格逆序，否则状态不一致 - PHP8.3 不允许
MacroCommand::execute()返回非void，哪怕你内部想返回汇总结果——那是业务逻辑，不该污染命令契约 - 若宏命令需动态增删子命令，建议用
ArrayObject替代原生数组，便于监听变更或加锁
实际落地时，最容易被忽略的是命令对象的生命周期管理：它们通常不含状态，但一旦持有了数据库连接、HTTP 客户端或文件句柄，就可能引发资源泄漏或并发冲突。PHP8.3 的 __destruct() 不可靠（GC 时机不确定），更稳妥的方式是在 execute() 内完成资源申请与释放，或交由调用方统一管理上下文。
