Go Academy · Leçon

Bibliothèques de validation

Valider des structures avec des tags

Bibliothèques de validation est une leçon Go Academy gratuite sur CoddyKit. Ceci est la leçon 3 sur 4. Tu peux lire la leçon complète ci-dessous gratuitement — puis la pratiquer en direct dans le navigateur avec un éditeur de code intégré et un tuteur IA 24/7. Elle fait partie du parcours d'apprentissage Go Academy, et ta progression se synchronise sur le web et l'application CoddyKit. Le cours Go Academy comprend 4 leçons au total.

Pourquoi valider les structures

Avant d’utiliser des données reçues d’un formulaire ou d’une API, vous devez souvent les vérifier : champs obligatoires, adresse e-mail valide, plages de valeurs. Les bibliothèques de validation automatisent cette tâche à l’aide de balises de structure.

La balise validate

Les bibliothèques populaires comme go-playground/validator lisent une balise validate qui décrit les règles applicables à chaque champ.

Un champ peut contenir validate:"required,email".

Une dépendance externe

Les bibliothèques de validation sont des paquets tiers, qui ne font pas partie de la bibliothèque standard. Vous les ajoutez avec go get github.com/go-playground/validator/v10. Elles ne peuvent pas s’exécuter dans un extrait autonome ici.

Définir les règles

La balise validate de chaque champ répertorie les règles séparées par des virgules. Règles courantes : required, email, min, max, len.

Exemple de structure

Une structure typique soumise à validation. (Exemple conceptuel : le paquet de validation est nécessaire pour l’exécuter.)

type SignupForm struct {
	Email    string "validate:\"required,email\""
	Password string "validate:\"required,min=8\""
	Age      int    "validate:\"gte=18,lte=120\""
}

Exécuter la validation

Vous créez une instance de validateur et appelez Validate.Struct(form). La fonction renvoie une erreur si une règle échoue, ou nil si toutes les règles sont respectées.

import "github.com/go-playground/validator/v10"

var validate = validator.New()

func check(f SignupForm) error {
	return validate.Struct(f)
}

Lire les erreurs

En cas d’échec, l’erreur renvoyée peut être convertie en validator.ValidationErrors, une liste décrivant chaque règle enfreinte : le champ concerné et la contrainte qui a échoué.

Règles intégrées courantes

Parmi les règles utiles :

required - la valeur ne doit pas être nulle
email - format d’adresse e-mail valide
min / max - limites de longueur ou de valeur numérique
gte / lte - comparaisons numériques
oneof - la valeur doit faire partie d’une liste

Valider les structures imbriquées

Les validateurs parcourent automatiquement les structures imbriquées. Un champ qui est lui-même une structure est également soumis à ses propres règles, ce qui permet de valider tout le graphe d’objets en un seul appel.

Pourquoi utiliser une bibliothèque

Écrire manuellement la validation de chaque champ est fastidieux et source d’erreurs. La validation fondée sur les balises permet de conserver des règles déclaratives, à côté des champs, et cohérentes dans toute votre application.

Alternative manuelle

Pour les cas simples, vous pouvez valider les données manuellement sans bibliothèque ; pour de nombreux champs et des règles complexes, une bibliothèque est préférable. Cette approche s’exécute partout puisqu’elle utilise uniquement la bibliothèque standard.

package main

import (
	"errors"
	"fmt"
	"strings"
)

func validateEmail(e string) error {
	if !strings.Contains(e, "@") {
		return errors.New("invalid email")
	}
	return nil
}

func main() {
	fmt.Println(validateEmail("bad"))
	fmt.Println(validateEmail("a@b.com"))
}

Vérification rapide

Comment une bibliothèque de validation comme go-playground/validator sait-elle quelles règles appliquer à chaque champ ?

Récapitulatif

Les bibliothèques de validation :

Lisent une balise validate pour appliquer des règles
Sont tierces (par exemple go-playground/validator) et s’ajoutent avec go get
Renvoient des erreurs répertoriant chaque règle qui a échoué
Permettent de valider manuellement les cas simples

Questions Fréquemment Posées

La leçon « Bibliothèques de validation » est-elle gratuite ?

Oui — le texte complet de « Bibliothèques de validation » est gratuit à lire ici sur le web. Pour la pratiquer de manière interactive (un éditeur de code intégré et un tuteur IA 24/7) et déverrouiller le reste du cours Go Academy, passe à CoddyKit PRO. Le cours Go Academy comprend 4 leçons au total.

Qu'est-ce que j'apprendrai dans « Bibliothèques de validation » ?

Valider des structures avec des tags Tu pratiques Go Academy avec du code pratique que tu exécutes directement dans le navigateur, et un tuteur IA 24/7 répond à tes questions au fur et à mesure que tu avances dans la leçon.

Dois-je avoir de l'expérience pour commencer Go Academy ?

Aucune expérience préalable n'est requise. Go Academy sur CoddyKit est structuré pour les débutants jusqu'aux apprenants avancés, donc tu peux commencer ici ou depuis le début et avancer à ton rythme. Ceci est la leçon 3 sur 4.

Combien de temps prend la leçon « Bibliothèques de validation » ?

La plupart des leçons CoddyKit prennent environ 5–10 minutes. Chacune est courte et interactive, tu progresses régulièrement et tu repiques exactement où tu t'es arrêté sur le web et l'app.

Peux-tu écrire et exécuter du code dans cette leçon Go Academy ?

Oui. Chaque leçon Go Academy inclut un éditeur de code intégré, tu écris et exécutes du vrai code directement dans ton navigateur et tu reçois des retours IA instantanés — aucune configuration locale requise.

Toutes les leçons de ce cours

← Retour à Go Academy