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.
.envs'applique à tous les modes,.env.productionau seul mode production.- Mode
Le nom du jeu de variables utilisé par la commande.
vite buildutiliseproductionpar défaut,vite devutilisedevelopment.- import.meta.env.PROD
Booléen fourni par Vite, vrai dans un build de production.
DEVest son complément, etMODEcontient 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.
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.