LeçonsComment enregistrer les formulaires dans une base de données

Mini-leçon 10 sur 30 · Rendre votre site utile

Définissez ce que signifie enregistrer

À qui s’adresse cette leçon ?

Pour les personnes souhaitant conserver les soumissions du site. L’assistant peut appliquer la configuration fournie et connecter le formulaire ; aucun SQL ni code serveur à écrire.

L’enregistrement doit exister hors de la page actuellement ouverte.

Objectif de cette leçon

  • Envoyez un enregistrement de formulaire vers un vrai stockage.
  • Vérifiez sa persistance dans la vue de table du fournisseur.
  • Rejetez les saisies invalides sans exposer les enregistrements de tous.
Explications, exemple détaillé et exercices

Avant de commencer

Vos propres projets Supabase jetable et Netlify de fonctions sont nécessaires. Utilisez les fichiers complets fournis et un assistant pour les configurer. Gardez les identifiants privés de base de données sur le serveur et ne testez que des messages fictifs. Les corrigés sont des exemples, pas des tests effectués sur votre compte. Remplacez leurs observations par vos propres résultats ou précisez l’étape qui reste bloquée.

Vérifiez vos acquis de départ

Ce sont des compétences utiles, pas des cours obligatoires bloquants. Si vous les maîtrisez, commencez ici ; sinon, ouvrez la préparation. Les fichiers fournis remplacent un site personnel préalable.

  1. Comment publier votre site depuis GitHub

    Connectez un dépôt d’exercice à l’hébergement.

Durée estimée: 20–37 min

Estimations avec les fichiers fournis et les comptes et outils requis déjà prêts. La configuration, les files de déploiement et les délais de messagerie ou de DNS demandent du temps supplémentaire. La configuration de compte s’ajoute. Cet atelier restreint n’est pas un service public de commentaires anonymes ; examinez les limites durables contre les abus avant adaptation publique.

Comprendre le principe

Ouvrez le formulaire prêt avec l’assistant et choisissez un message fictif reconnaissable. Nous l’enregistrerons via le serveur fourni dans une base d’exercice distincte.

Une valeur encore affichée dans la page ne prouve pas le stockage en base. Prévoyez de retrouver le même message chez le fournisseur et après réouverture.

Un exemple concret

La table du fournisseur et la page ouverte sont deux endroits différents. Un message toujours dans la table après fermeture de l’application démontre davantage qu’une phrase restée près du bouton d’envoi.

Utilise le projet de stockage de retours fourni. Aide-moi à appliquer son schéma uniquement à ma base Supabase d’exercice distincte et à configurer l’environnement serveur privé. Restreins l’accès des visiteurs à la table. Démarre le formulaire, guide-moi vers la vue de table fournisseur et aide-moi à vérifier la persistance des données valides et l’absence de ligne pour les requêtes invalides. Explique mes vérifications, pas la syntaxe SQL.

Fichiers de cette étape

Commencer iciFichiers de l’atelier

Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

À vous de jouer

Où regarderez-vous pour vérifier l’enregistrement réel de votre message ?

Afficher une solution détaillée

Exemple de réponse : J’enverrai le texte fictif « D1 — blue notebook », retrouverai exactement ce message dans la vue propriétaire de feedback, puis fermerai et rouvrirai l’application pour vérifier sa présence. L’étiquette du formulaire n’est que la première réponse visible.

Éléments d’une réponse solide

  • Identifie l’enregistrement correspondant dans la base du fournisseur comme preuve de stockage.
  • Inclut une fermeture/réouverture ou un rechargement au lieu de se fier à une réussite temporairement affichée.
Comment ça marche (facultatif)

Stockez un enregistrement hors du navigateur

Une ligne enregistrée doit exister après fermeture de la page.

Une variable JavaScript disparaît avec sa page. Le stockage local reste dans ce navigateur. Une base conserve les données sur un service auquel l’application accède avec des autorisations explicites.

Nous utiliserons une table Supabase privée et une fonction serveur. Le navigateur envoie un petit message ; le serveur valide et écrit la ligne. La leçon n’expose pas de point d’accès public listant les messages de tous.

Exemple détaillé

Après l’envoi de “Database test D1”, fermez la page et retrouvez ce message exact dans l’éditeur de table. Un message uniquement affiché sur la page ne prouve pas le stockage.

Supabase : base de données

Exercice technique complémentaire

La page affiche le message envoyé depuis une variable locale. Cela prouve-t-il son enregistrement en base ?

Afficher une solution détaillée

Non. Vérifiez la véritable ligne. Le navigateur pourrait afficher la saisie même sans requête serveur.

  • Distingue l’affichage du stockage.
  • Vérifie la ligne correspondante par une vue autorisée de la base.

