Rudra-Validation | API

Installation

composer require rudra/validation

Features

• Fluent Interface for chain validation
• Built-in sanitization (HTML tags, trimming)
• CSRF protection
• Custom validation rules
• Human-readable error messages with field aliases
• Strict type checking

Available Rules

Rule	Description	Example
required()	Field must not be empty	->required()
min(int $length)	Minimum string length	->min(3)
max(int $length)	Maximum string length	->max(255)
email()	Valid email address	->email()
url()	Valid URL	->url()
integer()	Integer value	->integer()
numeric()	Numeric value (int or float)	->numeric()
between(int|float $min, int|float $max)	Value in range	->between(1, 100)
equals(mixed $value)	Strict equality	->equals('password123')
in(array $allowed)	Value in allowed list	->in(['admin', 'user'])
regex(string $pattern)	Match regex pattern	->regex('/^[A-Z]{3}$/')
date(string $format)	Valid date format	->date('Y-m-d')
csrf(array $tokens)	CSRF token validation	->csrf($_SESSION['csrf'])
custom(callable $callback)	Custom validation	->custom(fn($v) => strlen($v) > 5)
sanitize(string $value)	Strip HTML tags	->sanitize($input, '<p><a>')

Example of usage

use Rudra\Validation\ValidationFacade;

$_SESSION['csrf'][] = '123456';

$processed = [
    'set_without_validation' => ValidationFacade::set('set_without_validation')->run(),
    'set_with_data_clearing' => ValidationFacade::sanitize(' <p>String</p> ')->run(),
    
    'required' => ValidationFacade::set('required')->required()->run(),
    'integer'  => ValidationFacade::set(12345)->required()->integer()->run(),
    'minimum'  => ValidationFacade::set('12345')->required()->min(5)->run(),
    'maximum'  => ValidationFacade::set('12345')->required()->max(5)->run(),
    'equals'   => ValidationFacade::set('12345')->equals('12345')->run(),
    'email'    => ValidationFacade::email('user@example.com')->run(),
    'csrf'     => ValidationFacade::set('123456')->csrf($_SESSION['csrf'])->run()
];

Data is validated in a chain

For example:

ValidationFacade::sanitize(' <p>12345</p> ')->required()->min(3)->max(10)->equals('12345')->run();
ValidationFacade::email('user@example.com')->max(25)->run();

Data validation check

if (ValidationFacade::approve($processed)) {
    $validated = ValidationFacade::getValidated($processed, ["csrf", "_method"]);
}

getValidated

Gets an array of validated data excluding the keys ["csrf", "_method"]

Get all error messages

ValidationFacade::getErrors($processed, ['required']);

getAlerts

Gets an array with error messages excluding the keys ['required']

Using field aliases

use Rudra\Validation\ValidationFacade;

ValidationFacade::setAliases([
    'usr_name' => 'Username',
    'usr_email' => 'Email Address'
]);

$processed = [
    'usr_name'  => ValidationFacade::set($_POST['usr_name'])->required()->min(3)->run(),
    'usr_email' => ValidationFacade::email($_POST['usr_email'])->run(),
];

$errors = ValidationFacade::getErrors($processed);
// Returns: ['usr_name' => ['msg' => 'Поле должно быть заполнено', 'alias' => 'Username'], ...]

License

This project is licensed under the Mozilla Public License 2.0 (MPL-2.0) — a free, open-source license that:

• Requires preservation of copyright and license notices,
• Allows commercial and non-commercial use,
• Requires that any modifications to the original files remain open under MPL-2.0,
• Permits combining with proprietary code in larger works.

📄 Full license text: LICENSE
🌐 Official MPL-2.0 page: https://mozilla.org/MPL/2.0/