Un ordinateur Windows 10/11, macOS 12+ ou une distribution Linux Debian/Ubuntu, une connexion Internet et un terminal. Aucun PHP préalable n’est requis.
Objectifs pédagogiques
Ce que vous saurez réellement faire.
Ce chapitre ne consiste pas à recopier cinq commandes. Vous allez comprendre ce que chacune prépare, quels fichiers vous appartiennent et comment reconnaître un environnement sain. Cette compréhension vous évitera de supprimer le runtime, d’installer des dépendances au mauvais endroit ou de confondre le framework avec son outil de commande.
- Distinguer AML, PHPAML et le runtime
- Installer puis contrôler l’environnement
- Créer, démarrer et diagnostiquer un projet
- Comprendre le cycle de développement local
Modèle mental
Trois rôles, un seul flux.
AML est l’outil utilisé dans le terminal. PHPAML est le framework qui structure et exécute l’application. Le runtime est l’environnement privé assemblé par AML. Vous écrivez le produit; AML entretient la mécanique nécessaire à son exécution.
La commande vérifie la machine, récupère le modèle officiel et crée les fichiers appartenant à votre application.
Le moteur privé charge le framework, les dépendances et votre configuration.
Le routeur trouve le contrôleur, construit la réponse et la transmet au navigateur.
Ne modifiez pas manuellement les bibliothèques placées dans runtime. Une mise à jour ou un nouvel aml install peut les reconstruire. Votre code, vos routes et les paramètres déclaratifs restent hors de ce moteur privé.
AML et PHPAML
PHPAML est le mini-framework MVC. AML est sa commande : elle installe l’environnement, crée les projets, lance le serveur et diagnostique la machine. Une fois AML installé, vous n’avez pas besoin d’installer PHP ou Composer séparément.
Installer AML
Téléchargez l’installateur adapté à votre système depuis la page officielle. Windows utilise le fichier .exe, macOS le paquet .pkg et Linux le paquet .deb. L’installateur ajoute AML, PHP et Composer à la machine.
Choisir la langue
Pendant l’installation, choisissez Français ou English. Ce choix contrôle l’aide, les confirmations et les messages d’erreur. Vous pourrez le modifier plus tard dans la configuration AML.
Vérifier la machine
La commande doctor contrôle AML, PHP, les extensions, Composer, les dossiers temporaires, le cache et le port de développement. Corrigez les lignes ERROR avant de créer votre premier projet.
aml doctor[OK] AML version 1.7.0-beta.20
[OK] PHP compatible
[OK] Private Composer available
[OK] Temporary directory writable
[OK] Cache AML writable
[OK] Development port 127.0.0.1:8910 availableCréer le premier projet
Créez un nouveau dossier avec aml create mon-projet, ou utilisez aml create . dans un dossier vide existant. AML télécharge le modèle officiel et prépare la structure MVC.
aml create mon-projet
cd mon-projet
aml install
aml servemkdir my-first-app
cd my-first-app
aml create .
aml install
aml serveInstaller et démarrer
aml install installe le moteur privé dans runtime. aml serve lance ensuite le site local avec l’actualisation automatique. Gardez ce terminal ouvert pendant le développement.
PHPAML development server
→ http://127.0.0.1:8910
Actualisation automatique activehttp://127.0.0.1:8910Résoudre les problèmes
Si AML ne reconnaît pas le projet, vérifiez que vous êtes dans le dossier contenant phpaml.json, src et runtime. Si un port est occupé, AML essaie automatiquement le suivant. Relancez toujours aml doctor après une correction.
not a PHPAML projectEntrez dans le bon dossier ou lancez aml create .Address already in useAML essaie automatiquement le port suivant.Permission deniedVérifiez les droits du dossier, puis relancez doctor.GitHub unavailableRéutilisez le cache avec aml create projet --offline.Exercice final
Créez votre première application.
- Vérifiez la machine avec aml doctor.
- Créez un projet nommé task-app.
- Installez ses dépendances avec aml install.
- Lancez-le avec aml serve et ouvrez la page locale.
Correction guidée
Vérifiez le résultat, pas seulement les commandes.
doctor doit se terminer sans erreur bloquante. À la racine de task-app, phpaml.json doit être présent : c’est le manifeste du projet. Après aml install, runtime doit exister. Enfin, aml serve annonce une adresse locale, normalement le port 8910; s’il est occupé, AML essaie 8911 puis les suivants.
Questions de contrôle
- Quel outil crée le projet : AML ou PHPAML ?
- Pourquoi runtime ne contient-il pas votre logique métier ?
- Que faire après avoir corrigé un problème de machine ?
Afficher les réponses
AML crée et entretient le projet. PHPAML exécute l’application. Le runtime est remplaçable et réservé au moteur. Après une correction, relancez aml doctor afin de confirmer que l’environnement complet est sain.