Download the PHP package cocoon-projet/config without Composer
On this page you can find all versions of the php package cocoon-projet/config. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download cocoon-projet/config
More information about cocoon-projet/config
Files in cocoon-projet/config
Package config
Short Description Gestionnaire de configuration pour PHP 8+
License MIT
Informations about the package config
Cocoon Config
Une bibliothèque PHP 8+ moderne et flexible pour la gestion de configuration avec support des variables d'environnement.
Fonctionnalités
- ✨ Support PHP 8.0+
- 🔄 Gestion multi-environnements (development, production, testing)
- 🌍 Variables d'environnement avec la fonction helper
env()
- 📦 Chargement automatique des fichiers de configuration
- 🔒 Validation des types et des valeurs
Installation
Configuration
- Créez un dossier
config
à la racine de votre projet -
Ajoutez vos fichiers de configuration PHP :
- Créez un fichier
.env
à la racine :
Gestion des environnements
La librairie supporte nativement la gestion de différents environnements (development, production, testing) via une convention de nommage des fichiers :
Le système fonctionne de la manière suivante :
-
Fichiers spécifiques à l'environnement :
- Format :
nom.environnement.php
(ex:database.production.php
) - Ces fichiers sont chargés uniquement pour l'environnement correspondant
- Ils écrasent les valeurs du fichier de configuration par défaut
- Format :
-
Fichiers de configuration par défaut :
- Format :
nom.php
(ex:database.php
) - Servent de configuration de base
- Sont utilisés si aucun fichier spécifique à l'environnement n'existe
- Format :
-
Exemple de chargement :
- Priorité de chargement :
- Le fichier spécifique à l'environnement est chargé en priorité
- Si non trouvé, le fichier par défaut est utilisé
- Les valeurs sont fusionnées de manière récursive
Utilisation
Chargement des variables d'environnement
Chargement de la configuration .env et fichier de configuration
Gestion du cache
La bibliothèque propose deux systèmes de cache complémentaires :
1. Cache de configuration (ConfigurationCache)
Optimisé pour la gestion des fichiers de configuration en production :
2. Cache générique (GenericFileCache)
Pour un cache plus flexible et générique :
Variables d'environnement
Bonnes pratiques
-
Organisation des fichiers
- Un fichier par domaine (database.php, mail.php, etc.)
- Utilisation de sous-tableaux pour organiser les configurations
- Documentation des options dans les commentaires
-
Variables d'environnement
- Toujours fournir des valeurs par défaut
- Utiliser des noms explicites et cohérents
- Documenter les variables requises
- Ne jamais commiter le fichier
.env
- Créer un fichier
.env.example
pour documenter les variables nécessaires
-
Sécurité
- Ne jamais commiter le fichier
.env
- Utiliser des valeurs sécurisées en production
- Valider les entrées utilisateur
- Ne jamais commiter le fichier
-
En production
- Utilisez
ConfigurationCache
pour les performances optimales - Activez le cache en production uniquement
- Videz le cache lors des déploiements
- Utilisez
-
En développement
- Désactivez le cache pour voir les changements en temps réel
- Utilisez
GenericFileCache
pour des tests de performance
- Sécurité
- Définissez les bonnes permissions sur le dossier
- Ne stockez pas d'informations sensibles dans le cache
Validation des données
La bibliothèque offre des méthodes de validation de type :
Licence
MIT License - voir le fichier LICENSE pour plus de détails.
All versions of config with dependencies
ext-json Version *
symfony/finder Version ^3.4
tracy/tracy Version ^2.10
vlucas/phpdotenv Version ^5.6