README

A simple and extensible PHP parameter validation library, supporting rule-based definitions and custom extensions, suitable for any structured data verification scenarios

This project has been parsed by Zread. If you need a quick overview of the project, you can click here to view it：Understand this project

📦 Installation method

Install using Composer：

composer require hejunjie/schema-validator

🚀 Usage

Support multiple rule definitions + throw exceptions + custom extensions：

use Hejunjie\SchemaValidator\Validator;
use Hejunjie\SchemaValidator\Exceptions\ValidationException;

$data = [
    'name'   => '张三',
    'age'    => 28,
    'email'  => 'invalid-email',
];

// Custom extension. If true is returned, the rule passes; otherwise, it is considered as failing
Validator::extend('is_zh', function ($field, $value, $params = null) {
    if (preg_match('/^[\x{4e00}-\x{9fa5}]+$/u', $value)) {
        return true;
    }
});

try {
    Validator::validate($data, [
        'name'  => ['is_zh', 'string', 'minLength:2'],
        'age'   => ['integer', 'between:18,60'],
        'email' => ['required', 'email'],
    ]);
    echo "Verified by ✅";
} catch (ValidationException $e) {
    echo "Validation failed ❌" . PHP_EOL;
    print_r($e->getErrors());
}

// Return the fields and rules indicating whether it is passed or failed:
// Validation failed ❌
// Array
// (
//     [email] => Array
//         (
//             [0] => email
//         )

// )

✅ Default support rule

The following rules are already supported in a built-in manner and are implemented as independent classes, allowing for free extension or replacement：

Type class

Compare class

Format class

Boolean class

Custom class

The error message is returned as an array of rule names, and the prompt text can be customized

🧩 Purpose & Original Intent

In daily development, we often need to perform structured validation on incoming data, but many existing libraries are either bulky, rely on frameworks, or are not flexible in terms of extension (such as Laravel Validator).

The goal of this library is to:

• ✅ Zero dependencies, suitable for any PHP project
• ✅ Validation for structured arrays
• ✅ Each rule is encapsulated independently, facilitating customization and expansion
• ✅ More suitable for field prompts and error handling in the Chinese context

If you need a simple, clear, and rule-controlled data verification tool, it may be just right for you.

🙌 Welcome to contribute

Welcome to raise issues, submit pull requests, or directly fork for use!

If you have other commonly used validation rules, feel free to add them, even if it's just a line of regular expression.