Validation des données dans Laravel: la bonne voie - Validateurs personnalisés

Les plats clés

• Le package de validation des données de Laravel peut être étendu pour créer des règles de validation personnalisées pour des besoins spécifiques, tels que la validation des noms complets ou des codes PIN qui incluent des espaces.
• Les règles de validation personnalisées sont créées en étendant la classe IlluminateValidationValidator de Laravel et en ajoutant de nouvelles méthodes pour valider les données et leurs messages d'erreur respectifs.
• Les nouvelles règles de validation doivent être nommées avec le préfixe «Valider» et le reste du nom dans le cas de titre. La règle de validation sera en minuscules de la méthode nommée (sans le préfixe «valider») et chaque mot sera séparé par un soulignement.
• Après avoir créé des règles de validation personnalisées, un fournisseur de services doit être créé pour lier ces règles dans le package de validation de Laravel. Ce fournisseur de services est ensuite chargé par Laravel via le fichier app / config / app.php.

Dans la partie précédente, nous avons appris à valider les données dans Laravel en utilisant son ensemble de validation de données intégré et comment abstraire notre validation de données en services spécifiques à l'entité pour rendre le code réutilisable sur les principes de sec. Maintenant, nous pouvons facilement créer un service de validation pour chaque entité de notre application avec ses propres règles de validation respectives, l'injecter partout où nous voulons valider les données et facilement récupérer et afficher les erreurs, etc.

Mais et si nous en voulons plus?

Le code source de ce tutoriel est disponible ici. Il vous suffit d'exécuter Installation de composer pour installer le framework Laravel dans le répertoire du projet avant de pouvoir exécuter ce code.

le besoin de plus

Hors de la boîte, Laravel fournit de nombreuses règles de validation utiles et génériques. Mais que se passe-t-il si nous en voulons plus? Et si nous avons besoin de quelque chose de plus spécifique? Dans notre exemple ici, dans TestFormValidator, nous avons utilisé alpha_dash pour valider les noms, mais ce n'est pas idéal pour valider un nom complet. Généralement, le nom complet d'une personne consisterait en un prénom et un nom de famille et peut-être également un deuxième prénom. Tout cela serait séparé par un espace. De même, si nous voulons valider le code PIN dans notre formulaire, nous ne pouvons pas utiliser la règle alpha_num fournie par Laravel, nous devrions pouvoir également permettre des espaces.

Eh bien, Laravel offre la possibilité d'étendre facilement son package de validation et d'ajouter des règles de validation personnalisées. Dans RocketCandy / Services / Validation / Créer Validatorextend.php et ajoutez-y le code suivant:

<span><span><?php </span></span><span>
</span><span><span>namespace RocketCandy<span>\Services\Validation</span>;
</span></span><span>
</span><span><span>use Illuminate<span>\Validation\Validator</span> as IlluminateValidator;
</span></span><span>
</span><span><span>class ValidatorExtended extends IlluminateValidator {
</span></span><span>
</span><span>	<span>private $_custom_messages = array(
</span></span><span>		<span>"alpha_dash_spaces" => "The :attribute may only contain letters, spaces, and dashes.",
</span></span><span>		<span>"alpha_num_spaces" => "The :attribute may only contain letters, numbers, and spaces.",
</span></span><span>	<span>);
</span></span><span>
</span><span>	<span>public function __construct( $translator, $data, $rules, $messages = array(), $customAttributes = array() ) {
</span></span><span>		<span><span>parent::</span>__construct( $translator, $data, $rules, $messages, $customAttributes );
</span></span><span>
</span><span>		<span>$this->_set_custom_stuff();
</span></span><span>	<span>}
</span></span><span>
</span><span>	<span>/**
</span></span><span><span>	 * Setup any customizations etc
</span></span><span><span>	 *
</span></span><span><span>	 * <span>@return <span>void</span>
</span></span></span><span><span>	 */
</span></span><span>	<span>protected function _set_custom_stuff() {
</span></span><span>		<span>//setup our custom error messages
</span></span><span>		<span>$this->setCustomMessages( $this->_custom_messages );
</span></span><span>	<span>}
</span></span><span>
</span><span>	<span>/**
</span></span><span><span>	 * Allow only alphabets, spaces and dashes (hyphens and underscores)
</span></span><span><span>	 *
</span></span><span><span>	 * <span>@param <span>string</span> $attribute
</span></span></span><span><span>	 * <span>@param <span>mixed</span> $value
</span></span></span><span><span>	 * <span>@return <span>bool</span>
</span></span></span><span><span>	 */
</span></span><span>	<span>protected function validateAlphaDashSpaces( $attribute, $value ) {
</span></span><span>		<span>return (bool) preg_match( "/^[A-Za-z\s-_]+$/", $value );
</span></span><span>	<span>}
</span></span><span>
</span><span>	<span>/**
</span></span><span><span>	 * Allow only alphabets, numbers, and spaces
</span></span><span><span>	 *
</span></span><span><span>	 * <span>@param <span>string</span> $attribute
</span></span></span><span><span>	 * <span>@param <span>mixed</span> $value
</span></span></span><span><span>	 * <span>@return <span>bool</span>
</span></span></span><span><span>	 */
</span></span><span>	<span>protected function validateAlphaNumSpaces( $attribute, $value ) {
</span></span><span>		<span>return (bool) preg_match( "/^[A-Za-z0-9\s]+$/", $value );
</span></span><span>	<span>}
</span></span><span>
</span><span><span>}	//end of class
</span></span><span>
</span><span>
</span><span><span>//EOF</span></span></span>

