README

impulsephp/validator est le moteur de validation serveur d’ImpulsePHP. Il propose un ensemble de règles prêtes à l’emploi, une API simple à consommer depuis le code métier et une intégration optionnelle avec impulsephp/translation pour retourner des messages localisés.

Ce que fait le package

valide une valeur contre une ou plusieurs règles ;
retourne la première erreur ou la liste complète des erreurs ;
accepte une syntaxe compacte de type required|email|min_length:8 ;
permet d’enregistrer des règles personnalisées ;
peut déléguer les messages à un traducteur.

Prérequis

PHP 8.2 ou supérieur.

Installation

composer require impulsephp/validator

Si votre application ne gère pas l’auto-découverte, ajoutez Impulse\Validator\ValidatorProvider à votre configuration.

Exemple d’usage complet

use Impulse\Validator\Validator;

$validator = new Validator();

$emailErrors = $validator->validate('email', 'adresse-invalide', 'required|email');
$passwordError = $validator->validateField('password', '123', 'required|min_length:8');
$allPasswordErrors = $validator->validateFieldAllErrors(
    'password',
    '123',
    'required|min_length:8'
);

Exemple sur un formulaire :

$errors = [];

$errors['email'] = $validator->validateField('email', $_POST['email'] ?? '', 'required|email');
$errors['age'] = $validator->validateField('age', $_POST['age'] ?? '', 'required|integer|min:18');

$errors = array_filter($errors);

if ($errors === []) {
    // Continuer le traitement.
}

Utilisation via le conteneur

Le provider enregistre Impulse\Validator\Contract\ValidatorInterface dans le conteneur.

use Impulse\Validator\Contract\ValidatorInterface;

$validator = $container->get(ValidatorInterface::class);

Traduction des messages

Si Impulse\Translation\Contract\TranslatorInterface est présent dans le conteneur, le provider le branche automatiquement au validateur et enregistre le namespace validator pour les messages par défaut du package.

Le validateur tentera alors de résoudre des clés comme validation.required puis validator::validation.required.

Règles disponibles

Le package enregistre notamment :

required
min_length
length
email
numeric
integer
decimal
min
max
date
date_after
date_before
time
url
phone
regex
in
choices
nullable
array
min_count
max_count
file
image
max_file_size
mime

Documentation complémentaire

Des guides plus détaillés sont disponibles dans docs/ :

docs/installation.md
docs/usage.md
docs/custom_rules.md
docs/translating_messages.md

Aller plus loin

impulsephp/validator s’intègre naturellement avec :

impulsephp/translation pour localiser les erreurs ;
impulsephp/ui pour la validation de composants de formulaire.

Tests

composer test

Licence

MIT

impulsephp / validator

Maintainers

Package info

Statistics

Security