CakePHP 4 多选表单如何完全禁用自动预选中功能

你遇到的问题是CakePHP 4的FormHelper默认预填充优先级高于手动传入的value参数导致的，预填充优先级为：请求提交的数据 > 表单上下文绑定的实体数据 > 手动设置的value值，所以之前的修改不生效。可通过以下两种方式解决：

方案1：单个控件禁用自动预填充 #

在控件配置中添加requestAware => false参数，同时将多选空值改为空数组[]（多选值为数组类型，传false会导致类型不匹配识别失效），修改后的代码如下：

<?= $this->Form->control('estimate_options.0.option_value', [
    'type' => 'select',
    'multiple' => 'checkbox',
    'options' => $deliverables,
    'label' => false,
    'value' => !empty($selectedDeliverables->option_value) ? $selectedDeliverables->option_value : [],
    'requestAware' => false, // 禁用从请求读取填充值，强制使用手动传入的value
]);
?>

方案2：整页表单禁用预填充 #

如果当前步骤的所有表单项都不需要继承之前的提交数据，可以直接在控制器对应方法中清空请求的提交数据，渲染页面前执行以下代码：

// 清空当前请求的解析数据，FormHelper不会再读取到之前的提交值
$this->setRequest($this->request->withParsedBody([]));
// 可选：清空Session中存储的表单验证错误数据，避免残留影响
$this->getRequest()->getSession()->delete('Form.errors');

内容的提问来源于stack exchange，提问作者tjb74