ThinkPHP的验证器怎么用？ThinkPHP如何验证表单数据？

<?php
namespace app\validate;

use think\Validate;

class User extends Validate
{
    // 定义验证规则
    protected $rule = [
        'username|用户名' => 'require|min:5|max:20|unique:user',
        'email|邮箱'     => 'require|email|unique:user',
        'password|密码'  => 'require|min:6',
        'age|年龄'       => 'between:18,60',
    ];

    // 定义错误提示信息
    protected $message = [
        'username.require' => '用户名不能为空',
        'username.min'     => '用户名至少5个字符',
        'username.max'     => '用户名最多20个字符',
        'username.unique'  => '用户名已存在',
        'email.require'    => '邮箱不能为空',
        'email.email'      => '邮箱格式不正确',
        'email.unique'     => '邮箱已注册',
        'password.require' => '密码不能为空',
        'password.min'     => '密码至少6个字符',
        'age.between'      => '年龄必须在18到60岁之间',
    ];

    // 定义验证场景（后面会提到）
    protected $scene = [
        'add'  => ['username', 'email', 'password'],
        'edit' => ['username', 'email', 'age'],
    ];
}

<?php
namespace app\controller;

use app\BaseController;
use app\validate\User;
use think\exception\ValidateException;

class Index extends BaseController
{
    public function register()
    {
        $data = request()->param(); // 获取所有请求参数

        try {
            validate(User::class)->check($data);
        } catch (ValidateException $e) {
            // 验证失败，处理错误信息
            return json(['code' => 0, 'msg' => $e->getError()]);
        }

        // 验证通过，执行业务逻辑
        return json(['code' => 1, 'msg' => '注册成功']);
    }
}

// app\validate\User.php
protected $rule = [
    // ... 其他规则
    'custom_field|自定义字段' => 'require|checkCustomField',
];

protected function checkCustomField($value, $rule, $data)
{
    // $value 是当前字段的值
    // $rule 是规则名（这里是'checkCustomField'，如果你定义了参数，也会在这里）
    // $data 是所有验证的数据
    if ($value === '非法值') {
        return '自定义字段不能是“非法值”';
    }
    return true; // 返回true表示通过验证
}

// 例如，在 app\common.php 或者某个辅助类中
function check_my_special_rule($value, $rule, $data) {
    if (strlen($value) % 2 != 0) {
        return '长度必须是偶数';
    }
    return true;
}

// 在验证器中引用
protected $rule = [
    'some_field' => 'require|check_my_special_rule', // 直接使用函数名
];

// 在某个服务提供者或应用初始化的地方
\think\Validate::extend('isIdCard', function($value) {
    // 简单的身份证号验证逻辑，实际应用会更复杂
    return preg_match('/^\d{17}(\d|X)$/i', $value);
});

// 然后在验证器里就可以直接用了
protected $rule = [
    'id_card' => 'require|isIdCard',
];

use think\exception\ValidateException;

// ...
try {
    validate(User::class)->check($data);
    // 验证通过
} catch (ValidateException $e) {
    $errorMsg = $e->getError(); // 获取错误信息
    // $errorMsg 可能是一个字符串（默认只返回第一个错误），也可能是一个数组（开启批量验证时）
    // 常见的处理方式如下：
}

return json(['code' => 400, 'msg' => $e->getError()]);

// 如果 $e->getError() 是 ['username' => '用户名已存在', 'email' => '邮箱格式不正确']
$errors = $e->getError();
$formattedErrors = [];
foreach ($errors as $field => $msg) {
    $formattedErrors[] = "$field: $msg";
}
return json(['code' => 400, 'msg' => implode(';', $formattedErrors)]);

return redirect()->back()->withErrors(['msg' => $e->getError()]);
// 或者更具体的
// return redirect()->back()->withErrors($e->getError()); // 如果getError()返回的是数组

<!-- 在你的表单页面 -->
<?php if(session('msg')): ?>
    <div style="color: red;"><?= session('msg') ?></div>
<?php endif; ?>

<!-- 如果是批量错误，需要遍历 -->
<?php if(session('errors')): ?>
    <ul style="color: red;">
        <?php foreach(session('errors') as $field => $error): ?>
            <li><?= $field ?>: <?= $error ?></li>
        <?php endforeach; ?>
    </ul>
<?php endif; ?>

try {
    validate(User::class)->check($data);
} catch (ValidateException $e) {
    $this->assign('errors', $e->getError()); // 将错误信息赋值给模板变量
    return $this->fetch('form_page'); // 渲染表单页面
}

try {
    validate(User::class)->batch(true)->check($data); // 开启批量验证
} catch (ValidateException $e) {
    $errors = $e->getError(); // 此时 $errors 是一个关联数组，包含所有字段的错误
    // 例如：['username' => '用户名已存在', 'email' => '邮箱格式不正确']
    return json(['code' => 400, 'msg' => $errors]);
}

// app\validate\User.php
protected $scene = [
    'add'  => ['username', 'email', 'password'], // 注册场景，这些字段必填且按规则校验
    'edit' => ['username', 'email', 'age'],     // 编辑场景，只校验这些字段，且密码可以不传
    'password_reset' => ['password'],           // 重置密码场景，只校验密码
];

public function register()
{
    $data = request()->param();
    try {
        validate(User::class)->scene('add')->check($data); // 使用 'add' 场景
    } catch (ValidateException $e) {
        return json(['code' => 0, 'msg' => $e->getError()]);
    }
    // ... 注册逻辑
}

public function updateProfile()
{
    $data = request()->param();
    try {
        validate(User::class)->scene('edit')->check($data); // 使用 'edit' 场景
    } catch (ValidateException $e) {
        return json(['code' => 0, 'msg' => $e->getError()]);
    }
    // ... 更新资料逻辑
}