Simplifiez la Validation de Données en PHP avec PHPValidator

La validation des données est une étape cruciale dans le développement d’applications PHP robustes. Cela garantit que les données entrantes sont conformes aux attentes, réduisant ainsi les erreurs et améliorant la sécurité. Dans cet article, nous allons explorer l’importance de la validation des données en PHP et présenter PHPValidator, un outil puissant que j’ai développé pour simplifier ce processus.

Pourquoi la validation des données est-elle importante ?

La validation des données est essentielle pour plusieurs raisons :

Sécurité : Évitez les attaques par injection et protégez-vous contre les entrées malveillantes.
Intégrité des données : Assurez-vous que les données respectent le format attendu pour éviter des erreurs inattendues.
Expérience utilisateur : Fournissez des commentaires clairs et précis pour guider les utilisateurs lors de la saisie des données.

PHPValidator : Simplifiez la validation des données en PHP

PHPValidator est une bibliothèque de validation de données open source que j’ai créée pour faciliter la validation en PHP. Elle offre une gamme de règles prédéfinies, tout en permettant aux développeurs d’ajouter leurs propres règles personnalisées.

Installation

L’installation de PHPValidator est simple à l’aide de Composer. Exécutez la commande suivante dans votre terminal :

composer require blakvghost/php-validator

Utilisation de PHPValidator

use BlakvGhost\PHPValidator\Validator;
use BlakvGhost\PHPValidator\ValidatorException;

try {

    $data = [
        'username' => 'BlakvGhost',
        'email' => 'example@example.com',
        'score' => 42,
    ];
    // or
    // $data = $_POST;

    $validator = new Validator($data, [
        'username' => 'required|string',
        'email' => 'required|email',
        'score' => ['required','max:200', new CustomRule()],
        'password' => new CustomRule(),
    ]);

    if ($validator->isValid()) {
        echo "Validation passed!";
    } else {
        $errors = $validator->getErrors();
        print_r($errors);
    }
} catch (ValidatorException $e) {
    echo "Validation error: " . $e->getMessage();
}

Vous pouvez également personnaliser les messages d’erreur de validation

$data = [
    'username' => 'BlakvGhost',
];

$validator = new Validator(
    $data,
    [
        'username' => 'required|string',
    ],
    [
        'username' => [
            'required' => 'Votre nom d\'utilisateur doit être présent',
            'string' => 'Votre nom d\'utilisateur doit forcément être une chaîne de caractère',
            ],
        ]
    );

Création de Règles Personnalisées

Vous pouvez créer vos règles de validation personnalisées. Par exemple, une règle pour valider un numéro de téléphone :

namespace YourNameSpace\Rules;

use BlakvGhost\PHPValidator\Contracts\Rule;

class PhoneRule implements Rule
{
    protected $field;

    public function __construct(protected array $parameters = [])
    {
    }

    public function passes(string $field, $value, array $data): bool
    {
        $this->field = $field;
        // Votre logique de validation ici
        return true;
    }

    public function message(): string
    {
        return "Votre numéro de téléphone est invalide"
    }
}

Utilisez ensuite cette règle dans vos règles de validation :

    use BlakvGhost\PHPValidator\Validator;
    use BlakvGhost\PHPValidator\ValidatorException;

    use YourNameSpace\Rules\PhoneRule;


    // ...

    try {

        $data = [
            'tel' => '425555555',
        ];
        // or
        // $data = $_POST;

        $validator = new Validator($data, [
            'tel' => ['required', new PhoneRule()],
        ]);

        if ($validator->isValid()) {
            echo "Validation passed!";
        } else {
            $errors = $validator->getErrors();
            print_r($errors);
        }
    } catch (ValidatorException $e) {
        echo "Validation error: " . $e->getMessage();
    }

Ou en ajoutant votre classe personnalisée à la liste des règles et utilisez-la comme si elle était native

use BlakvGhost\PHPValidator\Validator;
    use BlakvGhost\PHPValidator\ValidatorException;
    use BlakvGhost\PHPValidator\Mapping\RulesMaped;

    use YourNameSpace\Rules\PhoneRule;

    // Add your rule here using an alias and the full namespace of your custom class
    RulesMaped::addRule('c_phone', PhoneRule::class);

    try {

        $data = [
            'tel' => '428877777',
        ];

        $validator = new Validator($data, [
            'tel' => 'required|c_phone',
        ]);

        if ($validator->isValid()) {
            echo "Validation passed!";
        } else {
            $errors = $validator->getErrors();
            print_r($errors);
        }
    } catch (ValidatorException $e) {
        echo "Validation error: " . $e->getMessage();
    }

Principales fonctionnalités de PHPValidator

Règles prédéfinies : Disposez d’un ensemble complet de règles telles que required, email, numeric, etc.
Personnalisation facile : Ajoutez vos propres règles de validation personnalisées.
Messages traduits : Utilisez des messages d’erreur traduits pour une expérience multilingue.
Intégration avec des frameworks : Intégrez facilement PHPValidator dans vos projets basés sur des frameworks tels que Laravel, Symfony, etc.

Exemple d’intégration avec Laravel

// Installation avec Composer
composer require blakvghost/php-validator

// Exemple d'utilisation dans un contrôleur Laravel
use BlakvGhost\PHPValidator\Validator;

class UserController extends Controller
{
    public function store(Request $request)
    {
        $validator = new Validator($request->all(), [
            'name' => 'required|string|max:255',
            'email' => 'required|email',
            'age' => 'numeric|min:18',
        ]);

        if ($validator->isValid()) {
            // Les données sont valides
        } else {
            // Récupérez les erreurs de validation
            $errors = $validator->getErrors();
        }
    }
}

Conclusion

PHPValidator simplifie le processus de validation des données en PHP, permettant aux développeurs de garantir que leurs applications fonctionnent avec des données fiables. Intégrez-le dans vos projets pour améliorer la sécurité, l’intégrité des données et l’expérience utilisateur.

Pour plus d’informations, consultez la documentation complète de PHPValidator sur GitHub.

N’hésitez pas à contribuer, signaler des problèmes ou proposer des améliorations. Ensemble, faisons de la validation des données en PHP une tâche simple et efficace.

Happy coding !

Blog