Ici, notre classe étend la classe illuminatevalidationvalidator de Laravel et ajoute deux nouvelles méthodes (validatealphadashspaces () et validatealphanumspaces ()) pour valider les données et leurs messages d'erreur respectifs avec l'espace réservé: attribut en eux que Laravel remplacerait à l'exécution par le nom du nom du tout ce qui champ de données qui est validé.

Maintenant, la chose à noter ici est comment nous nommons les méthodes. Tous les noms de la méthode de la règle de validation doivent avoir le préfixe de validation et le reste doit être dans le cas de titre (sans espaces, bien sûr). La règle de validation sera en minuscules de la méthode nommée (sans préfixe de validation) et chaque mot sera séparé par un soulignement. Donc, si nous voulons ajouter une règle de validation alpha_dash_spaces, notre méthode correspondante sera nommée validatealphadashspaces ().

Nous avons donc ajouté les règles de validation alpha_dash_spaces et alpha_num_spaces ici. Alpha_Dash_Spaces permettra aux lettres, des tirets (traits de disposition et des soulignements) et les espaces tandis que Alpha_num_spaces ne permettra que des lettres, des numéros (numéros 0-9) et des espaces.

Nous n'en avons pas encore fini avec cela, cette classe n'étend que la classe de validation de Laravel. Nous devons encore faire en sorte que Laravel le reconnaisse afin que lorsque nous ajouterons les nouvelles règles à notre service de vaidation ci-dessus, Laravel saurait comment exécuter la validation conformément à ces règles.

Laravel Docs déclare que nous pouvons le faire:

<span>Validator<span>::</span>resolver( function( $translator, $data, $rules, $messages ) {
</span>	<span>return new <span>\RocketCandy\Services\Validation\ValidatorExtended</span>( $translator, $data, $rules, $messages );
</span><span>} );</span>

et collez-le dans App / Start / Global.php ou peut-être créer un nouveau fichier dans le répertoire de l'APP et charger ce fichier dans App / Start / Global.php. Mais cela n'a pas l'air si propre, modifiant les fichiers que nous n'avons pas besoin de modifier, coller des bits et des pièces ici et là. Non, nous préférons garder tous ce code lié à la validation ensemble, nous allons donc créer un fournisseur de services et coller nos règles de validation personnalisées dans le pack de validation de Laravel.

Créer ValidationExtensionServiceProvider.php à l'intérieur de la fusée / services / validation / et ajoutez-y le code suivant:

<span><span><?php </span></span><span>
</span><span><span>namespace RocketCandy<span>\Services\Validation</span>;
</span></span><span>
</span><span><span>use Illuminate<span>\Support\ServiceProvider</span>;
</span></span><span>
</span><span><span>class ValidationExtensionServiceProvider extends ServiceProvider {
</span></span><span>
</span><span>	<span>public function register() {}
</span></span><span>
</span><span>	<span>public function boot() {
</span></span><span>		<span>$this->app->validator->resolver( function( $translator, $data, $rules, $messages = array(), $customAttributes = array() ) {
</span></span><span>			<span>return new ValidatorExtended( $translator, $data, $rules, $messages, $customAttributes );
</span></span><span>		<span>} );
</span></span><span>	<span>}
</span></span><span>
</span><span><span>}	//end of class
</span></span><span>
</span><span>
</span><span><span>//EOF</span></span></span>

Si vous avez créé un fournisseur de services dans Laravel avant d'avoir généralement utilisé la méthode Register () pour faire la liaison dont vous aviez besoin. Il s'agit de la seule méthode abstraite de la classe abstraite illumine leport-serviceprovider que nous avons étendu ici. La raison pour laquelle nous ne pouvons pas coller notre extension de validation dans registre () est qu'elle est licenciée dès que le fournisseur de services est chargé par Laravel et que nous courirons une volée d'exceptions lancées à nous alors que Laravel initialise son ensemble de validation plus tard, donc nous serions Essayez d'étendre des choses qui ne sont pas là en utilisant un objet qui n'existe pas. La méthode Boot () en revanche est licenciée juste avant la mise en déroute d'une demande, nous pouvons donc coller en toute sécurité nos affaires dans le package de validation de Laravel.

