particle/validator

Flexible and highly usable validation library with no dependencies.

, _(*1)

Particle\Validator is a very small validation library, with the easiest and most usable API we could possibly create., _(*2)

Install

To easily include Particle\Validator into your project, install it via composer using the command line:, _(*3)

composer require particle/validator

Small usage example

use Particle\Validator\Validator;

$v = new Validator;

$v->required('user.first_name')->lengthBetween(2, 50)->alpha();
$v->required('user.last_name')->lengthBetween(2, 50)->alpha();
$v->required('newsletter')->bool();

$result = $v->validate([
    'user' => [
        'first_name' => 'John',
        'last_name' => 'D',
    ],
    'newsletter' => true,
]);

$result->isValid(); // bool(false).
$result->getMessages();
/**
 * array(1) {
 *     ["user.last_name"]=> array(1) {
 *         ["Length::TOO_SHORT"]=> string(53) "last_name is too short and must be 2 characters long."
 *     }
 * }
 */

Functional features

• Validate an array of data
• Get an array of error messages
• Overwrite the default error messages on rules, or error messages on specific values
• Get the validated values of an array
• Validate different contexts (insert, update, etc.) inheriting validations of the default context
• A large set of default validation rules
• Ability to extend the validator to add your own custom rules

Non functional features

• Easy to write (IDE auto-completion for easy development)
• Easy to read (improves peer review)
• Ability to separate controller and view logic
• Fully documented: validator.particle-php.com
• Fully tested: Scrutinizer
• Zero dependencies

===, _(*4)

Find more information and advanced usage examples at validator.particle-php.com, _(*5)