Documentation · Chapitre 01

Résoudre les problèmes
sans deviner.

Partez du message exact et utilisez les diagnostics AML avant de réinstaller quoi que ce soit.

Problèmes fréquents

aml: command not found

Ouvrez un nouveau terminal, puis vérifiez le PATH.

not a PHPAML project

Placez-vous dans le dossier contenant phpaml.json.

Permission denied

Vérifiez les droits du projet et du cache, puis relancez aml doctor.

GitHub unavailable

Vérifiez la connexion ou utilisez --offline si les archives sont déjà en cache.

Une méthode qui évite les fausses corrections.

Copiez le message exact avant de modifier quoi que ce soit. Identifiez ensuite la commande, le dossier courant et la première erreur. Une réinstallation complète peut masquer temporairement le problème sans en expliquer la cause.

  1. ReproduireRelancez une seule fois la commande qui échoue.
  2. ObserverNotez le message, le fichier et le dossier courant.
  3. DiagnostiquerUtilisez aml doctor et commencez par la première erreur.
  4. ConfirmerRelancez exactement la même commande après la correction.
EXERCICE FINAL

Créez et ouvrez votre première application.

phpaml — zsh
aml doctor
aml create task-app
cd task-app
aml serve

Le chapitre est réussi si doctor ne signale aucune erreur bloquante, si phpaml.json existe et si la page locale répond. Ne lancez pas aml install après une création réussie.

CORRECTION EXPLIQUÉE

Vérifiez des preuves, pas seulement des commandes.

  1. aml doctorprouve que l’environnement global est utilisable.
  2. phpaml.jsonprouve que vous êtes à la racine d’un projet PHPAML.
  3. runtime/prouve que la création a installé le moteur.
  4. HTTP 200prouve que le navigateur, le serveur et l’application ont terminé le cycle complet.

VÉRIFIEZ VOTRE COMPRÉHENSION

Pourquoi ne lance-t-on pas aml install dans la correction normale ?

Afficher la réponse

Parce que aml create installe déjà le projet. aml install est une commande de reconstruction ou d’installation différée.

EN RÉSUMÉ

Ce qu’il faut retenir

  • Un problème se résout à partir du premier message exact.
  • On vérifie toujours le dossier courant.
  • doctor confirme l’état global de la machine.
  • Le résultat final attendu est une réponse HTTP dans le navigateur.