Maintenant, nous devons juste dire à Laravel de charger ce fournisseur de services et nous serions tous définis. Ouvrez votre application / config / app.php et dans le tableau des fournisseurs, ajoutez ce qui suit à la fin:

<span><span><?php </span></span><span>
</span><span><span>namespace RocketCandy<span>\Services\Validation</span>;
</span></span><span>
</span><span><span>use Illuminate<span>\Validation\Validator</span> as IlluminateValidator;
</span></span><span>
</span><span><span>class ValidatorExtended extends IlluminateValidator {
</span></span><span>
</span><span>	<span>private $_custom_messages = array(
</span></span><span>		<span>"alpha_dash_spaces" => "The :attribute may only contain letters, spaces, and dashes.",
</span></span><span>		<span>"alpha_num_spaces" => "The :attribute may only contain letters, numbers, and spaces.",
</span></span><span>	<span>);
</span></span><span>
</span><span>	<span>public function __construct( $translator, $data, $rules, $messages = array(), $customAttributes = array() ) {
</span></span><span>		<span><span>parent::</span>__construct( $translator, $data, $rules, $messages, $customAttributes );
</span></span><span>
</span><span>		<span>$this->_set_custom_stuff();
</span></span><span>	<span>}
</span></span><span>
</span><span>	<span>/**
</span></span><span><span>	 * Setup any customizations etc
</span></span><span><span>	 *
</span></span><span><span>	 * <span>@return <span>void</span>
</span></span></span><span><span>	 */
</span></span><span>	<span>protected function _set_custom_stuff() {
</span></span><span>		<span>//setup our custom error messages
</span></span><span>		<span>$this->setCustomMessages( $this->_custom_messages );
</span></span><span>	<span>}
</span></span><span>
</span><span>	<span>/**
</span></span><span><span>	 * Allow only alphabets, spaces and dashes (hyphens and underscores)
</span></span><span><span>	 *
</span></span><span><span>	 * <span>@param <span>string</span> $attribute
</span></span></span><span><span>	 * <span>@param <span>mixed</span> $value
</span></span></span><span><span>	 * <span>@return <span>bool</span>
</span></span></span><span><span>	 */
</span></span><span>	<span>protected function validateAlphaDashSpaces( $attribute, $value ) {
</span></span><span>		<span>return (bool) preg_match( "/^[A-Za-z\s-_]+$/", $value );
</span></span><span>	<span>}
</span></span><span>
</span><span>	<span>/**
</span></span><span><span>	 * Allow only alphabets, numbers, and spaces
</span></span><span><span>	 *
</span></span><span><span>	 * <span>@param <span>string</span> $attribute
</span></span></span><span><span>	 * <span>@param <span>mixed</span> $value
</span></span></span><span><span>	 * <span>@return <span>bool</span>
</span></span></span><span><span>	 */
</span></span><span>	<span>protected function validateAlphaNumSpaces( $attribute, $value ) {
</span></span><span>		<span>return (bool) preg_match( "/^[A-Za-z0-9\s]+$/", $value );
</span></span><span>	<span>}
</span></span><span>
</span><span><span>}	//end of class
</span></span><span>
</span><span>
</span><span><span>//EOF</span></span></span>

Maintenant, ouvrez App / Rocketcandy / Services / Validation / TestFormValidator.php et mettez à jour la propriété $ Règles afin que cela ressemble à ceci:

<span>Validator<span>::</span>resolver( function( $translator, $data, $rules, $messages ) {
</span>	<span>return new <span>\RocketCandy\Services\Validation\ValidatorExtended</span>( $translator, $data, $rules, $messages );
</span><span>} );</span>

Nous avons remplacé la règle de validation alpha_dash pour le nom par alpha_dash_spaces et alpha_num pour pin_code avec alpha_num_spaces.

Maintenant, si nous naviguons vers http: // / dummy / création, nous pouvons entrer des espaces dans les champs de nom et de code PIN sans aucun problème et que les données passeront la validation sur soumission.

Résumé

Donc, dans ce tutoriel en deux parties, nous avons appris à:

