ThinkPHP5.1
推荐使用验证器进行数据验证(也支持使用thinkValidate
类进行独立验证)。
验证器定义
为具体的验证场景或数据表定义好验证器类 直接调用验证类的check
方法即可完成验证 下面是个例子:
定义个appindexvalidateUser
验证器类用于User
的验证。
namespace appindexvalidate;
use thinkValidate;
class User extends Validate
{
protected $rule = [
'name' => 'require|max:25',
'email' => 'email',
];
}
V5.1.15+
版本开始 可以使用下面的指令快速生成User
验证器。php think make:validate index/User
可以直接在验证器类中使用message
属性定义错误提示信息 例如:
namespace appindexvalidate;
use thinkValidate;
class User extends Validate
{
protected $rule = [
'name' => 'require|max:25',
'age' => 'number|between:1,120',
'email' => 'email',
];
protected $message = [
'name.require' => '名称必须',
'name.max' => '名称最多不能超过25个字符',
'age.number' => '年龄必须是数字',
'age.between' => '年龄只能在1-120之间',
'email' => '邮箱格式错误',
];
}
如果没有定义错误提示信息 则使用系统默认的提示信息
数据验证
在需要进行User
验证的控制器方法中 添加如下代码即可:
namespace appindexcontroller;
use thinkController;
class Index extends Controller
{
public function index()
{
$data = [
'name' => 'thinkphp',
'email' => 'thinkphp@qq.com',
];
$validate = new appindexvalidateUser;
if (!$validate->check($data)) {
dump($validate->getError());
}
}
}
事实上控制器类提供了个validate
方法可以更方便的进行验证 如下:
namespace appindexcontroller;
use thinkController;
class Index extends Controller
{
public function index()
{
$result = $this->validate(
[
'name' => 'thinkphp',
'email' => 'thinkphp@qq.com',
],
'appindexvalidateUser');
if (true !== $result) {
// 验证失败 输出错误信息
dump($result);
}
}
}
批量验证
默认情况下 一旦有某个数据的验证规则不符合 就会停止后续数据及规则的验证 如果希望批量进行验证 可以设置:
namespace appindexcontroller;
use thinkController;
class Index extends Controller
{
// 是否批量验证
protected $batchValidate = true;
public function index()
{
$result = $this->validate(
[
'name' => 'thinkphp',
'email' => 'thinkphp@qq.com',
],
'appindexvalidateUser');
if (true !== $result) {
// 验证失败 输出错误信息
dump($result);
}
}
}
批量验证如果验证不通过 返回的是个错误信息的数组。
抛出验证异常
默认情况下验证失败后不会抛出异常 如果希望验证失败自动抛出异常 可以在控制器类中添加设置:
namespace appindexcontroller;
use thinkController;
class Index extends Controller
{
// 验证失败是否抛出异常
protected $failException = true;
public function index()
{
$result = $this->validate(
[
'name' => 'thinkphp',
'email' => 'thinkphp@qq.com',
],
'appindexvalidateUser');
}
}
设置开启了验证失败后抛出异常的话 无需手动获取错误信息 会自动抛出thinkexceptionValidateException
异常或自己捕获处理。
自定义验证规则
系统内置了一些常用的规则(参考后面的内置规则) 如果不能满足需求 可以在验证器重添加额外的验证方法 例如:
namespace appindexvalidate;
use thinkValidate;
class User extends Validate
{
protected $rule = [
'name' => 'checkName:thinkphp',
'email' => 'email',
];
protected $message = [
'name' => '用户名必须',
'email' => '邮箱格式错误',
];
// 自定义验证规则
protected function checkName($value,$rule,$data=[])
{
return $rule == $value ? true : '名称错误';
}
}
验证方法可以传入的参数共有5
个(后面三个根据情况选用) 依次为:
- 验证数据
- 验证规则
- 全部数据(数组)
- 字段名
- 字段描述
自定义的验证规则方法名不能和已有的规则冲突。
尊贵的董事大人
英文标题不为空时 视为本栏投稿
需要关键字 描述 英文标题