Connexions entre blocs
Les connexions sont le mécanisme qui relie vos blocs entre eux sur le canvas. Quand vous tracez un lien entre deux blocs, Fransys injecte automatiquement les variables d'environnement nécessaires à la communication entre les services.
Comment ça marche
- Glissez un bloc base de données ou service sur le canvas
- Tracez un lien entre votre bloc applicatif et le service
- C'est fait — Fransys génère et injecte toutes les variables automatiquement
Pas de copier-coller de credentials, pas de fichier .env à maintenir manuellement, pas de risque d'incohérence entre services.
Variables injectées automatiquement
Application → Base de données (PostgreSQL, MariaDB)
| Variable | Description |
|---|---|
DB_HOST | Adresse interne du service de base de données |
DB_PORT | Port du service |
DB_DATABASE | Nom de la base de données |
DB_USERNAME | Utilisateur de connexion |
DB_PASSWORD | Mot de passe (généré automatiquement) |
Application → Redis
| Variable | Description |
|---|---|
REDIS_HOST | Adresse interne du service Redis |
REDIS_PORT | Port du service |
REDIS_PASSWORD | Mot de passe (généré automatiquement) |
Application → Soketi
Quand vous connectez un bloc Soketi, Fransys injecte les variables et vous permet de les renommer pour correspondre à la convention de votre framework. Chaque variable affiche son nom original et le nouveau nom côté application :
| Variable originale | Renommée en | Description |
|---|---|---|
SOCKET_HOST | PUSHER_HOST | Adresse du serveur WebSocket |
SOKETI_DEFAULT_APP_ID | PUSHER_APP_ID | Identifiant de l'application |
SOKETI_DEFAULT_APP_KEY | PUSHER_APP_KEY | Clé publique |
SOKETI_DEFAULT_APP_SECRET | PUSHER_APP_SECRET | Clé secrète |
Ce renommage automatique permet à votre application Laravel d'utiliser directement les variables Pusher standard sans aucune adaptation de code.
Variables personnalisées
En plus des variables injectées automatiquement, vous pouvez ajouter vos propres variables d'environnement dans l'onglet Environment variables de chaque bloc :
- Cliquez sur + Add a variable pour ajouter une variable
- Définissez le Name et la Value
- Cliquez sur Export variables pour exporter l'ensemble au format
.env
Les mots de passe sont masqués par défaut (affichés en ••••••••••) pour des raisons de sécurité.
Expansion de variables d'environnement
Fransys supporte l'expansion de variables : vous pouvez référencer une variable à l'intérieur d'une autre en utilisant la syntaxe ${VARIABLE_NAME}.
L'exemple le plus parlant : les URLs de connexion aux bases de données. Plutôt que de dupliquer les valeurs de host, port, user, password et nom de base dans une longue chaîne de connexion, vous définissez chaque valeur une fois et composez votre URL à partir de ces variables :
DATABASE_URL = postgres://${DB_USER}:${DB_PASSWORD}@${DB_HOST}:${DB_PORT}/${DB_NAME}
Si le mot de passe change, vous le modifiez à un seul endroit. Fini les erreurs de copier-coller entre variables et les incohérences entre environnements.
Autres exemples d'expansion
# URL complète d'une API interne
API_BASE_URL = https://${API_HOST}:${API_PORT}/api/v1
# Redis URL composée
REDIS_URL = redis://:${REDIS_PASSWORD}@${REDIS_HOST}:${REDIS_PORT}/0
# Configuration Soketi
BROADCAST_URL = ws://${SOKETI_HOST}:6001/app/${PUSHER_APP_KEY}
L'expansion de variables simplifie considérablement la gestion de vos configurations. Définissez chaque valeur une seule fois, et composez des variables complexes à partir de ces briques élémentaires.
Bonnes pratiques
- Connectez vos blocs sur le canvas plutôt que de saisir manuellement les variables — vous bénéficiez de l'injection automatique et de la synchronisation.
- Utilisez l'expansion de variables pour les URLs de connexion complexes — un seul point de modification en cas de changement.
- Exportez vos variables régulièrement pour garder une trace de votre configuration.