1. Valider les données dans Laravel en utilisant son package de validation des données intégré.
2. Utilisez l'approche orientée objet pour abstraction de la validation des données à son propre service séparé ( Responsabilité unique Achievement déverrouillé).
3. Créez nos propres exceptions personnalisées à utiliser avec notre service de validation des données (au lieu d'utiliser des valeurs vraies / fausses booléennes) et comment stocker et récupérer des erreurs.
4. Injectez notre service de validation des données dans notre contrôleur et utilisez-les.
5. Étendez le package de validation de Laravel avec nos règles de validation personnalisées et le chargez automatiquement à l'aide d'un fournisseur de services.

Notes de bas de page

Pour garder ce tutoriel au point que j'ai injecté le service de validation dans notre contrôleur et que je l'ai utilisé là-bas. Dans un projet réel, vous utiliseriez très probablement le service de validation ailleurs où vous géreriez la désinfection et le stockage des données. Idéalement, les contrôleurs doivent être sans gras et avoir le strict minimum de code.

---

Vous avez des pensées? Questions? Tirer dans les commentaires.

Des questions fréquemment posées sur la validation des données de Laravel et les validateurs personnalisés

Quels sont les avantages de l'utilisation de Laravel pour la validation des données?

Laravel est un cadre PHP populaire qui offre un système robuste et flexible pour la validation des données. Il fournit une variété de règles de validation qui peuvent être facilement appliquées à vos données, garantissant qu'il répond aux normes requises avant d'être traitées. Le système de validation de Laravel permet également des règles de validation personnalisées, vous donnant la possibilité de définir vos propres critères de validation des données. Cela peut être particulièrement utile lorsque vous devez valider les données d'une manière qui n'est pas couverte par les règles de validation intégrées de Laravel.

Comment créer des règles de validation personnalisées dans Laravel?

Laravel Perme vous pour créer des règles de validation personnalisées à l'aide de la méthode Validator :: Extende. Cette méthode prend deux paramètres: le nom de la règle de validation et une fermeture qui reçoit trois arguments - le nom d'attribut, la valeur d'attribut et un rappel d'échec. À l'intérieur de la fermeture, vous pouvez définir la logique de votre règle de validation personnalisée. Si la validation échoue, vous devez appeler le rappel d'échec avec un message d'erreur approprié.

Puis-je utiliser les règles de validation intégrées de Laravel avec mes règles personnalisées?

Oui, Laravel vous permet d'utiliser ses règles de validation intégrées aux côtés de vos règles personnalisées. Cela peut être fait en enchaînant les règles de validation dans votre logique de validation. Par exemple, vous pouvez utiliser la règle «requise» pour vous assurer qu'un champ n'est pas vide, puis utiliser une règle personnalisée pour valider le format des données.

Comment afficher les messages d'erreur de validation dans Laravel?

Laravel facilite l'affichage des messages d'erreur de validation dans vos vues. Lorsque la validation échoue, Laravel redirige l'utilisateur vers son emplacement précédent avec toutes les erreurs de validation stockées dans la session. Vous pouvez ensuite afficher ces erreurs dans vos vues à l'aide de la variable Erreurs $, qui est automatiquement mise à la disposition de toutes les vues par Laravel.

Puis-je personnaliser les messages d'erreur pour mes règles de validation personnalisées?

Oui, Laravel vous permet de personnaliser les messages d'erreur pour vos règles de validation personnalisées. Cela peut être fait en définissant vos messages personnalisés dans un fichier de langue, puis en faisant référence à ces messages dans votre logique de validation. Cela vous donne la flexibilité d'adapter vos messages d'erreur aux besoins spécifiques de votre application.

Comment valider les tableaux dans Laravel?

Laravel fournit un moyen pratique de valider les tableaux en utilisant la «notation de points». Vous pouvez spécifier le champ de tableau à valider, puis lui appliquer les règles de validation. Par exemple, si vous avez un tableau d'e-mails, vous pouvez valider chaque e-mail dans le tableau à l'aide de la règle de validation «e-mail».

Puis-je utiliser les règles de validation conditionnelle dans Laravel?

Oui, oui, oui, Laravel vous permet d'utiliser des règles de validation conditionnelle. Cela signifie que vous ne pouvez appliquer certaines règles de validation que si d'autres conditions sont remplies. Cela peut être fait en utilisant la méthode parfois sur l'instance de validateur.

Comment valider les téléchargements de fichiers dans Laravel?

Laravel fournit plusieurs règles de validation pour les téléchargements de fichiers, tels que «fichier», '' image ',' mimes 'et' taille '. Ces règles vous permettent de valider le type et la taille du fichier téléchargé, garantissant qu'il répond aux exigences de votre application.

Puis-je utiliser des règles de validation personnalisées dans les demandes de formulaire?

Oui, vous pouvez utiliser Règles de validation personnalisées dans les demandes de formulaire. Cela peut être fait en définissant les règles dans la méthode des règles de la classe de demande de formulaire. Vous pouvez ensuite utiliser ces règles lors de la validation des données de demande de formulaire.

Comment gérer les échecs de validation dans Laravel?

Lorsque la validation échoue dans Laravel, il redirige automatiquement l'utilisateur vers son emplacement précédent avec toutes les erreurs de validation stockées dans la session. Vous pouvez ensuite gérer ces erreurs dans vos vues, en les affichant à l'utilisateur d'une manière appropriée pour votre application.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!