Documentation · Chapitre 03

Comprendre les fichiers
sans se perdre.

Vous n’avez pas besoin de connaître tout le projet. Commencez par les fichiers que vous allez réellement modifier.

Vous modifierez un seul élément à la fois, dans un fichier précisément indiqué, puis vous contrôlerez le résultat.

La carte du projet

phpaml — zsh
reading-list/
├── phpaml.json
├── composer.json
├── .env.example
├── public/
│   └── index.php
├── src/
│   ├── controllers/
│   ├── models/
│   ├── routes/WebApp.php
│   ├── services/
│   └── views/
├── tests/
└── runtime/

Les quatre zones essentielles

public/

Entrée publique du site et fichiers que le navigateur peut demander directement.

src/

Votre application : c’est ici que vous travaillez la plupart du temps.

tests/

Vérifications automatiques qui empêchent un ancien comportement de casser.

runtime/

Environnement installé et reconstructible. N’y rangez pas votre logique.

Les fichiers que vous modifierez dans ce chapitre

src/routes/WebApp.phpdéclare les adresses
src/controllers/AboutController.phpprépare la page À propos
src/controllers/BookController.phpprépare la liste de livres
src/views/about.phpaffiche la page À propos
src/views/books.phpaffiche les livres

Ce que font les fichiers à la racine

phpaml.json est la fiche d’identité partagée du projet. composer.json décrit les bibliothèques PHP et l’autoloading. .env.example documente les réglages locaux attendus sans contenir de secrets réels.

Ne modifiez pas runtime pour corriger votre application

runtime peut être régénéré. Une correction métier placée dedans risque de disparaître lors d’une réinstallation ou mise à jour.

À VOUS

Où placeriez-vous une nouvelle adresse /contact, son code de préparation et son HTML ?

Voir un indice

Route dans src/routes, contrôleur dans src/controllers, vue dans src/views.