README

Lightweight PHP validation library with custom rules and structured errors.

Features

• Built-in Rules — Required, email, phone, uuid, min, max, length, numeric, date, and more
• Custom Rules — Extend validation with your own rules via callbacks or classes
• Structured Errors — Machine-readable error objects with rule names and parameters
• Parameterized Rules — Define rules like min:8, max:100, in:a,b,c
• Phone Validation — International phone validation via libphonenumber
• Lightweight — Minimal dependencies, PSR-4 compliant

Installation

composer require solophp/validator

Quick Example

use Solo\Validator\Validator;

$validator = new Validator();

$data = [
    'email' => 'user@example.com',
    'username' => 'john_doe',
    'age' => 25,
];

$rules = [
    'email' => 'required|email',
    'username' => 'required|min:3|max:20',
    'age' => 'integer|min_value:18',
];

$errors = $validator->validate($data, $rules);

if ($validator->fails()) {
    print_r($validator->errors());
    // [
    //     'field' => [
    //         ['rule' => 'email'],
    //         ['rule' => 'min', 'params' => ['3']],
    //     ],
    // ]
} else {
    echo "Validation passed!";
}

Documentation

Full Documentation

• Installation
• Quick Start
• Validation Rules
• Custom Rules
• API Reference

Requirements

• PHP 8.1+

License

MIT License. See LICENSE for details.