Aller au contenu principal
{}

Outil Laravel open source

Laravel Env Guard

Package Composer qui contrôle automatiquement les projets Laravel en développement afin de détecter les clés d’environnement manquantes, inutilisées, dupliquées ou incohérentes ainsi que les usages dangereux de env().

Quand utiliser cet outil ?

Utilisez ce package comme garde-fou de développement lorsque plusieurs fichiers .env, la configuration Laravel, Vite ou les environnements de test partagent le même contrat de variables et que les erreurs doivent apparaître avant le déploiement.

Lors des démarrages Artisan surveillés, l’état actuel du projet est réanalysé, les accès risqués et la dérive des clés sont signalés, et les valeurs d’environnement restent absentes des résultats, de la console et des logs.

À qui s’adresse cet outil ? Équipes Laravel qui veulent détecter tôt la dérive des variables d’environnement et les problèmes de cache de configuration sans journaliser de secrets ni dépendre d’une commande d’audit séparée.

Quickstart

Installation locale

Utilisez le dépôt comme point de départ. Vérifiez toujours les exigences et lockfiles de votre projet avant la production.

composer require --dev codegenie-be/laravel-env-guard

Fonctionnalités principales

  • 01Détecte env() et Illuminate\Support\Env::get() hors de config/, y compris les accès dynamiques et directs à l’environnement
  • 02Compare les fichiers plaintext .env et .env.* découverts automatiquement sans imposer .env.example
  • 03Signale les clés d’environnement manquantes, potentiellement inutilisées, dupliquées ou incohérentes par la casse
  • 04Prend en charge Laravel 12 et 13, .env.testing, phpunit.xml, Vite import.meta.env et loadEnv()
  • 05S’exécute par défaut uniquement en local et côté console afin d’éviter un audit complet continu sur les requêtes HTTP normales
  • 06Ne rapporte que les clés et les emplacements ; les valeurs d’environnement et les secrets restent hors des résultats

Exemple : une clé manquante

Exemple synthétique : le fichier .env actif déclare DEMO_SERVICE_KEY, mais pas .env.testing. Le guard peut signaler cette différence de clés. La description suivante simplifie le constat ; ce n’est pas la sortie littérale d’un scan exécuté.

text
DEMO_SERVICE_KEY : absente de .env.testing
Vérifier si cette clé est volontairement optionnelle.

Évaluer un constat

  • Le contrôle par défaut est local et orienté console. Il compare les fichiers d’environnement plaintext présents et analyse le code ; un fichier nommé .env.example n’est pas obligatoire.
  • Les noms de clés et les emplacements servent au diagnostic. Ne publiez pas de valeurs secrètes pour expliquer un constat.
  • Une clé apparemment inutilisée peut servir indirectement à une intégration. Examinez le constat avant de supprimer une configuration.
  • L’outil ne remplace pas les contrôles d’autorisation, de configuration de production ou d’identifiants fournisseur. Testez aussi l’application avec sa configuration en cache après une modification.
Comprendre le contrat nécessaire au cache de configuration

Une autre ressource Laravel utile

Formulaire multi-étapes Laravel Livewire

Open source

Package Composer open source pour Laravel 12/13 et Livewire 3.6+/4 : formulaire configurable avec validation, récapitulatif et hook de traitement contrôlé.

Équipes Laravel qui intègrent des formulaires multi-étapes sans confier la persistance de leur application au package.

Adapter un outil à votre projet Laravel ?

Codegenie peut adapter le parcours, le style, la validation ou le déploiement à votre application existante.