PHPAML

Documentation · Chapitre 06

Configurer sans
mélanger le code.

La même application doit fonctionner sur votre ordinateur, dans les tests et sur un serveur, sans changer ses classes PHP.

Aucun secret réel n’est nécessaire : nous configurons reading-list avec des valeurs sûres.

≈ 70 min

Le programme reste le même; son contexte change.

Imaginez une recette. Les étapes sont le code. L’adresse de la cuisine, la clé de la réserve et la température du four sont de la configuration. Les recopier dans chaque étape rendrait la recette difficile à déplacer et dangereuse à partager.

Trois familles à ne pas confondre

Code

Les classes, routes et vues qui décrivent le comportement.

Configuration

Les choix qui changent selon l’installation : URL, debug, base de données.

Données

Le contenu créé par les utilisateurs, conservé en session ou en base.

La chaîne de configuration PHPAML

phpaml — zsh
phpaml.json       → choix partageables / shareable choices
.env               → valeurs locales et secrets / local values and secrets
runtime/config/
└── app.php         → résultat généré / generated result

PHPAML lit le manifeste et l’environnement, applique les valeurs par défaut, normalise les chemins puis écrit sa configuration interne. Le reste de l’application reçoit ainsi un résultat cohérent.

VOCABULAIRE

Les mots à retenir

ManifesteFichier qui décrit les choix partageables.
EnvironnementValeurs propres à une machine ou un serveur.
SecretValeur privée comme un mot de passe ou une clé.

EN RÉSUMÉ

Ce qu’il faut retenir

  • Le code décrit le comportement; la configuration décrit le contexte.
  • phpaml.json est partagé avec le projet.
  • .env reste propre à chaque installation.
  • runtime/config/app.php est généré.