Keyboard shortcuts

Press ← or → to navigate between chapters

Press S or / to search in the book

Press ? to show this help

Press Esc to hide this help

Valider les entrées : Respect/Validation

Chaque formulaire, chaque charge utile d’API, chaque envoi de CSV pose la mĂȘme question : ces donnĂ©es sont-elles utilisables ? Respect/Validation y rĂ©pond avec des rĂšgles lisibles et chaĂźnables, sans avoir besoin du cycle de requĂȘte d’un framework autour.

composer require respect/validation
<?php
require 'vendor/autoload.php';

use Respect\Validation\Validator as v;

$validator = v::key('email', v::email())
    ->key('age', v::intVal()->between(18, 120))
    ->key('username', v::alnum()->length(3, 20));

try {
    $validator->assert([
        'email' => '[email protected]',
        'age' => 34,
        'username' => 'ada_l',
    ]);
    echo "Valid.\n";
} catch (\Respect\Validation\Exceptions\NestedValidationException $e) {
    foreach ($e->getMessages() as $message) {
        echo "- {$message}\n";
    }
}

Les rùgles se lisent presque comme de l’anglais et se combinent librement. v::stringType()->notEmpty()->length(1, 255) ou v::arrayType()->each(v::stringType()) couvrent l’essentiel des besoins d’un formulaire ou d’une API, sans rùgle sur mesure.

Quand le choisir

Un script ou un petit service qui reçoit des donnĂ©es de l’extĂ©rieur : un import CSV, un rĂ©cepteur de webhooks, une API lĂ©gĂšre. Tout un framework pour sa seule couche de validation serait disproportionnĂ©.

Quand ce n’est pas le bon outil

DĂšs que vous ĂȘtes dans Laravel ou Symfony. $request->validate() et le composant Validator de Symfony sont cĂąblĂ©s aux formulaires et Ă  l’affichage des erreurs de leur framework, et sont lĂ  le meilleur choix par dĂ©faut.

Sous le capot : les bibliothĂšques de validation s’appuient sur le systĂšme de types de PHP bien plus qu’autrefois. Sous les appels fluides comme v::intVal(), les versions rĂ©centes dĂ©crivent « valide » avec les types union et les enums de PHP plutĂŽt qu’en rĂ©inventant les vĂ©rifications de type.