Étape 1 · Comment enregistrer les formulaires dans une base de données

Préparez le projet de stockage isolé

Faites appliquer sûrement la configuration fournie par l’assistant.

Explications, exemple détaillé et exercices

Comprendre le principe

Créez ou choisissez votre projet Supabase jetable. Demandez d’examiner et d’appliquer schema.sql à cet endroit, de configurer les valeurs privées et d’exécuter le projet complet avec run-locally.txt.

Confirmez le bon projet avant les changements. Empêchez les visiteurs publics de parcourir tous les retours ; examinez la ligne de test dans le Table Editor du propriétaire.

Un exemple concret

La table feedback fournie contient un message, un identifiant généré et une date de création. Le propriétaire peut l’inspecter chez le fournisseur ; les visiteurs n’ont pas besoin de lire tous les retours pour réaliser ce test.

Fichiers de cette étape

Commencer iciFichiers de l’atelier

Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

À vous de jouer

Quel projet d’exercice avez-vous préparé et savez-vous identifier sa vue de table propriétaire ?

Afficher une solution détaillée

Exemple de préparation : L’assistant a appliqué schema.sql uniquement à mon projet jetable, configuré les valeurs privées du serveur et démarré l’application. En tant que propriétaire, je peux inspecter feedback dans Table Editor. Les visiteurs publics ne peuvent toujours pas parcourir cette table.

Éléments d’une réponse solide

  • Identifie le projet jetable et l’étape de configuration du schéma/serveur terminée ou encore bloquée.
  • Repère Table Editor pour le propriétaire de feedback sans ouvrir la lecture aux visiteurs.
Comment ça marche (facultatif)

Créez une table privée d’entraînement

Activez la sécurité par ligne et gardez fermé l’accès direct du navigateur dans ce parcours.

Exécutez ce schéma seulement dans le projet Supabase isolé identifié dans votre configuration. L’accès navigateur est volontairement restreint ; vérifiez comme propriétaire dans Dashboard → Table Editor. Ne lancez pas ce schéma en production.

Créez un projet Supabase séparé et exécutez schema.sql dans son éditeur SQL. La table possède un ID généré, un message contraint et un horodatage serveur. N’exécutez pas de changements d’exemple dans une base de production sans rapport.

Le script active la sécurité par ligne et retire les droits de table aux rôles navigateur. La clé secrète/service-role autorise l’écriture privilégiée ; elle doit rester au serveur. Une clé publiable est différente et ne donne pas ces permissions administratives.

Ouvrez Table Editor dans le tableau de bord Supabase pour examiner la ligne ; ce n’est pas la console du navigateur. Si l’insertion échoue, vérifiez la réponse serveur et les réglages de base et schéma. N’autorisez pas SELECT anonyme simplement pour observer une insertion.

Pour la séquence locale complète, ouvrez run-locally.txt : préparez l’environnement privé de la racine, liez uniquement le projet d’entraînement et démarrez le proxy de fonctions Netlify. server-env.example.txt liste les noms des variables sans vrais secrets. Ouvrir seulement le HTML ne lance pas le serveur.

Exemple détaillé

Aucune règle générale autorisant tout n’est nécessaire dans cet atelier médié par serveur. Autoriser SELECT anonyme pour diagnostiquer exposerait aussi les messages.

create table public.feedback (
 id uuid primary key default gen_random_uuid(),
 message text not null check (char_length(message) between 1 and 1000),
 created_at timestamptz not null default now()
);
alter table public.feedback enable row level security;
revoke all on public.feedback from anon, authenticated;
grant insert on public.feedback to service_role;
-- No browser read/write policies: the practice server uses its secret key.

Supabase : sécurité au niveau des lignes · Node.js : état de prise en charge des versions

Exercice technique complémentaire

Une requête navigateur est refusée. Faut-il autoriser les anonymes à lire toute la table de commentaires ?

Afficher une solution détaillée

Non. Ce modèle refuse volontairement les lectures navigateur. Vérifiez l’écriture serveur et examinez la table comme propriétaire.

  • Préserve la frontière de données privées prévue.
  • Utilise la route serveur ou le tableau de bord autorisé plutôt qu’une lecture globale.

Étape 2 · Comment enregistrer les formulaires dans une base de données

Soumettez un enregistrement depuis la page

Laissez le serveur prêt à l’emploi effectuer l’écriture.

Explications, exemple détaillé et exercices

Comprendre le principe

Ouvrez la véritable application locale ou hébergée et soumettez un message tel que D1. Demandez de garder uniquement les champs visiteurs prévus dans l’enregistrement.

