Formations — 1 037 leçons en français

Accueil › Vue.js › Variables d'environnement et secrets

Variables d'environnement et secrets

Mise en productionavance

Vite expose les variables d'environnement au code client par import.meta.env, et applique un filtre strict : seules les variables dont le nom commence par VITE_ y arrivent.

# .env.production
VITE_API_URL=https://api.boutique.fr
VITE_TITRE=Boutique
ADMIN_TOKEN=abc123
const base = import.meta.env.VITE_API_URL   // "https://api.boutique.fr"
const token = import.meta.env.ADMIN_TOKEN   // undefined

Le point décisif est le moment où cela se produit. Ce n'est pas une lecture à l'exécution : Vite remplace textuellement import.meta.env.VITE_API_URL par la chaîne, au moment du build. Le fichier produit contient "https://api.boutique.fr" en clair.

Tout ce qui est préfixé VITE_ est donc public. Un visiteur ouvre le fichier JavaScript de dist/assets/ et lit la valeur. La minification renomme les identifiants, pas les littéraux de chaîne.

Vite fournit aussi quelques variables intégrées, utiles pour conditionner du code.

if (import.meta.env.DEV) {
  console.log('mode', import.meta.env.MODE)
}

La règle tient en une phrase : une clé d'API privée, un jeton, un mot de passe n'ont rien à faire dans une application cliente. Ils vivent derrière un service serveur qui les ajoute lui-même à l'appel sortant.

Les termes à connaître

import.meta.env

L'objet par lequel Vite expose les variables d'environnement au code client. Ses valeurs sont remplacées textuellement au build, pas lues à l'exécution.

Préfixe VITE_

Seules les variables dont le nom commence par VITE_ sont exposées au code client par Vite. Les autres restent côté outil de build.

Fichier .env

Fichier de variables chargé par Vite selon le mode. .env s'applique à tous les modes, .env.production au seul mode production.

Mode

Le nom du jeu de variables utilisé par la commande. vite build utilise production par défaut, vite dev utilise development.

import.meta.env.PROD

Booléen fourni par Vite, vrai dans un build de production. DEV est son complément, et MODE contient le nom du mode.

Secret

Une valeur qui donne un pouvoir à qui la détient : clé d'API privée, jeton, mot de passe. Placée dans le code client, elle est publique.

Lire l'explication détaillée et faire le quiz →

Cette page présente la partie essentielle de la leçon. Les exemples commentés, les pièges courants et les trois questions de quiz sont dans l'application.