CakePHP3.10 名称含_id的表单字段自动生成select框问题排查

一、是否为自定义逻辑及排查方法 #

这个渲染规则默认不是前代开发者自定义实现，属于CakePHP 3.x版本的原生默认行为。如果要确认项目内是否存在自定义覆盖的逻辑，按以下路径排查即可：

• 检查src/View/Helper/目录下是否存在继承了原生FormHelper的自定义助手类，查看类中是否重写了control()、_inputType()等和字段类型推断、控件渲染相关的方法；同时确认对应控制器/视图的$helpers配置是否替换了默认的Form助手。
• 检查对应模型层逻辑：查看src/Model/Table/BuildingsTable.php中是否定义了和test_id相关的belongsTo关联，以及src/Model/Entity/Building.php中是否给test_id字段配置了特殊的类型映射。
• 检查全局或视图层的Form助手配置：确认config/app.php、config/bootstrap.php中是否有针对Form助手的全局类型规则修改，以及视图内是否通过setConfig()、setTemplates()方法修改过字段渲染规则。

二、原生特性相关说明 #

这个是CakePHP 3.x Form助手的内置逻辑：调用control()方法时如果没有手动传入type参数指定控件类型，助手会自动根据字段名后缀、数据表字段类型、模型关联关系推断要渲染的控件类型：

• 当字段名以_id结尾时，框架默认判定该字段是关联模型的外键，会优先渲染为select下拉选择框。如果框架没有找到对应关联的可选选项列表，就会渲染为空的下拉框，就是你遇到的情况。
• 对应规则的实现逻辑可以直接查看框架源码：vendor/cakephp/cakephp/src/View/Helper/FormHelper.php中的_inputType()方法，相关说明在CakePHP 3.x官方文档的Form助手章节的「字段类型自动检测」部分。
• 如果需要修改这个默认行为，只要在调用control()时手动指定type参数即可，比如要渲染为普通文本输入框写法如下：

echo $this->Form->control('test_id', ['type' => 'text']);

本次问询关联的参考代码 #

控制器代码

public function add()
{
    $building = $this->Buildings->newEntity();
    if ($this->request->is('post')) {
        // 表单提交后的处理逻辑
    }

    $this->set(compact('building'));
}

视图代码

<div>        
    <?= $this->Form->create($building) ?>
    <fieldset>
        <legend><?= __('Add Building') ?></legend>
        <?php
            echo $this->Form->control('test_id'); <!-- 该字段默认会被渲染为select下拉框 -->               
            echo $this->Form->control('name');
        ?>
    </fieldset>
    <?= $this->Form->button(__('Submit')) ?>
    <?= $this->Form->end() ?>
</div>

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