CodeIgniter 3 中自定义表单验证规则库的正确实现方式_技术教程

在 codeigniter 3 中，将复用的表单验证规则封装为独立库时，需注意回调函数（callback）仅支持当前控制器内方法；若需跨模块复用，应继承 `ci_form_validation` 并扩展其功能，而非通过普通 library 调用回调。

CodeIgniter 3 的表单验证类（CI_Form_validation）对回调规则（如 callback_my_rule）有严格限制：它只会在当前控制器实例中查找并调用对应方法，而不会搜索 Library、模型或其他类中的方法。因此，您在 My_validations 库中定义的 _test_rule1() 方法，即使被正确注册为规则，也无法被 form_validation 实例识别和执行——导致 run() 始终返回 false。

✅ 正确做法是：继承并扩展 CI_Form_validation 类，将验证逻辑与规则配置统一纳入验证器自身生命周期中。

步骤一：创建自定义验证类

在 application/libraries/MY_Form_validation.php 中定义：

 'test']
     * @return array 验证规则数组（兼容 set_rules() 批量格式）
     */
    public function get_rules($params = [])
    {
        $rules = [];

        if (isset($params['module']) && $params['module'] === 'test') {
            $rules[] = [
                'field' => 'phone',
                'label' => 'Phone Number',
                'rules' => '_test_rule1' // 注意：无需 'callback_' 前缀！
            ];
        }

        return $rules;
    }

    /**
     * 自定义验证回调方法（必须定义在本类中）
     * @return bool
     */
    public function _test_rule1()
    {
        $value = $this->input->post('phone');
        // 示例：仅允许数字且长度为10–13位
        return !empty($value) && preg_match('/^\d{10,13}$/', $value);
    }
}

⚠️ 关键细节：方法名以 _ 开头（如 _test_rule1）是 CodeIgniter 回调约定，不可加 callback_ 前缀（set_rules() 内部会自动识别 _ 开头的方法为回调）；该方法必须定义在 MY_Form_validation 类内部，否则无法被 run() 调用； MY_Form_validation 会自动被框架加载（无需 $this->load->library() 显式调用）。

步骤二：控制器中使用

更新您的控制器（application/modules/test/controllers/Test.php），移除对 My_validations 的加载，并直接调用扩展后的验证器：

public function test1()
{
    if ($this->input->server('REQUEST_METHOD') === 'POST')
    {
        $params = ['module' => 'test'];
        $rules  = $this->form_validation->get_rules($params);

        $this->form_validation->set_rules($rules);

        if ($this->form_validation->run() === TRUE)
        {
            // 验证通过：处理数据（如保存到数据库）
            echo 'OK';
            return;
        }
        else
        {
            // 验证失败：显示错误信息（可选）
            $errors = validation_errors();
            echo "Validation failed: " . $errors;
        }
    }

    $this->load->view('form', $this->data);
}

补充建议

✅ CSRF 保护：确保在 config/config.php 中启用了 CSRF（$config['csrf_protection'] = TRUE;），并在表单中正确输出隐藏字段（您已实现）；
✅ 错误提示：在视图中添加可直观显示失败原因；
? 避免命名冲突：自定义回调方法名应以 _ 开头且避免与内置规则（如 required, email）重名；
? 多模块支持：可在 get_rules() 中按 $params['module'] 分支返回不同规则集，实现真正可复用的验证策略。

通过继承 CI_Form_validation，您既保持了 CodeIgniter 原生验证机制的完整性，又实现了规则逻辑的集中管理与跨控制器复用——这是 CodeIgniter 3 生态中最稳健、最符合框架设计哲学的解决方案。