Skip to main content

Variables d'environnement

Les variables d'environnement sont le mécanisme central de configuration de vos services sur Fransys. Elles permettent de passer des paramètres à vos applications sans les coder en dur dans votre code source.

Trois types de variables​

Variables injectées automatiquement​

Quand vous connectez deux blocs sur le canvas, Fransys génère et injecte automatiquement les variables nécessaires. Par exemple, connecter un bloc PostgreSQL à un bloc Laravel injecte DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME et DB_PASSWORD côté Laravel.

Ces variables sont synchronisées : si le bloc source change (nouveau mot de passe, nouvel host), les variables côté application sont mises à jour automatiquement.

→ En savoir plus : Connexions entre blocs

Variables personnalisées​

Vous pouvez ajouter vos propres variables via le bouton + Add a variable dans l'onglet Environment variables de chaque bloc. Définissez le nom et la valeur — la variable est immédiatement disponible pour votre service.

Variables renommées​

Lors d'une connexion entre blocs, Fransys propose un système de renommage. Chaque variable injectée affiche son nom original (côté service source) et son nouveau nom (côté application). Vous pouvez modifier ce nouveau nom pour qu'il corresponde exactement à ce qu'attend votre framework.

Par exemple, les variables Soketi (SOKETI_DEFAULT_APP_ID) sont automatiquement renommées en variables Pusher (PUSHER_APP_ID) pour une compatibilité Laravel native.

Variables protégées​

Les valeurs sensibles — mots de passe, clés API, secrets — sont masquées par défaut dans l'interface (affichées en ••••••••••). Elles ne sont jamais exposées dans les logs ou les réponses API.

Expansion de variables​

Fransys supporte l'expansion de variables : référencez une variable à l'intérieur d'une autre avec la syntaxe ${VARIABLE_NAME}.

DATABASE_URL = postgres://${DB_USER}:${DB_PASSWORD}@${DB_HOST}:${DB_PORT}/${DB_NAME}

Chaque valeur est définie une seule fois. Si le mot de passe change, vous le modifiez à un seul endroit — l'URL de connexion se met à jour automatiquement. Fini les erreurs de copier-coller et les incohérences entre variables.

Autres exemples :

REDIS_URL = redis://:${REDIS_PASSWORD}@${REDIS_HOST}:${REDIS_PORT}/0
API_BASE_URL = https://${API_HOST}:${API_PORT}/api/v1

Export​

Cliquez sur Export variables pour télécharger l'ensemble des variables d'un bloc au format .env. Utile pour synchroniser votre environnement local ou pour garder une trace de votre configuration.

Bonnes pratiques​

  • Ne codez jamais de secrets dans votre code — utilisez les variables d'environnement pour tout ce qui est sensible.
  • Connectez vos blocs sur le canvas plutôt que de saisir manuellement les variables de connexion — l'injection automatique élimine les erreurs.
  • Utilisez l'expansion pour les URLs de connexion complexes — un seul point de modification.
  • Exportez régulièrement vos variables pour maintenir une documentation à jour de votre configuration.