x_mier / webman-validate
The webman Validate Package
v1.0.1
2024-07-22 06:55 UTC
Requires
- php: >=7.2.0
- symfony/polyfill-php80: ^1.19
- symfony/translation: ^5.4|^6.0
Requires (Dev)
- workerman/webman-framework: ^1.2.1
This package is not auto-updated.
Last update: 2025-03-03 09:47:47 UTC
README
基于PHP7.4 + 的Validate实现。基于ThinkPHP6修改的可用于 webman 的通用validate数据验证器。
- 支持助手函数validate(),无需手动创建。
- 支持场景验证scene
- 支持表单令牌token
- 支持unique唯一性验证(基于TP think-orm Db类)
- 支持图片验证
安装
composer require x_mier/webman-validate
使用
用法跟TP6完全一致
定义验证器:
namespace app\validate;
use x_mier\validate\Validate;
class User extends Validate
{
protected $rule = [
'name' => 'require|max:25',
'age' => 'require|number|between:1,120',
'email' => 'require|email'
];
protected $message = [
'name.require' => '名称必须填写',
'name.max' => '名称最多不能超过25个字符',
'age.require' => '年龄必须填写',
'age.number' => '年龄必须是数字',
'age.between' => '年龄只能在1-120之间',
'email.require' => '邮箱必须填写',
'email.email' => '邮箱格式错误'
];
}
验证器调用代码如下:
$data = [
'name' => 'thinkphp',
'age' => 24,
'email' => 'thinkphp@163.com'
];
$validate = new \app\validate\User;
if (!$validate->check($data)) {
var_dump($validate->getError());
}
助手函数(推荐)
自定义函数 functions.php 添加validate()函数
/**
* @desc 验证器助手函数
* @param string|array $validate 验证器类名或者验证规则数组
* @param array $message 错误提示信息
* @param bool $batch 是否批量验证
* @param bool $failException 是否抛出异常
* @return bool
* @author x_mier
*/
function validate($validate = '', array $message = [], bool $batch = false, bool $failException = true)
{
if (is_array($validate) || ''===$validate) {
$v = new \x_mier\validate\Validate();
$v->rule($validate);
} else {
if (strpos($validate, '.')) {
[$validate, $scene] = explode('.', $validate);
}
$v = new $validate();
if (!empty($scene)) {
$v->scene($scene);
}
}
return $v->message($message)->batch($batch)->failException($failException);
}
>验证器调用代码如下:
namespace app\controller;
use app\validate\User;
use x_mier\validate\exception\ValidateException;
class Index
{
public function index()
{
try {
validate(User::class)->check([
'name' => 'thinkphp',
'email' => 'thinkphp@qq.com',
]);
} catch (ValidateException $e) {
// 验证失败 输出错误信息
dump($e->getError());
}
}
}
//场景校验方法
$data = [
'name' => 'thinkphp',
'age' => 10,
'email' => 'thinkphp@qq.com',
];
try {
validate(app\validate\User::class)
->scene('edit')
->check($data);
} catch (ValidateException $e) {
// 验证失败 输出错误信息
dump($e->getError());
}
// 静态方法验证
$validate = \x_mier\validate\facade\Validate::rule('age', 'number|between:1,120')
->rule([
'name' => 'require|max:25',
'email' => 'email'
]);
$data = [
'name' => 'thinkphp',
'email' => 'thinkphp@qq.com'
];
if (!$validate->check($data)) {
dump($validate->getError());
}
更多用法可以参考6.0完全开发手册的验证章节