Hyperf模型验证技巧与规则设置教程

Hyperf 并不支持 Laravel 风格的模型层验证，而是专注在请求入口处进行高效、灵活的数据校验——通过表单请求类（如 UserRegisterRequest）实现声明式、可复用的集中验证，或借助 Validator 工厂手动构建动态规则，满足从 Web 请求到命令行、定时任务等多场景需求；配合自定义规则、中文提示语及关键中间件与异常处理器配置，即可快速搭建健壮、易维护、体验友好的验证体系，是 Hyperf 开发者必须掌握的核心实践。

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

本篇关于《Hyperf模型验证技巧与规则设置教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于文章的相关知识，请关注golang学习网公众号！