本技能用于在 PrestaShop 中按照 CQRS 模式创建批量操作命令及其处理器,相关约定(AbstractBulkCommandHandler、BulkCommandExceptionInterface、失败后继续)参见 CQRS/CONTEXT.md。
一、用途 创建批量动作命令(Bulk Action Command)及其处理器,使实体支持批量删除与批量切换状态等操作。
二、主要能力
-
批量删除命令 在 src/Core/Domain/{Domain}/Command/BulkDelete{Domain}sCommand.php 中创建。构造函数接收 array $ids(scalar int[]);提供单一 getter:getIds(): array。
-
批量状态命令 在 src/Core/Domain/{Domain}/Command/BulkToggle{Domain}StatusCommand.php 中创建。构造函数接收 array $ids(int[])与 bool $expectedStatus;$expectedStatus = true 表示启用,false 表示禁用。Getters:getIds(): array 与 getExpectedStatus(): bool。
-
批量处理器 所有批量处理器结构一致,创建于 src/Adapter/{Domain}/CommandHandler/。批量删除处理器 BulkDelete{Domain}sHandler.php:对每个 ID 调用仓储的删除方法,收集失败项并继续处理剩余 ID。批量状态处理器 BulkToggle{Domain}StatusHandler.php:对每个 ID 加载实体,设置 active = $command->getExpectedStatus() 后更新;需使用命令中的目标状态,不要翻转当前值。
-
处理器接口 创建于 src/Core/Domain/{Domain}/CommandHandler/,包括 BulkDelete{Domain}sHandlerInterface 与 BulkToggle{Domain}StatusHandlerInterface,两者均返回 void。批量异常通过抛出而非返回方式传播。
三、使用方式 依据上述路径与命名规则创建命令类、处理器类与接口,处理器需继承 AbstractBulkCommandHandler 并遵循失败后继续的约定。
四、适用场景 为具有批量网格操作(bulk grid actions)的实体添加批量删除或批量状态切换能力。
五、限制 若实体没有批量网格操作,应完全跳过该技能。需与单实体命令在 ID 类型上保持一致。具体搜索关键字、标签及分类暂未提供。