Retrouvez le texte exact D1 dans la table fournisseur et examinez identité/heure générées. Excluez les secrets du compte des captures et notes partagées.

Un exemple concret

Envoyez D1, puis retrouvez ce texte exact dans feedback. L’identifiant généré distingue cette ligne d’un ancien message similaire ; le visiteur ne doit ni le choisir ni le remplacer.

Fichiers de cette étape

Commencer iciFichiers de l’atelier

Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

À vous de jouer

Qu’est-il apparu dans le formulaire et chez le fournisseur pour D1 ?

Afficher une solution détaillée

Exemple de sauvegarde : Le formulaire a annoncé un message enregistré. J’ai retrouvé « D1 — blue notebook » dans feedback avec un identifiant généré et une date de création. J’ai gardé cet identifiant dans mes notes privées pour reconnaître la même ligne ensuite.

Éléments d’une réponse solide

  • Associe le texte D1 exact à une ligne fournisseur possédant une identité et une date générées.
  • Rapporte séparément les résultats de la page et du stockage sans partager la configuration privée.
Comment ça marche (facultatif)

Reliez une écriture serveur validée

Le serveur choisit la table et les champs permis ; l’appelant fournit seulement le message.

Configurez les trois variables nommées et déployez ou lancez le projet de fonction séparé. La personne qui teste saisit le code d’accès. Il autorise ce point d’accès restreint, pas le compte Supabase.

Lisez mini-feedback.mjs : la fonction vérifie méthode, code, taille et message avant l’appel fournisseur. Elle ignore les ID et noms de table de l’appelant et n’annonce le stockage qu’après une réponse d’insertion réussie.

Exemple détaillé

Un champ admin supplémentaire ne devient pas une mise à jour administrative : le serveur construit un nouvel objet contenant seulement message.

Exercice technique complémentaire

Pourquoi construire {message} au lieu de transmettre tout le JSON navigateur à la base ?

Afficher une solution détaillée

Cela rend le schéma accepté explicite et empêche des champs inattendus d’être écrits. Validez aussi le message ; sélectionner les champs ne suffit pas.

  • Limite les champs modifiables.
  • Ne fait pas confiance aux ID, horodatages et privilèges contrôlés par le client.

Étape 3 · Comment enregistrer les formulaires dans une base de données

Vérifiez persistance et échec

Répétez l’action après fermeture de la première page.

Explications, exemple détaillé et exercices

Comprendre le principe

Fermez puis rouvrez l’application et vérifiez que D1 existe toujours dans le stockage. Essayez une saisie absente/trop longue et un mauvais code dans ce projet jetable.

Les essais invalides ne doivent pas créer de lignes. Un ancien message de réussite ne doit pas rester comme si une tentative ultérieure ratée avait aussi été enregistrée.

Un exemple concret

Notez la ligne valide avant les tests négatifs, puis inspectez la table après. « Le formulaire a montré une erreur » et « aucune ligne invalide n’a été ajoutée » sont deux éléments utiles du contrôle.

Fichiers de cette étape

Commencer iciFichiers de l’atelier

Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

À vous de jouer

Quels enregistrements sont restés après réouverture et que s’est-il passé pour les essais invalides ?

Afficher une solution détaillée

Exemple de test négatif : Après fermeture et réouverture, D1 restait dans la table. Les essais vides, trop longs et avec mauvais code n’ont créé aucune ligne. La tentative échouée affichait une erreur au lieu de laisser l’ancien Saved message comme s’il s’appliquait à nouveau.

Éléments d’une réponse solide

  • Vérifie que l’enregistrement valide identifié reste présent après réouverture.
  • Vérifie que les saisies ou accès invalides n’ajoutent aucune ligne et ne laissent pas une fausse réussite affichée.
Comment ça marche (facultatif)

Vérifiez la persistance et les échecs

Utilisez des données distinctives et examinez la base indépendamment de la page.

Envoyez D1 avec le bon code et trouvez sa ligne dans l’éditeur. Fermez et rouvrez la page, puis confirmez la persistance. Notez ID et horodatage sans partager de secrets de compte.

Essayez un message absent, trop long et un mauvais code. Aucun ne doit créer de ligne. Dans un environnement jetable, vérifiez qu’une configuration serveur manquante produit un échec honnête.

Exemple détaillé

Une ligne valide et deux requêtes invalides refusées informent plus que trois clics réussis répétés. Évitez les vrais commentaires personnels au premier atelier.

Exercice technique complémentaire

Le serveur renvoie une erreur, mais le navigateur affiche encore “Saved” (enregistré) d’un essai précédent. Que vérifier ?

