CodeIgniter 3 中自定义表单验证规则库的正确实现方法

在 codeigniter 3 中，将重复的表单验证规则抽离为可复用库时，需注意回调函数（callback）仅支持当前控制器内的方法；若使用独立库类，必须通过继承 `ci_form_validation` 并重写其逻辑才能使自定义规则生效。

要让自定义验证规则在 CodeIgniter 3 中真正生效，关键在于理解其 form_validation 类的回调机制：*`callback_规则默认只查找当前控制器（Controller）中定义的方法，而不会自动调用 Library 或其他类中的方法**。因此，您原代码中callback__test_rule1指向My_validations::_test_rule1()是无效的——框架根本不会去My_validations` 实例中寻找该方法。

✅ 正确做法是 扩展 CI_Form_validation 类，将验证规则和回调逻辑封装进自定义验证器中：

1. 创建自定义验证类（推荐路径）

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

 'test']      * @return array 验证规则数组      */     public function get_rules($params = [])     {         $rules = [];          if (!empty($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 要求私有回调方法前缀为下划线）；规则字符串中直接写 ‘_test_rule1’，不能写 ‘callback__test_rule1’；该方法必须位于 MY_Form_validation 类内部，否则无法被 form_validation->run() 自动识别和调用。

2. 控制器中调用方式（精简且可靠）

public function test1() {     // 无需手动加载 My_validations 库     $this->load->library('form_validation'); // 自动加载 MY_Form_validation      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'; // 验证通过             // 执行后续逻辑（如保存数据）         } else {             echo 'failed';             // 可选：显示错误信息             // echo validation_errors();         }     }      $this->load->view('form', $this->data); }

✅ 补充建议与最佳实践

• csrf 保护：您的表单已包含 CSRF 字段，确保在 config/config.php 中启用了 csrf_protection = TRUE，并确认 $csrf_name 和 $csrf 已在视图数据中正确传递。
• 错误提示输出：调试阶段可在视图中添加 查看具体失败原因。
• 规则复用升级：如需支持多模块、多场景，可将 get_rules() 改为静态方法 + 配置文件驱动（如 app/config/validation_rules.php），提升可维护性。
• 避免命名冲突：自定义回调方法名建议加上模块前缀（如 _test_phone_required），防止与其他控制器回调冲突。

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