PHP读取数据库值渲染带选中状态复选框问题排查

算力阿峰

2026-8-30

问题背景

原静态尺寸选择复选框表单代码如下，基于Bootstrap框架实现：

<div class="form-check col-lg-6 offset-4 mt-3">
        Size:
        <div class="form-check-inline">
            <label class="form-check-label">
                <input type="checkbox" class="form-check-input" value="XS" name="size[]">XS
            </label>
        </div>
        <div class="form-check-inline">
            <label class="form-check-label">
                <input type="checkbox" class="form-check-input" value="S" name="size[]">S
            </label>
        </div>
        <div class="form-check-inline">
            <label class="form-check-label">
                <input type="checkbox" class="form-check-input" value="M" name="size[]">M
            </label>
        </div>
        <div class="form-check-inline">
            <label class="form-check-label">
                <input type="checkbox" class="form-check-input" value="L" name="size[]">L
            </label>
        </div>
        <div class="form-check-inline">
            <label class="form-check-label">
                <input type="checkbox" class="form-check-input" value="XL" name="size[]">XL
            </label>
        </div>
        
    </div>

实现需求：此前已通过implode()函数将用户选中的复选框值以逗号拼接的格式存入数据库，现在需要从数据库中读取已存储的复选框值，在渲染复选框列表时自动将对应选项设置为选中状态。

问题现象

运行如下PHP回显逻辑代码时，页面仅能显示尺寸对应的文本值，复选框控件本身无法正常渲染展示：

<?php
$check_arr=array();
$size = mysqli_query($con,"SELECT * FROM store");
if(mysqli_num_rows($size) > 0){
    $result = mysqli_fetch_assoc($size);
    $check_arr = explode(",",$result['size']);
}
$size_arr = array("XS","S","M","L","XL");
foreach($size_arr as $sizes){

    $checked = "";
    if(in_array($sizes,$check_arr)){
        $checked = "checked";
    }
    echo '<input type="checkbox" class="form-check-input" name="size[]" value="'.$sizes.'" '.$checked.' > '.$sizes.' <br/>';
}
?>

问题原因

核心问题有两个：

边界场景未做兼容：当数据库查询失败、size字段为NULL或空字符串时，explode()返回值不是标准数组，后续调用in_array()会抛出PHP警告。如果服务器开启了错误直接输出的配置，警告内容会插入到input标签内部，导致浏览器解析标签失败，无法渲染复选框控件，只显示标签外的尺寸文本。
代码完全丢弃了原有的Bootstrap表单DOM结构，即使复选框渲染成功，样式、排版也和原静态表单效果不一致。

修复方案

初始化时强制$check_arr为空数组，查询到尺寸值后先做非空判断再执行explode，拆分后对每个元素做trim处理，兼容存储时逗号后带空格的情况
保留原Bootstrap表单的DOM结构，保证样式符合预期
采用HTML和PHP混写的方式渲染属性，避免字符串拼接时多余空格、转义问题导致标签解析异常

修复后的完整可运行代码如下：

<div class="form-check col-lg-6 offset-4 mt-3">
    Size:
    <?php
    // 初始化选中数组，保证变量始终是数组类型
    $check_arr = [];
    $size_query = mysqli_query($con, "SELECT size FROM store LIMIT 1");
    if($size_query && mysqli_num_rows($size_query) > 0){
        $result = mysqli_fetch_assoc($size_query);
        // 只有size字段非空时才做拆分
        if(!empty($result['size'])){
            // 拆分后对每个值去除前后空格，兼容"XS, S, M"这类带空格的存储格式
            $check_arr = array_map('trim', explode(",", $result['size']));
        }
    }
    $size_arr = ["XS","S","M","L","XL"];
    foreach($size_arr as $s){
        $checked = in_array($s, $check_arr) ? 'checked' : '';
    ?>
    <div class="form-check-inline">
        <label class="form-check-label">
            <input type="checkbox" class="form-check-input" name="size[]" value="<?php echo $s; ?>" <?php echo $checked; ?>>
            <?php echo $s; ?>
        </label>
    </div>
    <?php } ?>
</div>

生产环境建议给mysqli查询增加错误处理逻辑，避免SQL执行失败时抛出异常打断页面渲染。

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