数据验证

数据验证做为开发中不可缺少的一环。在cmlphp中也提供了简单易用的数据验证工具。

用法

v2.6.8以下版本

  2. <?php
  3. use Cml\Vendor\Validate;
  5. if (Validate::isUrl($description)) {
  7. }
  9. if (Validate::isIp($ip)) {
  13. }
  14. //更多方法参考 http://api.cmlphp.com/Cml/Vendor/Validate.html

v2.6.8+

在v2.6.8版本中对Validate做了增强,除了以上的直接调用方法外，还可以有以下用法:

  1. <?php
  3. use Cml\Vendor\Validate;
  5. //初始化实例 传入包含要验证数据的数组 这边是$_POST
  6. $v = new Validate($_POST);
  8. //type、ptime、status、action 必传
  9. $v->rule('require', ['type', 'ptime', 'status', 'action']);
  11. //type、ptime、status 必须为整形 
  12. $v->rule('int', ['type', 'ptime', 'status']);
  14. //ptime只能在0-23范围内
  15. $v->rule('in', ['ptime'], range(0, 23));
  17. //设置字段->实际显示字段的映射关系
  18. $v->label(array(
  19.     'type' => '类型',
  20.     'ptime' => '执行时间/间隔时间',
  21.     'status' => '状态',
  22.     'action' => '操作',
  23. ));
  25. //批量校验
  26. if(!$v->validate()) {
  27.     $error = $v->getErrors();//获取错误信息
  28. }

上面大概演示了如何使用cmlphp自带的Validate组件进行批量数据验证。下面列出所有的规则以及如何自定义规则。

内置验证规则

  1. 'require' => "不能为空",
  3. 'gt' => "必须大于 %s",
  5. 'lt' => "必须小于 %s",
  7. 'lengthGt' => "长度必须大于 %d",
  9. 'lengthLt' => "长度必须小于 %d",
  11. 'in' => "无效的值",
  13. 'notIn' => "无效的值",
  15. 'length' => "字符串长度必须在 %d, %d之间",
  17. 'empty' => "必须为空",
  19. 'equals' => "必须和 '%s' 一致",
  21. 'different' => "必须和 '%s' 不一致",
  23. 'arr' => "必须是数组",
  25. 'email' => "无效邮箱地址",
  27. 'ip' => "无效IP地址",
  29. 'number' => "只能是数字",
  31. 'int' => "只能是整数",
  33. 'bool' => "只能是布尔值",
  35. 'card' => "必须是身份证",
  37. 'mobile' => "手机号码不正确",
  39. 'phone' => "固话格式不正确",
  41. 'url' => "无效的URL",
  43. 'zip' => "邮政编码不对",
  45. 'qq' => "qq号格式不正确",
  47. 'english' => "只能包括英文字母(A-za-z)",
  49. 'chinese' => "只能为中文"

自定义验证规则

除了以上内置的校验规则外，还可以自定义验证规则，方法如下:

  1. <?php
  3. use Cml\Vendor\Validate;
  5. //添加
  6. Validate::addRule('test', function($value, $params) {
  7.     //$value的值就是$_POST['test']的值
  8.     //$params是参数数组，就是下面$v->rule...中的[1, 2]
  9.     return false;
  11. }, '就是不让你通过检验');
  13. $v = new Validate($_POST);
  15. //使用
  16. $v->rule('test', 1, 2);
  17. ...

提示信息

内置的验证规则，提示信息跟随系统的语言设置。当框架的语言包为哪个语言时验证规则也显示哪个语言。语言包存放路径为框架的Vendor\Validate\Lang目录下。也可以在实例化的时候自定义语言包所在路径

  1. <?php
  3. use Cml\Vendor\Validate;
  6. $v = new Validate($_POST, 'lang_dir');

如果不想用内置的语言包也可以使用 message自定义提示信息，使用方法如下:

  1. <?php
  3. use Cml\Vendor\Validate;
  6. $v = new Validate($_POST);
  7. $v->rule('require', ['type', 'ptime', 'status', 'action'])
  8.   ->message('{field} 必须填写!'); 
  9. //其中{field}为占位符。有设置label时会替换为label,没设置label时会替换为相应的字段名

原文: http://doc.cmlphp.com/devintro/validate.html