如何在CakePHP 4中自定义多选复选框（Checkbox）

期望生成的HTML结构：

<div class="custom-control custom-control-primary custom-checkbox"> 
    <input type="checkbox" class="custom-control-input" id="colorCheck1" checked=""> 
    <label class="custom-control-label" for="colorCheck1">Primary</label> 
</div>

尝试的代码：

<?php 
$list = ['1'=>'Select 1','2'=>'Select 2']; /*Array of list */

echo $this->Form->select('profile_ids', $list, [ 
    'multiple' => 'checkbox',
    'class'=>'custom-control-input', 
    'label' => [
        'class' => 'custom-control-label'
    ], 
    'templates' => [
        'inputContainer' => '<div class="custom-control custom-control-primary custom-checkbox">{{content}}</div>'
    ] 
]);
?>

实际生成的不符合预期的HTML：

<div class="checkbox">
    <label class="custom-control-label" for="profile-ids-13">
        <input type="checkbox" name="profile_ids[]" value="13" id="profile-ids-13" class="custom-control-input" templates="<div class=&quot;custom-control custom-control-primary custom-checkbox&quot;>{{content}}</div>">default
    </label>
</div>

问题出在CakePHP FormHelper的模板优先级和默认结构上，调整以下几个模板参数即可解决：

1. 替换inputContainerCheckbox模板：使用multiple="checkbox"时，每个复选框的父容器用的是inputContainerCheckbox而非通用的inputContainer，需要覆盖这个模板来添加指定类。
2. 修改checkboxWrapper结构：默认逻辑会把input包裹在label内部，需要调整为input和label同级的结构。
3. 自定义label模板：确保label的class和关联的for属性正确生成。

调整后的代码：

<?php 
$list = ['1'=>'Select 1','2'=>'Select 2']; /*Array of list */

echo $this->Form->select('profile_ids', $list, [ 
    'multiple' => 'checkbox',
    'class' => 'custom-control-input', 
    'templates' => [
        'inputContainerCheckbox' => '<div class="custom-control custom-control-primary custom-checkbox">{{content}}</div>',
        'checkboxWrapper' => '{{input}}{{label}}',
        'label' => '<label class="custom-control-label" for="{{for}}">{{text}}</label>'
    ] 
]);
?>

如果是CakePHP 3.x早期版本，可能需要额外添加'label' => false来关闭自动包裹逻辑，上述代码在多数3.x/4.x版本中可直接生效。

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