Mini-leçon · Français

Comment enregistrer les formulaires dans une base de données

Enregistrez un formulaire de site dans le projet de base de données d’exercice fourni, puis vérifiez que le relevé subsiste après réouverture.

Commencer le cours interactifLire les notes du cours

À 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.

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.

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.

Ce que vous apprendrez

  • 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.

Fichiers de l’atelier

Étape 1

Définissez ce que signifie enregistrer

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

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.

Supabase : base de données

Fichiers de cette étape

Start hereFichiers de l’atelier

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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

Extra implementation exercise

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 2

Préparez le projet de stockage isolé

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

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.

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

Fichiers de cette étape

Start hereFichiers de l’atelier

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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

Extra implementation exercise

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 3

Soumettez un enregistrement depuis la page

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

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

Start hereFichiers de l’atelier

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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.

Extra implementation exercise

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 4

Vérifiez persistance et échec

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

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

Start hereFichiers de l’atelier

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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.

Extra implementation exercise

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 5

Ajoutez un sujet sans ouvrir les données

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

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

Start hereFichiers de l’atelier

Open or download the files below. When saving a project, keep the folder paths shown in the filenames.

How it works (optional)

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'));

Extra implementation exercise

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.

Poursuivre votre apprentissage

Explorer les autres leçons