Hyperf 不提供模型层验证，仅支持请求层验证，通过表单请求类（如 UserRegisterRequest）或手动调用 Validator 实现；需配置 ValidationMiddleware 和 ValidationExceptionHandler 中间件及异常处理器，方可启用验证功能。
Hyperf 本身不提供“模型验证”（Model-level validation）机制，它采用的是请求层验证（Request-level validation），即在请求进入控制器前完成数据校验。所谓“模型验证”，在 Hyperf 中实际是通过 表单请求类（FormRequest） 或 手动调用 Validator 来实现的，而不是像 Laravel 那样在 Eloquent 模型中定义 validate() 方法。
使用表单请求类做集中验证（推荐）
这是最清晰、可复用性最强的方式，适合注册、登录、创建资源等典型场景：
- 执行命令生成请求类：
php bin/hyperf.php gen:request UserRegisterRequest - 编辑
app/Request/UserRegisterRequest.php，重写rules()方法，例如：public function rules(): array { return [ 'name' => 'required|string|max:50', 'email' => 'required|email|unique:users,email', 'password' => 'required|string|min:8|confirmed' ]; } - 在控制器中直接类型提示该类，框架自动拦截并验证：
public function store(UserRegisterRequest $request) { $data = $request->validated(); // 已过滤且通过验证的数据 // 后续可安全用于创建模型或业务逻辑 }
手动创建验证器（灵活控制场景）
适用于动态规则、条件判断、或非 HTTP 请求上下文（如命令行、定时任务）：
- 注入
Hyperf\Validation\Contract\ValidatorFactoryInterface - 调用
make()构建验证器，传入原始数据和规则数组：$validator = $this->validationFactory->make( $request->all(), [ 'mobile' => 'required|regex:/^1[3-9]\d{9}$/', 'code' => 'required|size:6' ], [ 'mobile.required' => '手机号不能为空', 'mobile.regex' => '手机号格式不正确' ] ); - 检查结果：
if ($validator->fails()) { ... }；获取错误：$validator->errors()->toArray()；获取通过数据：$validator->validated()
自定义验证规则与提示语（提升体验）
内置规则覆盖广，但业务特殊逻辑仍需扩展：
- 注册自定义规则：在
config/autoload/functions.php或服务提供者中调用Validator::extend('chinese_name', ...) - 定义中文提示：运行
php bin/hyperf.php vendor:publish hyperf/validation，编辑storage/languages/zh_CN/validation.php，添加对应键值，如'chinese_name' => '姓名必须为中文' - 在规则中使用：
'realname' => 'required|chinese_name'
关键配置不能漏（否则验证不生效）
验证功能依赖中间件与异常处理器，缺一不可：
- 在
config/autoload/middlewares.php的'http'数组中加入：\Hyperf\Validation\Middleware\ValidationMiddleware::class - 在
config/autoload/exceptions.php的'http'异常处理器列表中加入：\Hyperf\Validation\ValidationExceptionHandler::class - 若需多语言提示，还需先发布翻译组件：
php bin/hyperf.php vendor:publish hyperf/translation
