
在 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 生态中最稳健、最符合框架设计哲学的解决方案。










