Où se règlent les variables, selon votre formule
Une application bien construite tourne avec le même code sur votre poste, en préproduction et sur le site public. Ce qui les distingue tient dans une poignée de valeurs : l’adresse du site, la base de données, le niveau de détail des erreurs, les clés des services extérieurs. Elles vivent hors du code, dans des variables d’environnement. Ce guide dit où les poser chez NovaHoster, comment Laravel et Node.js les lisent, et pourquoi une valeur juste reste parfois sans effet.
| Votre formule | Application Laravel | Application Node.js | Pour qu’un changement s’applique |
|---|---|---|---|
| Pack START et formules sans Node.js | Application PHP déposée par FTP ou par Git ; le .env se modifie dans le gestionnaire de fichiers de Plesk ; commandes Artisan par SSH si votre formule l’ouvre (e-commerce dès START, revendeur) | Non disponible | Rien à relancer tant que la configuration n’est pas mise en cache |
| Packs BUSINESS et ULTIMATE, et les formules WordPress, e-commerce ou revendeur qui ouvrent Node.js | .env, ou l’écran Laravel de Plesk s’il figure sur la fiche du domaine ; commandes Artisan par SSH, ouvert sur demande | Panneau Node.js de Plesk : mode d’application et variables personnalisées | php artisan config:cache côté Laravel, redémarrage de l’application côté Node.js |
| Serveur VPS ou dédié | Selon votre installation : vous avez l’accès root | Selon votre installation | Selon le gestionnaire de processus que vous avez choisi |
Sur nos packs d’hébergement, une application Laravel s’installe dès START, par FTP ou par Git, comme toute application PHP. SSH et Node.js commencent au pack BUSINESS : une application Node.js est un processus à part, qui consomme sa propre mémoire à côté du site, et il lui faut les ressources réservées de ce palier. L’accès SSH, lui, s’active sur demande depuis l’espace client.
Pour Docker, pensez directement serveur dédié ou serveur VPS : il réclame l’accès root, qu’un compte mutualisé ne donne à personne. Pour la mise en ligne du code lui-même, suivez le guide pour déployer une application depuis Git ; celui-ci ne traite que de la configuration.
Local, préproduction, production : ce qui change, et rien d’autre
Avant de toucher au serveur, faites la liste des variables de l’application et décidez, pour chacune, de sa valeur dans chaque environnement. Le tableau reprend les noms du fichier .env.example livré avec Laravel 13 [1] ; une application Node.js aura ses propres noms, mais la même logique.
| Variable | Sur votre poste | En préproduction | En production |
|---|---|---|---|
APP_ENV | local | staging | production |
APP_DEBUG | true | false | false |
APP_URL | http://localhost:8000 | https://preprod.votre-domaine.tn | https://www.votre-domaine.tn |
LOG_LEVEL | debug | debug ou info | warning ou error |
DB_DATABASE, DB_USERNAME, DB_PASSWORD | Base locale | Base propre à la préproduction | Base de production |
MAIL_MAILER | log | log | smtp |
| Clés de la passerelle de paiement | Clés de test | Clés de test | Clés de production |
Deux lignes méritent une explication. APP_DEBUG reste à false dès que l’application est joignable depuis Internet, préproduction comprise : la documentation de Laravel prévient qu’un mode debug actif en ligne peut montrer des valeurs de configuration sensibles aux visiteurs [2]. MAIL_MAILER=log, valeur par défaut du squelette, écrit les messages dans le journal au lieu de les envoyer [3] : une préproduction alimentée par une copie de la base ne doit pas écrire à vos vrais clients.
Les clés de paiement suivent le même chemin. Chez les passerelles tunisiennes, l’intégration commence toujours par un environnement d’essai : la SMT déclare le commerçant ClicToPay dans son environnement de test avant de délivrer les identifiants de production, Flouci ouvre une application de test, GPG un compte de pré-production ; notre article sur le paiement en ligne détaille ces parcours. Le code ne change pas le jour de la mise en service : seules les valeurs basculent. Et si la préproduction reçoit une copie de la base de production, elle reçoit aussi les données personnelles de vos clients, avec les obligations qui vont avec (notre guide de la protection des données) : anonymisez ce qui peut l’être.
Côté Node.js, une valeur ne suit pas ce tableau : NODE_ENV vaut production partout où le code tourne pour de vrai, préproduction comprise. La documentation de Node.js recommande de toujours lancer l’application avec NODE_ENV=production, parce que des bibliothèques npm s’en servent pour leurs réglages par défaut, et range toute autre valeur parmi les antipatterns : une préproduction qui ne tourne pas comme la production ne teste plus rien [4]. Si le code doit savoir où il se trouve, donnez-lui une variable à vous, par exemple APP_STAGE=preproduction.
Laravel : le fichier .env, du poste au serveur
Ne jamais servir la racine du projet
Le .env se trouve à la racine du projet, à côté des dossiers app et config. Si le serveur web sert cette racine, il peut livrer le fichier à qui le demande. La documentation de Laravel est nette : toutes les requêtes doivent aboutir à public/index.php, et déplacer index.php à la racine exposerait de nombreux fichiers de configuration sensibles [5]. Dans Plesk, ouvrez la fiche du domaine, onglet « Hébergement et DNS », puis Hébergement, et réglez la « Racine du document » sur le dossier public de l’application, par défaut /httpdocs/public [6].
Laravel 13 exige au moins PHP 8.3 [7]. La version en service s’affiche sur la fiche du domaine, à côté de l’icône PHP ; le guide pour se connecter à Plesk et retrouver ses réglages montre où la changer.
Créer le .env du serveur, avec sa propre clé
Partez du .env.example du projet, copiez-le en .env sur le serveur et remplissez-le avec les valeurs de cet environnement. La clé APP_KEY se génère avec php artisan key:generate, qui s’appuie sur le générateur aléatoire sécurisé de PHP [8] ; lancée sur le serveur, la commande l’écrit directement dans le .env. Générez-la une fois, à l’installation : Laravel chiffre les cookies, session comprise, avec cette clé, et en changer déconnecte tous les utilisateurs et rend illisible ce qui avait été chiffré avec l’ancienne [8].
Sans SSH ni écran Laravel, sur un pack START par exemple, générez la clé sur votre poste avec php artisan key:generate --show : l’option affiche la clé sans modifier votre .env local [9]. Collez-la ensuite dans le .env du serveur avec le gestionnaire de fichiers de Plesk. Utilisez une clé propre à chaque installation, jamais celle de votre poste.
Côté dépôt, le .gitignore du squelette Laravel 13 écarte .env, .env.backup et .env.production, mais pas .env.staging ni les autres variantes [1]. Si votre équipe en crée, complétez-le ainsi, en laissant passer le modèle et les fichiers chiffrés décrits plus bas :
.env.*
!.env.example
!.env.encrypted
!.env.*.encryptedÉcrire des valeurs que Laravel comprend
Laravel lit le fichier avec la bibliothèque DotEnv [2]. Les valeurs arrivent en texte, à quelques mots réservés près : true et false deviennent des booléens, null la valeur nulle, empty une chaîne vide, et il en va de même entre parenthèses, (true) par exemple [2]. Une valeur qui contient une espace se met entre guillemets doubles :
APP_NAME="Boutique Exemple"
APP_ENV=production
APP_DEBUG=false
APP_URL=https://www.votre-domaine.tn
LOG_LEVEL=warning
# Hôte, port et utilisateur : Plesk, page Bases de données, « Infos de connexion »
DB_CONNECTION=mysql
DB_HOST=
DB_DATABASE=
DB_USERNAME=
DB_PASSWORD=
MAIL_FROM_NAME="${APP_NAME}"Sans guillemets, la première espace fait échouer la lecture de tout le fichier : le site répond par une erreur 500, et Artisan affiche « The environment file is invalid! » suivi de « Failed to parse dotenv file. Encountered unexpected whitespace at […] » [10] [11]. La dernière ligne de l’exemple reprend une valeur déjà définie, comme le fait le squelette lui-même [1].
Deux pièges guettent les mots de passe générés. Hors guillemets, # ouvre un commentaire : DB_PASSWORD=k7#Lm2 se lit k7, et la base refuse la connexion. Entre guillemets doubles, la barre oblique inverse et la suite ${…} sont interprétées. Les apostrophes simples, elles, gardent la valeur telle quelle [11] : écrivez DB_PASSWORD='…', sauf si le mot de passe contient lui-même une apostrophe.
env() dans config/, config() partout ailleurs
Une règle évite la moitié des pannes : la fonction env() ne s’appelle que dans les fichiers du dossier config, et le reste du code lit la configuration avec config() [2]. Pour une passerelle de paiement, par exemple :
// config/services.php
'paiement' => [
'mode' => env('PAIEMENT_MODE', 'test'),
'cle' => env('PAIEMENT_CLE'),
'secret' => env('PAIEMENT_SECRET'),
],
// dans un contrôleur ou un service
$secret = config('services.paiement.secret');La raison tient au cache de configuration. Au déploiement, php artisan config:cache rassemble toute la configuration dans un seul fichier, ce que la documentation recommande en production [5]. Dès lors, le .env n’est plus chargé du tout : un env() écrit dans un contrôleur renvoie null pour toute variable du .env [5]. Ce cache est le fichier bootstrap/cache/config.php [12]. Le squelette l’exclut de Git [1], mais un envoi par FTP de votre dossier local peut l’emporter, avec les valeurs de votre poste : ne le transférez jamais.
Conséquence pratique : sur un serveur où la configuration est en cache, toute modification du .env se termine par un nouveau php artisan config:cache, ou par php artisan config:clear pour revenir à la lecture directe [2]. Si vous ne pouvez lancer aucune commande Artisan (ni SSH, ni écran Laravel dans Plesk), ne mettez pas la configuration en cache : Laravel relira le .env à chaque requête.
Un seul .env par installation
Laravel sait charger un fichier par environnement, .env.staging par exemple, à une condition : que APP_ENV soit fournie de l’extérieur, par le serveur, ou que la commande reçoive l’option --env [2]. Une APP_ENV écrite dans le .env lui-même ne déclenche rien. Sur un pack, où la valeur vient justement du .env, la solution simple est la bonne : une installation par environnement, la préproduction sur son sous-domaine avec son propre .env. Le code reconnaît ensuite l’environnement courant avec App::environment() [2].
Depuis Plesk : l’écran Laravel, s’il est présent
Plesk propose une extension gratuite, Laravel Toolkit. Quand elle est installée, un bouton Laravel apparaît sur la fiche du domaine et regroupe ce dont ce guide a besoin [6] :
- le bouton Modifier, à côté de « Variables d’environnement (.env) », puis Mettre à jour, pour éditer le fichier sans client FTP ;
- les onglets Artisan, Composer et Node.js, qui lancent les commandes depuis l’interface, sans accès shell —
config:cachecompris ; - le mode Maintenance, qui montre une erreur 503 aux visiteurs pendant l’intervention, et qu’il faut penser à désactiver ensuite ;
- l’onglet Déploiement, dont le script peut enchaîner à chaque mise à jour l’installation des dépendances, les migrations et la mise en cache ; pour le modifier, l’accès SSH du domaine ne doit pas être réglé sur « Interdit ».
Plesk annonce les nouvelles valeurs en vigueur dès Mettre à jour [6]. Si votre script de déploiement met la configuration en cache, contrôlez-le avec php artisan about avant de conclure. Sans bouton Laravel, le gestionnaire de fichiers de Plesk modifie le .env aussi bien ; les commandes passent alors par SSH.
Files d’attente et tâches planifiées : les processus qui ne relisent rien
Un worker de file d’attente est un processus de longue durée : il ne voit ni le nouveau code ni la nouvelle configuration tant qu’il n’a pas redémarré. php artisan queue:restart demande à chaque worker de s’arrêter proprement après sa tâche en cours ; un gestionnaire de processus doit ensuite le relancer, et le signal passe par le cache, qui doit donc être configuré [13]. Laravel Toolkit active les files par un interrupteur ; sa documentation les décrit avec la base MySQL ou MariaDB (QUEUE_CONNECTION=database) et demande que les tâches planifiées soient activées [6].
Pour le planificateur, un réglage compte autant que le code : le fuseau. Le config/app.php de Laravel 13 écrit 'timezone' => 'UTC' en dur [1], si bien qu’une tâche prévue à 2 h part à 3 h, heure de Tunis. La Tunisie vit à UTC+1 toute l’année, sans heure d’été depuis 2009 ; son identifiant dans la base des fuseaux de l’IANA est Africa/Tunis [14]. Laravel accepte une option schedule_timezone valable pour toutes les tâches, et met en garde contre les fuseaux à heure d’été, où une tâche peut tourner deux fois ou pas du tout [15] ; avec Africa/Tunis, ce risque n’existe pas.
// config/app.php
'timezone' => 'UTC',
'schedule_timezone' => 'Africa/Tunis',Node.js : des variables passées par le panneau de Plesk
Comment Plesk démarre votre application
Sur nos packs, vous ne tapez pas node app.js. Plesk confie l’application à Phusion Passenger, qui la démarre, lui transmet les requêtes et arrête les processus inactifs ; le port ne se règle donc pas dans Plesk, qui conseille de lire process.env.PORT plutôt que d’écrire un numéro en dur [16]. Ces arrêts se remarquent : après une période sans visite, la première requête attend que Passenger relance l’application, et répond plus lentement que les suivantes. Passenger prend la main sur le premier serveur HTTP qui appelle listen(), et le port passé à cet appel n’a plus d’effet [17].
Trois conséquences. Une application qui crée deux serveurs HTTP s’arrête sur l’erreur « http.Server.listen() was called more than once ». Une application dont le fichier de démarrage n’appelle jamais listen() finit en délai dépassé : c’est le cas d’une application Express générée quand on désigne app.js [17]. Dans le champ « Fichier de démarrage d’application » du panneau Node.js, indiquez alors bin/www, et non app.js [18]. Enfin, puisque vous n’écrivez pas la commande de démarrage, une option comme --env-file n’a nulle part où se placer : les variables passent par le panneau, ou par un fichier que le code charge lui-même.
Régler le mode et les variables
Le panneau s’ouvre depuis Sites Web & Domaines : Créer un site web > Node.js la première fois, puis le bouton Node.js de la fiche du domaine [18]. Trois réglages concernent ce guide :
- « Mode d’application » fixe
NODE_ENV. Plesk propose Development et Production, ou une valeur libre, et conseille Development jusqu’à la mise en ligne ; le réglage ne fait rien par lui-même, il change le comportement des bibliothèques qui le lisent [18]. Sur un domaine public, préproduction comprise, choisissez Production. - « Variables d’environnement personnalisées » reçoit tout le reste, un nom et une valeur par variable, autant qu’il en faut (Plesk pour Linux) [18].
- La racine de l’application et la racine du document : la seconde contient les fichiers statiques servis tels quels [18]. Le code,
node_moduleset un éventuel.envrestent dans la première, jamais dans la seconde.
Pour le fuseau horaire, ajoutez TZ=Africa/Tunis parmi les variables personnalisées : Node.js prend en charge les identifiants de fuseau de base dans cette variable [19]. Et si le bouton Node.js manque sur un pack START, c’est normal : Node.js commence à BUSINESS.
Un fichier .env plutôt que le panneau ?
C’est possible depuis le code : process.loadEnvFile() charge un fichier .env dans process.env, ./.env par défaut. La fonction existe depuis Node.js 20.12 et 21.7, et n’est plus expérimentale depuis 22.21 et 24.10 [20]. Appelez-la tout en haut du fichier de démarrage, vérifiez la version de Node.js choisie dans le panneau, et gardez le fichier dans la racine de l’application, hors de Git. Ne définissez pas la même variable aux deux endroits : celui qui relira la configuration dans six mois ne saura pas laquelle l’emporte.
Sur un VPS où vous écrivez vous-même la commande de démarrage, node --env-file=.env app.js fait le même travail depuis Node.js 20.6. Si une variable existe à la fois dans l’environnement et dans le fichier, l’environnement gagne ; --env-file-if-exists, depuis 22.9, tolère un fichier absent [19]. La syntaxe du fichier est celle que Node.js s’est donnée, faute de norme commune : des noms faits de lettres, de chiffres et de soulignés, sans chiffre en tête ; # ouvre un commentaire, sauf entre guillemets ; une valeur ne s’étend sur plusieurs lignes qu’entre guillemets [21].
Tout arrive sous forme de texte
Qu’elle vienne du panneau ou d’un fichier, une variable arrive en chaîne : 0, true ou un objet JSON deviennent les textes '0', 'true' et '{…}' [21]. Or la chaîne 'false' n’est pas vide, donc vraie pour JavaScript : un interrupteur réglé sur false reste allumé. Convertissez à l’entrée, et refusez de démarrer s’il manque l’essentiel :
// config.js — chargé en premier par le fichier de démarrage
const requises = ['DATABASE_URL', 'SESSION_SECRET'];
const absentes = requises.filter((nom) => !process.env[nom]);
if (absentes.length > 0) {
// Le nom suffit au diagnostic : jamais la valeur.
console.error('Variables absentes : ' + absentes.join(', '));
process.exit(1);
}
module.exports = {
paiementActif: process.env.PAIEMENT_ACTIF === 'true',
delaiMs: Number.parseInt(process.env.DELAI_MS ?? '5000', 10),
port: Number(process.env.PORT) || 3000,
};Le message d’arrêt s’écrit dans les journaux du domaine ; pour n’y voir que Node.js, décochez les autres fichiers dans la liste « Tous les journaux » [18]. Le guide pour lire les journaux d’une application en production prend le relais si le message ne suffit pas.
Appliquer un changement : redémarrer
Une variable est lue au démarrage du processus. Après une modification dans le panneau, relancez l’application avec le bouton de redémarrage de la page Node.js (Restart App) ; par SSH, créez ou touchez le fichier tmp/restart.txt dans le dossier de l’application [22]. Passenger ne remarque le changement qu’à l’arrivée d’une requête, et pas plus souvent que son intervalle de contrôle [23] : si la première requête répond encore avec l’ancienne valeur, réessayez quelques secondes plus tard. En dernier recours, Désactiver Node.js puis Activer Node.js relance tout sans toucher aux réglages [18].
Ce qui part dans le navigateur n’est plus secret
Les outils de construction du front recopient certaines variables dans le JavaScript livré au visiteur. Vite expose celles qui commencent par VITE_ et prévient qu’elles ne doivent contenir aucune clé d’API [24] ; Laravel suit la même convention [25]. Next.js fait de même avec NEXT_PUBLIC_, en inscrivant la valeur dans le code au moment de next build : une fois l’application construite, changer la variable ne change plus rien, il faut reconstruire [26]. Un identifiant fait pour être public peut y aller ; un secret, jamais.
Next.js lit d’abord process.env, puis ses fichiers .env : une valeur saisie dans le panneau de Plesk l’emporte donc sur celle d’un fichier. Il n’admet que trois valeurs pour NODE_ENV : production, development et test [26].
npm, NODE_ENV et la construction
Quand NODE_ENV vaut production, npm n’installe pas les devDependencies [27], là où se trouvent souvent Vite, TypeScript ou l’outil de compilation. Si npm run build échoue sur une commande introuvable, construisez avant le déploiement, ou installez explicitement avec npm install --include=dev avant de construire [27].
Les secrets : où ils vivent, qui les voit, comment les changer
Toutes les variables ne se valent pas. APP_URL ou LOG_LEVEL peuvent se lire sans dommage. APP_KEY, les mots de passe de base et de messagerie, les clés des passerelles de paiement, les jetons d’API sont des secrets, comme les identifiants de la facture électronique : notre article sur la facture électronique rappelle que ceux de TTN n’ont rien à faire dans le code. Par défaut, traitez comme secrète toute valeur qui ouvre un accès.
Où ils doivent être, et où jamais
- Dans le
.envdu serveur ou les variables du panneau Node.js, à l’intérieur de votre compte. Sur nos packs, CageFS isole chaque compte de ceux de ses voisins (guide CloudLinux, LVE et CageFS). - Jamais dans le dépôt : le
.env.examplene porte que des noms et des valeurs fictives, ce que Laravel recommande pour que l’équipe sache quelles variables fournir [2]. - Jamais dans la racine du document, ni dans une variable
VITE_ouNEXT_PUBLIC_. - Jamais dans un ticket, une capture d’écran, un message WhatsApp ou un journal d’erreurs : pour diagnostiquer, le nom de la variable suffit.
Versionner un .env chiffré
Laravel propose une voie médiane : php artisan env:encrypt chiffre le .env dans un fichier .env.encrypted, que la documentation juge sûr à placer dans le dépôt [2]. La clé de déchiffrement s’affiche dans la sortie de la commande et se range dans un gestionnaire de mots de passe. Le chiffrement par défaut est AES-256-CBC, qui demande une clé de 32 caractères si vous fournissez la vôtre avec --key ; --env=staging vise un fichier d’environnement précis, et --readable garde les noms lisibles pour relire les différences [2]. Sur le serveur, php artisan env:decrypt reconstitue le .env, avec la clé lue dans la variable LARAVEL_ENV_ENCRYPTION_KEY ou passée par --key ; --force écrase un fichier existant [2].
Le fichier chiffré sert à transporter et à historiser la configuration, pas à la protéger sur le serveur : une fois déchiffré, le .env est en clair, comme avant. Aucune de nos offres n’annonce de coffre de secrets séparé ; sur un pack, le .env et le panneau Node.js en tiennent lieu, et sur un serveur VPS ou dédié, l’outil de votre choix s’installe.
Quand un secret a fuité
Un .env poussé une seule fois dans un dépôt reste dans son historique, même retiré au commit suivant. GitHub le résume : un secret exposé se révoque ou se renouvelle d’abord, et la réécriture de l’historique ne vient qu’ensuite, si elle sert encore [28]. Dans l’ordre :
- mot de passe de base de données : changez-le dans Plesk, depuis la page Bases de données, reportez-le dans le
.env, puis relancezconfig:cache; - clés d’une passerelle de paiement ou d’une API : régénérez-les dans le tableau de bord du prestataire, puis remplacez-les ;
APP_KEY: générez une nouvelle clé. Si l’ancienne a fuité, ne la placez pas dansAPP_PREVIOUS_KEYS. Laravel essaie chacune de ces clés pour déchiffrer [8] et pour vérifier une URL signée [29] : il continuerait d’accepter ce qu’un tiers chiffre ou signe avec la clé fuitée, cookies compris. Acceptez que tous les utilisateurs soient déconnectés. Si des données sont stockées chiffrées, rechiffrez-les avec la nouvelle clé par un script qui reçoit l’ancienne le temps de les relire, puis effacez-la.APP_PREVIOUS_KEYSest fait pour une rotation de routine, quand rien n’a fuité ;- notez ce qui a changé, quand, par qui, et quels processus ont été redémarrés.
Vérifier qu’une valeur est prise, sans l’afficher
Une vérification ne doit pas devenir une fuite. Ces outils répondent à « la valeur est-elle là ? » sans la recopier ailleurs :
php artisan aboutrésume l’application, ses pilotes et son environnement ;--only=environmentlimite la sortie à cette partie [2].php artisan config:show databasedétaille un fichier de configuration, valeurs comprises [2] : utile pour vous, à ne jamais coller dans un ticket.- La route
/upde Laravel répond 200 quand l’application a démarré sans exception, 500 sinon [5] : le premier test après chaque changement. - Côté Node.js, le contrôle de démarrage montré plus haut écrit le nom des variables absentes dans les journaux, jamais leur valeur.
Testez ensuite le parcours réel, en préproduction d’abord : une connexion, un formulaire qui envoie un message, un paiement de test, un appel à l’API extérieure. Un site qui répond n’est pas encore un site qui fonctionne.
Symptômes fréquents, et leur cause
| Ce que vous voyez | Cause probable | Que faire |
|---|---|---|
env('…') renvoie null en production, la variable est pourtant dans .env | Configuration en cache : le .env n’est plus lu | Déplacez l’appel dans un fichier de config/, lisez avec config(), relancez php artisan config:cache. |
Une valeur modifiée dans .env reste sans effet | Cache de configuration ancien, ou worker de file d’attente jamais redémarré | php artisan config:cache, puis php artisan queue:restart. |
| Erreur 500 ; Artisan affiche « The environment file is invalid! … unexpected whitespace » | Une valeur contient une espace sans guillemets | Entourez la valeur de guillemets doubles. |
| La base refuse la connexion (« Access denied »), le mot de passe est pourtant juste | Un # hors guillemets a coupé la valeur | Mettez la valeur entre apostrophes simples, puis relancez config:cache. |
| Une page d’erreur détaillée, pile d’appels comprise, s’affiche sur le site public | APP_DEBUG=true en ligne | Passez à false, relancez config:cache, et renouvelez les secrets que la page a pu montrer. |
| Tous les utilisateurs déconnectés après un déploiement | APP_KEY a changé | Si l’ancienne clé n’a pas fuité, remettez-la, ou ajoutez-la dans APP_PREVIOUS_KEYS. Si elle a fuité, gardez la nouvelle : la déconnexion est le prix de la sécurité. |
Node.js : une option réglée sur false reste active | La valeur est la chaîne 'false', vraie pour JavaScript | Comparez au texte : process.env.OPTION === 'true'. |
| Node.js : variable changée dans Plesk, aucun effet | Le processus n’a pas redémarré | Restart App ; ou, par SSH, tmp/restart.txt, pris en compte à l’arrivée d’une requête : réessayez quelques secondes plus tard si l’ancienne valeur répond encore. |
| Node.js : « http.Server.listen() was called more than once » | Deux serveurs HTTP dans l’application, sous Passenger | Un seul serveur HTTP, ou désignation explicite du bon serveur selon la documentation de Passenger. |
| Node.js : l’application ne démarre pas, délai dépassé | Le fichier de démarrage n’appelle jamais listen() | Dans le champ « Fichier de démarrage d’application » du panneau Node.js, indiquez bin/www pour une application Express générée. |
npm run build : vite ou tsc introuvable | NODE_ENV=production : les devDependencies n’ont pas été installées | Construisez avant le déploiement, ou npm install --include=dev. |
| Une tâche planifiée part avec une heure d’écart | Fuseau UTC par défaut | schedule_timezone à Africa/Tunis (Laravel), TZ=Africa/Tunis (Node.js). |
| La préproduction a écrit à de vrais clients ou débité une vraie carte | Valeurs de production recopiées en préproduction | MAIL_MAILER=log et clés de test en préproduction ; reprenez le tableau des trois environnements. |
Questions fréquentes
Peut-on garder le fichier .env dans Git s’il est chiffré ?
php artisan env:encrypt produit un .env.encrypted que sa documentation juge sûr à versionner. La clé de déchiffrement reste hors du dépôt et hors des tickets, dans un gestionnaire de mots de passe ; sur le serveur, php artisan env:decrypt recrée le .env.Faut-il donner à NODE_ENV la valeur staging en préproduction ?
production partout où l’application tourne pour de vrai, et Next.js n’accepte que production, development et test. Pour distinguer la préproduction, ajoutez une variable à vous, comme APP_STAGE.Pourquoi env() renvoie-t-il null alors que la variable est bien dans le .env ?
php artisan config:cache, Laravel ne lit plus le .env. Appelez env() seulement dans les fichiers de config/, lisez les valeurs avec config(), et refaites le cache après chaque modification.Le support a-t-il besoin de la valeur d’un secret pour m’aider ?
Quel fuseau horaire déclarer pour une application utilisée en Tunisie ?
Africa/Tunis : UTC+1 toute l’année, sans heure d’été depuis 2009. Côté Laravel, l’option schedule_timezone l’applique aux tâches planifiées ; côté Node.js, la variable TZ règle le fuseau du processus.Peut-on faire tourner une application Node.js sur le pack START ?
php artisan key:generate --show.Quand écrire au support, et quoi lui dire
Écrivez-nous pour faire ouvrir l’accès SSH, si le bouton Node.js manque sur un pack qui l’inclut, si une variable saisie dans Plesk n’atteint pas l’application après redémarrage, ou si vous pensez qu’un secret a fuité et voulez faire vérifier les accès. Le livechat et les tickets répondent 7 jours sur 7, en français ou en tunisien ; le téléphone, du lundi au vendredi de 9 h à 17 h, sert au commercial et à l’administratif (page Contact).
Sur un serveur VPS, le support intervient sur la disponibilité de la machine, le réseau et les incidents matériels, et vous aide sur les réglages de base (pare-feu, DNS, connexion SSH). L’infogérance peut prendre en charge le système et les services installés, mais le code de votre application et son débogage restent en dehors de l’un comme de l’autre.
Dans la demande, indiquez le domaine, le type d’application et sa version, le nom de la variable en cause, ce que vous avez changé et à quelle heure (heure de Tunis), le message exact et quelques lignes de journal sans valeur secrète. Le guide pour ouvrir une demande de support propose un modèle complet.
Guides liés
Pour aller plus loin : la documentation officielle
- Squelette Laravel 13 — fichiers .env.example, .gitignore, bootstrap/cache et config/app.php
- Documentation Laravel 13 — configuration : fichier .env, types de valeurs, fichiers par environnement, chiffrement, cache, commandes about et config:show, mode debug
- Documentation Laravel 13 — e-mails : le pilote log pour ne rien envoyer
- Node.js — différence entre développement et production, NODE_ENV
- Documentation Laravel 13 — déploiement : dossier public, cache de configuration, route de santé
- Documentation Plesk Obsidian — Laravel Toolkit : racine du document, variables (.env), Artisan, mode Maintenance, déploiement, files d’attente (en français)
- Notes de version de Laravel — Laravel 13 et PHP 8.3 minimum
- Documentation Laravel 13 — chiffrement : APP_KEY, key:generate, rotation avec APP_PREVIOUS_KEYS
- Code de Laravel 13 — commande key:generate et son option --show, qui affiche la clé sans modifier le .env
- Code de Laravel 13 — chargement du .env et message « The environment file is invalid! »
- phpdotenv, bibliothèque qui lit le .env de Laravel — analyse d’une valeur : guillemets, commentaires, erreurs
- Code de Laravel 13 — emplacement du cache de configuration (bootstrap/cache/config.php)
- Documentation Laravel 13 — files d’attente : workers et queue:restart
- IANA — base des fuseaux horaires, fichier « africa » (zone Africa/Tunis)
- Documentation Laravel 13 — planification des tâches : fuseau, schedule_timezone
- Base de connaissances Plesk — applications Node.js exécutées par Passenger, port et process.env.PORT
- Phusion Passenger — prise en main du port d’une application Node.js
- Documentation Plesk Obsidian — héberger des applications Node.js : mode d’application, variables personnalisées, journaux (en français)
- Node.js — options de la ligne de commande : --env-file, --env-file-if-exists, variable TZ
- Node.js — module process : process.env et process.loadEnvFile()
- Node.js — variables d’environnement et syntaxe des fichiers .env
- Base de connaissances Plesk — redémarrer une application Node.js
- Phusion Passenger — redémarrer une application, fichier restart.txt
- Vite — variables d’environnement et modes : préfixe VITE_ et protection des secrets
- Documentation Laravel 13 — Vite : variables VITE_ injectées dans le JavaScript
- Next.js — variables d’environnement : NEXT_PUBLIC_, ordre de chargement, valeurs de NODE_ENV
- npm — configuration : options omit et include
- GitHub Docs — supprimer des données sensibles d’un dépôt (en français)
- Code de Laravel 13 — URL signées vérifiées avec APP_KEY et chacune des clés de APP_PREVIOUS_KEYS
Les boutons Laravel et Node.js dépendent des extensions installées et de votre pack. Dites-nous ce que vous voyez : nous vous indiquons le bon chemin.
Poser la question au support