hyperf/validation

hyperf validation

v3.2.0-alpha.3 2025-10-30 03:22 UTC

Requires

• php: >=8.2
• egulias/email-validator: ^3.0
• hyperf/collection: ~3.2.0
• hyperf/conditionable: ~3.2.0
• hyperf/context: ~3.2.0
• hyperf/contract: ~3.2.0
• hyperf/di: ~3.2.0
• hyperf/framework: ~3.2.0
• hyperf/macroable: ~3.2.0
• hyperf/stringable: ~3.2.0
• hyperf/support: ~3.2.0
• hyperf/tappable: ~3.2.0
• hyperf/translation: ~3.2.0
• nesbot/carbon: ^2.21 || ^3.0
• psr/container: ^1.0 || ^2.0
• psr/event-dispatcher: ^1.0
• psr/http-message: ^1.0 || ^2.0

Suggests

• hyperf/database: Required if you want to use the database validation rule (~3.2.0).
• hyperf/http-server: Required if you want to use the request validation rule (~3.2.0).

MIT

• validation
• hyperf

README

About

hyperf/validation 组件衍生于 Laravel Validation 组件的，我们对它进行了一些改造，大部分功能保持了相同。在这里感谢一下 Laravel 开发组，实现了如此强大好用的 Validation 组件。

Installation

composer require hyperf/validation

Config

Publish config file

# 发布国际化配置，已经发布过国际化配置可以省略
php bin/hyperf.php vendor:publish hyperf/translation

php bin/hyperf.php vendor:publish hyperf/validation

Configuration path

your/config/path/autoload/translation.php

Configuration

<?php
return [
    'locale' => 'zh_CN',
    'fallback_locale' => 'en',
    'path' => BASE_PATH . '/storage/languages',
];

Exception handler

<?php
return [
    'handler' => [
        'http' => [
            \Hyperf\Validation\ValidationExceptionHandler::class,
        ],
    ],
];

Validation middleware

<?php
return [
    'http' => [
        \Hyperf\Validation\Middleware\ValidationMiddleware::class,
    ],
];

Usage

Generate form request

Command:

php bin/hyperf.php gen:request FooRequest

Usage:

class IndexController
{
    public function foo(FooRequest $request)
    {
        $request->input('foo');
    }
    
    public function bar(RequestInterface $request)
    {
        $factory = $this->container->get(\Hyperf\Validation\Contract\ValidatorFactoryInterface::class);

        $factory->extend('foo', function ($attribute, $value, $parameters, $validator) {
            return $value == 'foo';
        });

        $factory->replacer('foo', function ($message, $attribute, $rule, $parameters) {
            return str_replace(':foo', $attribute, $message);
        });

        $validator = $factory->make(
            $request->all(),
            [
                'name' => 'required|foo',
            ],
            [
                'name.foo' => ':foo is not foo',
            ]
        );

        if (!$validator->passes()) {
             $validator->errors();
        }
    }
}