Afficher une solution détaillée

Vérifiez si la nouvelle valeur a une ligne. L’interface doit montrer l’échec actuel ; une réussite antérieure ne compte pas pour cet essai.

  • Vérifie la réponse courante et une nouvelle valeur distinctive.
  • Ne reprend pas une ancienne réussite comme preuve d’une requête échouée.

Étape 4 · Comment enregistrer les formulaires dans une base de données

Ajoutez un sujet sans ouvrir les données

Utilisez l’assistant pour modifier le champ et examinez le résultat.

Explications, exemple détaillé et exercices

Comprendre le principe

Demandez à l’assistant d’ajouter Project et Question au formulaire, au stockage et à la validation serveur. Leurs valeurs stockées sont project et question. La référence fournie sert de comparaison après votre tentative, pas de document où découvrir obligatoirement la consigne.

Créez un enregistrement contrôlé par sujet et essayez other, non pris en charge, avec l’aide de l’assistant. Vérifiez les deux valeurs et le refus en gardant feedback inaccessible aux visiteurs.

Un exemple concret

Ajoutez les deux sujets autorisés Project et Question. Chaque valeur choisie doit être stockée avec son message. Other teste un refus : un joli sélecteur ne suffit donc pas à terminer le changement de stockage.

Fichiers de cette étape

Commencer iciFichiers de l’atelier

Ouvrez ou téléchargez les fichiers ci-dessous. Enregistrez le projet en conservant les chemins indiqués.

À vous de jouer

Fournissez la modification du sujet et les résultats de stockage valides/invalides observés.

Travail à rendre: Un relevé expurgé montrant la persistance valide et les tentatives invalides rejetées.

Afficher une solution détaillée

Exemple d’extension : « D2 — project test » a persisté avec project ; « D3 — question test » avec question. La valeur other a été refusée sans nouvelle ligne. J’ai inspecté ces résultats comme propriétaire ; la lecture de toute la table par les visiteurs est restée interdite.

Éléments d’une réponse solide

  • Sauvegarde les valeurs Project et Question avec les enregistrements contrôlés correspondants.
  • Refuse un sujet non pris en charge tout en empêchant les visiteurs de parcourir feedback.
Comment ça marche (facultatif)

Votre devoir : stocker un sujet validé

Étendez ensemble le modèle et le serveur sans ouvrir les permissions navigateur.

Ajoutez une colonne topic limitée à project ou question. Faites valider la liste au serveur et construire explicitement l’objet inséré. Ajoutez le contrôle correspondant au formulaire.

Créez un enregistrement par sujet autorisé et rejetez une valeur non admise. Gardez ID et horodatages générés sous contrôle de la base.

DEFAULT attribue question aux lignes existantes dans cet exercice. Sans valeur ni défaut, ajouter une colonne NOT NULL peut échouer si des lignes existent. Pour une vraie migration, choisissez le remplissage selon les données plutôt qu’en copiant ce défaut.

Exemple détaillé

La contrainte de base renforce la validation serveur. Aucune ne remplace le rôle de l’autre pour des erreurs claires et l’intégrité des données.

Le parcours de référence complet est disponible dans reference/assignment-walkthrough.txt. Comparez ses étapes avec votre résultat ; remplissez le relevé de test à partir de vos propres observations sur votre projet.

-- Existing rows need a value when the new column is NOT NULL.
alter table public.feedback add column topic text not null default 'question';
alter table public.feedback add constraint feedback_topic_allowed
 check (topic in ('project','question'));

Exercice technique complémentaire

Ajoutez le sujet et prouvez la persistance des données valides et le rejet des invalides.

Afficher une solution détaillée

Les trois couches doivent concorder : select navigateur, liste autorisée serveur et colonne avec contrainte de base. ALTER TABLE de référence gère les lignes existantes en assignant le sujet par défaut documenté avant d’imposer la contrainte.

Le serveur écrit seulement {message,topic}. Il doit rejeter un sujet non admis avant d’utiliser la clé secrète. Il ignore aussi ID et tables fournis par le client et rapporte un échec fournisseur comme tel.

Examinez message et sujet exacts dans Table Editor de Supabase, pas un paragraphe de réussite client. Rechargez ou fermez le navigateur et vérifiez le même enregistrement. Utilisez les diagnostics de votre compte ; n’exposez pas des lectures anonymes pour dépanner.

  • La validation du sujet existe au serveur et dans la base.
  • Les lignes valides persistent et les valeurs non admises ne créent pas de lignes.

Cette leçon vous a-t-elle été utile ?

Laissez un J’aime ou partagez-la avec quelqu’un qui pourrait en profiter.