Variables d'environnement

Q: Mes collaborateurs voient-ils mes variables ?

Les personnes avec qui vous partagez le projet en Édition travaillent dans le même projet, menu Variables compris. Ne donnez l'accès en édition qu'à des personnes de confiance.

Beaucoup de sites ont besoin de valeurs secrètes : une clé de paiement, un jeton d'accès à un service externe, le mot de passe d'un service d'e-mail. Elles ne doivent jamais être écrites dans le chat ni dans les pages de votre site. FromScratch donne à chaque projet un menu Variables prévu pour cela.

Ce qu'est une variable

Une variable est un couple CLÉ = valeur, par exemple STRIPE_API_KEY = sk_live_…. Votre application lit la valeur par sa clé quand elle tourne, sans que la valeur apparaisse jamais dans le code ni dans la conversation. Les noms utilisent des lettres, des chiffres et des tirets bas, et ne commencent pas par un chiffre ; par convention, ils sont en majuscules.

Ajouter ou modifier une variable

Ouvrez le projet et cliquez sur Variables dans la barre du haut. Le panneau s'intitule « Variables d'environnement ».
Dans la ligne vide, tapez le nom dans CLÉ et la valeur dans valeur, puis cliquez sur Ajouter.
Recommencez pour chaque variable. Les valeurs sont masquées ; utilisez Afficher / Masquer pour en vérifier une, et le bouton de suppression pour retirer une ligne.
Cliquez sur Enregistrer. Le message « Variables enregistrées — actives au prochain redémarrage du backend, et mises à jour sur le site publié » confirme l'enregistrement.

Attention
ne collez jamais une clé secrète dans le chat, même pour « aider » l'agent. Mettez-la dans Variables, puis donnez à l'agent le nom de la variable (« la clé est dans STRIPE_API_KEY »). L'agent a lui aussi pour consigne de ne jamais afficher les clés.

Où vont les variables

Dans l'aperçu : les valeurs sont écrites dans le fichier de réglages de votre projet (le panneau indique lequel) et utilisées au prochain redémarrage du serveur de votre application. L'agent peut le redémarrer : demandez-lui simplement d'utiliser la nouvelle valeur.
Sur le site publié : les variables sont injectées dans le site en ligne comme de vraies variables d'environnement. Si le projet est déjà publié, l'enregistrement met le site en ligne à jour aussitôt (il redémarre avec les nouvelles valeurs), sans republier. Une nouvelle publication relit aussi les dernières valeurs juste avant la mise en ligne.

FromScratch ne gère que son propre bloc de variables : si l'agent a ajouté ses propres réglages dans le même fichier, ils sont conservés quand vous enregistrez.

Usages courants

Besoin	Variables
Paiement par carte dans une boutique (vos propres clés)	`STRIPE_API_KEY` + `STRIPE_PUBLISHABLE_KEY` — ou Connecter Stripe dans Paiements, qui les remplit pour vous
Importer un catalogue Shopify qui bloque l'accès public	`SHOPIFY_ACCESS_TOKEN` + `SHOPIFY_STORE_DOMAIN` (ou `SHOPIFY_CLIENT_ID` + `SHOPIFY_CLIENT_SECRET`)
Tout service externe appelé par votre app	les noms de clés que l'agent vous demande

Exemple de prompt

J'ai ajouté la clé de mon service météo dans Variables sous le nom WEATHER_API_KEY. Utilise-la pour afficher la météo du jour à Lyon sur la page d'accueil.

Voir Encaisser dans votre boutique et Ajouter des produits ou importer votre catalogue.

Variables et versions

Les secrets sont volontairement tenus à l'écart des Versions : revenir à une ancienne version ne ramène jamais une ancienne clé et n'efface pas une nouvelle.

Questions fréquentes

J'ai enregistré une variable mais rien n'a changé.

Dans l'aperçu, la valeur est prise en compte au prochain redémarrage du serveur de votre application : demandez à l'agent de l'appliquer. Sur le site en ligne, vérifiez que vous avez bien cliqué sur Enregistrer ; si le changement n'apparaît toujours pas, republiez.

Mes collaborateurs voient-ils mes variables ?

Les personnes avec qui vous partagez le projet en Édition travaillent dans le même projet, menu Variables compris. Ne donnez l'accès en édition qu'à des personnes de confiance.

Faut-il supprimer un jeton après usage ?

S'il ne servait qu'une fois (par exemple pour un import Shopify), oui : supprimez la ligne, enregistrez, et révoquez le jeton dans le service qui l'a émis.