qubus/validation

A framework agnostic validation library like the one found in Laravel.

v4.1.0 2025-10-19 14:43 UTC

Requires

• php: >=8.4
• qubus/support: ^4

Requires (Dev)

• qubus/qubus-coding-standard: ^2

MIT

• Joshua Parker

README

This is a fork of overtrue/validation, with several changes and additions.

This validation library is designed to make it more convenient for you to complete data validation in any project or framework.

Requirements

• PHP 8.4+

Installation

Install via composer.

$ composer require qubus/validation

Usage

<?php

require('vendor/autoload.php');

use Qubus\Validation\Translators\DefaultTranslator;
use Qubus\Validation\Factory as ValidatorFactory;

// Initialize the factory object.
$factory = new ValidatorFactory(new DefaultTranslator);


// Verify the following fields.
$rules = [
    'username' => 'required|min:5',
    'password' => 'confirmed',
    ///...
];

$validator = $factory->make($input, $rules);

// Check if the fields passed verification.
if ($validator->passes()) {
    // If passed, do something.
} else {
    // If did not pass, print all errors. For the first error: $validator->messages()->first()
    print_r($validator->messages()->all()); // or $validator->messages()->first() or $validator->errors()
}

Custom Messages in Your Language：

Take Spanish as an example：

$messages = [
    'accepted'             => 'Se debe aceptar el :attribute.',
    'active_url'           => 'El :attribute no es una URL válida.',
    'after'                => 'El :attribute debe ser una fecha posterior a :date.',
    'alpha'                => 'El :attribute solo puede contener letras.',
    'alpha_dash'           => 'El :attribute solo puede contener letras, números y guiones.',
    'alpha_num'            => 'El :attribute solo puede contener letras y números.',
    // ...
];

// Pass the message array into the default translator class.
$factory = new ValidatorFactory(new DefaultTranslator($messages));

Set Attribute Name

$attributes = [
    'username' => 'username',
    'password' => 'password',
];

$rules = [
    'username' => 'required|min:5',
    'password' => 'confirmed',
    ///...
];

$messages = [...]; // Custom message, if you have set the message when initializing the factory, just leave it blank.

$validator = $factory->make($input, $rules, $messages, $attributes);

License

Released under the MIT License.