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