
在 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 原生验证流程的完整性,又实现了规则逻辑的集中管理与跨控制器复用——这才是符合框架设计哲学的工程化解决方案。










