Documentation · Chapitre 01

Créer le bon
type de projet.

La commande de création installe automatiquement le projet : aml install n’est pas une étape normale après la création.

Choisissez selon votre besoin

aml createApplication classique

MVC, routes, contrôleurs et vues PHP.

aml create-viewAML View

Interface réactive écrite directement en PHP.

aml create-apiAPI

Service JSON sans interface graphique.

aml create-consoleConsole

Programme PHP pur dans le terminal.

COMMENT CHOISIR ?

Commencez par le résultat attendu.

Les quatre commandes n’expriment pas quatre niveaux de qualité. Elles préparent simplement des structures différentes. Une boutique rendue sur le serveur peut commencer avec une application classique. Un tableau de bord très interactif convient à View. Une application mobile qui consomme du JSON utilise une API. Un exercice de programmation sans navigateur utilise Console.

Je veux des pages Web classiquesaml create
Je veux une interface réactiveaml create-view
Je veux fournir des données JSONaml create-api
Je veux apprendre PHP dans le terminalaml create-console

Créer une application classique

NOUVEAU DOSSIER
phpaml — zsh
aml create mon-premier-projet
cd mon-premier-projet
DOSSIER VIDE ACTUEL
phpaml — zsh
mkdir mon-premier-projet
cd mon-premier-projet
aml create .
Important

La création installe déjà le runtime. Utilisez aml install seulement pour reconstruire un projet existant, ou après --no-install.

Structure créée

phpaml — zsh
public/       point d’entrée Web
src/          votre code applicatif
routes/       déclaration des routes
runtime/      moteur privé reconstructible
phpaml.json   manifeste PHPAML

Lisez la structure comme une carte.

public/ est la porte d’entrée visible du Web. routes/ associe une adresse à une action. src/ contient ce que vous développez. phpaml.json décrit le projet à AML. runtime/ contient les outils nécessaires à l’exécution et peut être reconstruit.

Règle importante

Travaillez dans src/, routes/ et les fichiers de configuration prévus. Ne corrigez jamais un problème en modifiant une bibliothèque dans runtime/: votre modification disparaîtrait lors d’une reconstruction.

VÉRIFIEZ VOTRE COMPRÉHENSION

Vous créez un petit programme qui demande un âge dans le terminal. Quelle commande choisissez-vous ?

Afficher la réponse

aml create-console

EN RÉSUMÉ

Ce qu’il faut retenir

  • Le type de projet dépend du résultat attendu.
  • La création installe automatiquement le runtime.
  • src/ contient votre code; runtime/ contient le moteur.
  • aml install n’est pas nécessaire après une création réussie.