Aller au contenu

Comment configurer les variables d'environnement de votre application sur Daki Hosting à l'aide d'un fichier .env.

Les variables d'environnement vous permettent de transmettre des valeurs de configuration — comme le token d'un bot Discord ou une clé d'API — à votre application, sans les écrire en dur dans votre code source. Sur Daki Hosting, la méthode recommandée consiste à créer un fichier .env directement sur votre serveur, via le gestionnaire de fichiers du Portail ou via SFTP.

Ce que vous allez apprendre

  • Ce que sont les variables d'environnement et pourquoi elles comptent
  • Comment créer un fichier .env sur votre serveur
  • Comment charger les valeurs de .env en Node.js et en Python
  • Les bonnes pratiques pour garder vos secrets en sécurité

Que sont les variables d'environnement ?

Les variables d'environnement sont des paires clé-valeur que votre application en cours d'exécution peut lire depuis son environnement. C'est la méthode standard pour :

  • Stocker les valeurs sensibles (tokens, clés d'API, mots de passe) séparément du code
  • Modifier la configuration sans modifier ni redéployer les fichiers source
  • Éviter de versionner des secrets dans un système de contrôle de version

Créer un fichier .env

Le moyen le plus simple et le plus fiable de gérer les variables d'environnement sur Daki consiste à créer un fichier .env sur votre serveur. Vous pouvez le faire de deux façons :

Option 1 : gestionnaire de fichiers (modifications rapides)

  1. Ouvrez votre serveur dans le Portail (portal.daki.cc).
  2. Allez dans l'onglet Files.
  3. Cliquez sur New File et nommez-le .env.
  4. Cliquez sur le fichier pour l'ouvrir dans l'éditeur web, puis ajoutez vos variables :
    .env
    BOT_TOKEN=your_discord_bot_token_here
    PORT=3000
    DATABASE_URL=your_db_connection_string
  5. Cliquez sur Save.
  6. Redémarrez votre serveur.

Connectez-vous à votre serveur en SFTP (identifiants dans l'onglet Settings) et téléversez votre fichier .env directement depuis votre machine locale. Voir Gestionnaire de fichiers pour la configuration de SFTP.

Ne versionnez jamais votre fichier .env dans un dépôt Git public. Ajoutez .env à votre fichier .gitignore pour éviter toute exposition accidentelle de secrets.


Charger les valeurs de .env dans votre application

Les applications ne lisent pas automatiquement les fichiers .env : il faut une bibliothèque pour les charger dans l'environnement.

Installez le paquet (ajoutez-le à votre package.json comme dépendance) :

JSON
{
  "dependencies": {
    "dotenv": "^16.0.0"
  }
}

Chargez-le tout en haut de votre fichier d'entrée :

JavaScript
require('dotenv').config();

const token = process.env.BOT_TOKEN;
const port  = process.env.PORT || 3000;

Format du fichier .env

Chaque ligne d'un fichier .env suit le format CLÉ=VALEUR :

.env
# Comments start with a hash
BOT_TOKEN=your_token_here
API_KEY=some_api_key
DB_HOST=localhost
DB_PORT=5432
DEBUG=false
  • Les clés sont généralement en majuscules, avec des tirets bas.
  • Les valeurs n'ont pas besoin de guillemets, mais ceux-ci sont pris en charge.
  • Les lignes commençant par # sont des commentaires et sont ignorées.

Bonnes pratiques

  • Ne codez jamais de tokens ni de secrets en dur dans vos fichiers source, surtout si votre code est sur GitHub.
  • Ajoutez .env à votre .gitignore pour qu'il ne soit jamais versionné par accident.
  • Créez votre fichier .env sur le serveur, et non en local — ou utilisez SFTP pour téléverser un .env local qui est exclu du contrôle de version.
  • Redémarrez votre serveur après avoir créé ou modifié votre fichier .env.
  • Utilisez des noms de clés descriptifs qui rendent votre configuration auto-documentée.

Étapes suivantes