codeigniter表单验证需显式加载、逐字段配置规则、手动调用run()触发,且错误提示与值回填须自行实现;callback方法须为控制器public函数、严格命名、接收参数并正确设消息;规则顺序影响提示优先级,中文语言包需提前载入。

CodeIgniter 表单验证不是“开了就能用”的功能,必须显式加载、逐字段配置规则、手动触发执行,且错误提示和值回填都要自己写代码补全——漏掉任意一环,验证就等于没做。
必须在控制器里调用 $this->form_validation->run()
很多人写了 set_rules() 却没调用 run(),结果表单永远“看起来通过了”。run() 是唯一触发校验的开关,它返回 TRUE 或 FALSE,不检查这个返回值,后续逻辑就完全失控。
-
run()必须在set_rules()之后、业务处理之前调用 - 返回
FALSE时,validation_errors()才有内容;返回TRUE才该走插入/跳转等后续流程 - 不要在模型或自定义库中调用
run()—— 验证类依赖控制器实例生命周期,模型里调用会丢失$this->db、$this->lang等上下文
回调函数必须是控制器里的 public function callback_xxx($str)
想查数据库判断用户名是否已存在?不能写成普通函数、不能放模型里、不能漏 callback_ 前缀——否则 form_validation 类会静默跳过该规则,不报错也不验证,极其隐蔽。
- 方法名必须严格匹配规则字符串中
callback_后的部分(如规则是callback_check_email,方法名就得叫check_email) - 必须接收一个参数
$str,它就是当前字段过滤后的值,不要再用$this->input->post()重取 - 失败时必须先调用
$this->form_validation->set_message('check_email', '邮箱已被注册'),再return FALSE;顺序错了,错误信息就不显示 - 访问数据库要用
$this->db,不能 new Model 或用get_instance()绕过注入
set_rules() 的三个参数含义和常见陷阱
字段名、标签名、规则串,看着简单,但每个参数都卡着验证能否生效的关键点。
- 第一个参数(字段名)必须和
$_POST中的 key 完全一致,大小写敏感;表单用name="Email",这里就得写'Email',不能写'email' - 第二个参数(标签名)只用于拼错误消息,比如
'required'规则失败时会输出 “Email 字段是必需的”,所以建议用中文如'邮箱' - 第三个参数(规则串)用竖线
|连接,min_length[5]括号里不能有空格或中文,否则解析失败;xss_clean要放在靠前位置,避免恶意脚本干扰后续规则 - 规则顺序影响提示优先级:先写的规则先校验,第一个失败就停,后面的规则不会执行
错误显示和值回填必须手动配齐
验证失败后,用户看到空白表单+无提示,是最常见的“验证失效”假象。这不是验证没跑,而是没把错误和旧值还回去。
-
validation_errors()默认用<p></p>包裹,可传参改模板:validation_errors('<div class="error">', '</div>') - 表单字段值不会自动保留,必须在视图里用
set_value('username')替代原始value="",否则用户输错一次就全部清空 - 中文错误消息要提前载入语言包:
$this->lang->load('form_validation', 'zh_cn'),并确保application/language/zh_cn/form_validation_lang.php存在且格式正确
最易被忽略的是:所有验证逻辑都得落在控制器方法内,不能拆到模型或独立库中做主流程;callback_ 方法看似可复用,实则绑定死在当前控制器上,跨控制器复用必须继承 CI_Form_validation 自建验证器类——这点在多人协作或模块化项目里,往往到上线前才暴露出来。











