Yii2 ActiveForm复选框值反转求助：勾选存0，未勾选存1

要实现勾选复选框时数据库存0，未勾选时存1，核心是处理复选框提交的值及回显逻辑，以下是两种可行方案：

方案一：表单字段直接配置 #

Yii2的checkbox方法支持通过value和uncheck参数自定义勾选/未勾选时提交的值，同时调整回显判断逻辑即可：

<?= $form->field($model, 'agent_email_verification')->checkbox([
    'value' => 0,        // 勾选时提交到后端的值
    'uncheck' => 1,      // 未勾选时提交到后端的值
    'checked' => $model->agent_email_verification == 0 // 从数据库取值时，判断是否勾选
]) ?>

这样配置后，表单提交时：

• 勾选状态：提交agent_email_verification=0，直接存入数据库
• 未勾选状态：提交agent_email_verification=1，直接存入数据库

方案二：模型beforeSave统一处理 #

如果需要对多个字段做类似反转，或不想修改表单代码，可以在模型的beforeSave方法中处理值的反转，同时调整回显逻辑：

1. 模型添加beforeSave方法 #

public function beforeSave($insert)
{
    if (parent::beforeSave($insert)) {
        // 反转字段值：原勾选传1→存0，未勾选不传值→模型默认0→存1
        $this->agent_email_verification = $this->agent_email_verification ? 0 : 1;
        return true;
    }
    return false;
}

2. 表单回显调整 #

因为数据库中0代表已勾选，所以回显时要判断字段值是否为0：

<?= $form->field($model, 'agent_email_verification')->checkbox([
    'checked' => $model->agent_email_verification == 0
]) ?>

原代码问题说明 #

你之前的尝试未生效，是因为没有设置uncheck参数——Yii2默认情况下，未勾选的复选框不会提交该字段，模型会使用字段的默认值（通常是0），导致未勾选时存0、勾选时存1，和预期相反。设置uncheck后，未勾选时会主动提交指定的值，才能实现反转逻辑。

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