CodeIgniter 4中如何向$model->errors()数组追加自定义错误

一、正确追加错误的两种方法 #

方法1：直接操作Model的错误容器（最稳妥） #

别把错误存到临时变量里折腾，直接往Model的错误集合里加新错误，原有错误不会丢失：

if( !$model->insert($data) ) {
    // 检查特定条件
    if($this->request->getPost('hobby') == 'Reading novel' && $this->request->getPost('book_genre') == '') {
        // 不同框架的添加方法可能叫addError/setError，比如CodeIgniter就是addError
        $model->addError('book_genre', 'Book genre must be filled.');
    }
    
    // 再获取完整的错误列表
    $errors = $model->errors();
    
    $response = [
        'success' => false,
        'msg' => '<p>' . implode('</p><p>', $errors) . '</p>'
    ];
}

方法2：手动处理数组形式的错误 #

如果你的框架errors()返回的是数组，要注意别覆盖已有字段的错误：

$errors = $model->errors();

if($this->request->getPost('hobby') == 'Reading novel' && $this->request->getPost('book_genre') == '') {
    // 如果book_genre已经有错误，就追加；没有则新增
    if(isset($errors['book_genre'])) {
        // 有些框架里每个字段的错误是数组形式（支持多个错误）
        if(is_array($errors['book_genre'])) {
            $errors['book_genre'][] = 'Book genre must be filled.';
        } else {
            // 先转成数组再追加
            $errors['book_genre'] = [$errors['book_genre'], 'Book genre must be filled.'];
        }
    } else {
        $errors['book_genre'] = 'Book genre must be filled.';
    }
}

二、为啥原有错误会被“替换”？ #

• 字段错误被覆盖：如果book_genre字段本来就有其他验证错误（比如你没注意到的隐性规则），直接$errors['book_genre'] = '...'会把这个字段的原有错误覆盖掉，看起来像是所有原有错误都消失了，但其实只是该字段的错误被替换。
• 框架错误容器特性：部分框架的errors()返回不可变对象，你赋值给临时变量$errors后，修改的只是这个变量，并没有同步到Model的错误集合——但如果你的代码是先拿错误再修改，原有错误应该还在$errors里，除非后续不小心重新赋值了$errors。
• implode的视觉误导：用implode拼接错误时，若原有错误仅涉及单个字段，而你刚好替换了该字段的错误，就会产生“所有原有错误被替换”的错觉。

三、更省心的方案：动态添加验证规则 #

其实没必要手动维护错误列表，直接在Model里动态添加条件验证规则更贴合框架流程：

// 调用insert前，根据hobby的值决定是否添加book_genre的必填规则
if($data['hobby'] == 'Reading novel') {
    $model->setValidationRule('book_genre', 'required');
}

if( $model->insert($data) ) {
    $response = [
        'success' => true,
        'msg' => 'Good job'
    ];
} else {
    $errors = $model->errors();
    $response = [
        'success' => false,
        'msg' => '<p>' . implode('</p><p>', $errors) . '</p>'
    ];
}

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