La méthode avant le code.
Ne commencez pas par créer des fichiers au hasard. Formulez d’abord la demande comme un trajet : le navigateur demande GET /about; une route doit reconnaître cette adresse; un contrôleur doit produire la réponse; le navigateur doit enfin recevoir un statut 200 et du HTML. Cette phrase devient votre plan de travail et votre plan de diagnostic.
Ajoutez une page À propos à une application classique.
- Créez un projet nommé architecture-lab.
- Examinez phpaml.json, public/, src/ et runtime/.
- Créez un contrôleur AboutController.
- Ajoutez GET /about dans src/routes/WebApp.php.
- Retournez une réponse HTML simple, puis vérifiez-la dans le navigateur.
CORRECTION GUIDÉE
Construisez dans l’ordre de la requête.
aml create architecture-lab
cd architecture-lab
aml make:controller About
aml serveLa commande crée le fichier du contrôleur sous src/controllers. Ajoutez ensuite la route dans src/routes/WebApp.php et reliez-la à AboutController::index. Cette route doit être chargée avant que le navigateur puisse atteindre l’action.
public function index(Request $request): Response
{
return Response::html('<main><h1>About</h1><p>My first PHPAML page.</p></main>');
}Ouvrez /about. Une réponse 200 prouve que le point d’entrée, le routeur, le contrôleur et la réponse fonctionnent ensemble. Une 404 indique généralement que la route n’est pas enregistrée; une 500 indique que le traitement a démarré puis échoué.
Procédez par petites preuves.
- 1Prouver le démarrage
La page d’accueil doit encore répondre avant toute modification.
- 2Prouver la route
Une 404 qui disparaît confirme que /about est maintenant reconnue.
- 3Prouver l’action
Un contenu très simple confirme que le contrôleur est appelé.
- 4Améliorer ensuite
Ajoutez présentation et données seulement lorsque le trajet minimal fonctionne.
Si la page ne fonctionne pas, vérifiez dans cet ordre.
Le terminal doit encore afficher que PHPAML écoute une adresse locale.
Vérifiez le port et le chemin /about dans le navigateur.
Une erreur 404 signifie souvent que l’adresse n’est pas reliée au contrôleur.
Le nom AboutController et la méthode index doivent correspondre exactement à la route.
En développement, l’écran d’erreur et le terminal indiquent le fichier et la ligne à examiner.
Questions de compréhension
VÉRIFIEZ VOTRE COMPRÉHENSION
Pourquoi le contrôleur est-il placé dans src/ plutôt que public/ ?
Afficher la réponse
Parce que le contrôleur est du code interne. Seul public/index.php doit être directement exposé au Web.
VÉRIFIEZ VOTRE COMPRÉHENSION
Pourquoi une route est-elle nécessaire ?
Afficher la réponse
Elle associe une méthode et un chemin HTTP à l’action qui doit les traiter.
EN RÉSUMÉ
Ce qu’il faut retenir
- Vous savez suivre une requête complète.
- Vous savez distinguer code public, applicatif et reconstructible.
- Vous savez répartir modèle, vue et contrôleur.
- Vous pouvez maintenant aborder la migration d’un ancien projet.