Commande Temma


1Présentation

Cette commande gère l'installation du framework Temma lui-même. Elle offre trois actions : afficher les informations de version, mettre à jour le code source du framework, et lancer un serveur web de développement autonome.

Le nom d'objet Temma est automatiquement recherché dans le namespace \Temma\Cli : les commandes ci-dessous sont équivalentes à bin/comma '\Temma\Cli\Temma' ...


2Informations de version

Affiche la version du framework Temma installé (ainsi que la version de Smarty, si elle est disponible) :

$ bin/comma Temma/info

3Mise à jour

Met à jour le code source du framework dans le projet courant :

$ bin/comma Temma/update [--version=string] [--force]

Cette action est destinée aux projets qui n'utilisent pas Composer. Ses paramètres (--version pour choisir la version souhaitée, --force pour écraser les fichiers modifiés) sont détaillés dans la documentation de mise à jour du framework.


4Serveur de développement

Lance un serveur web de développement autonome, basé sur le serveur web intégré de PHP :

$ bin/comma Temma/serve

Temma development server
URL: http://myproject.localhost:8000/ (environment 'dev')
Development server, do not use in production. Press Ctrl+C to stop.

Le serveur écoute sur l'hôte local (port 8000 par défaut) et sert le projet comme le ferait la configuration Apache/Nginx habituelle : les fichiers qui existent dans le répertoire www/ sont servis tels quels, toute autre requête est routée vers le contrôleur frontal www/index.php.

Le nom d'hôte affiché est construit à partir du nom du répertoire racine du projet, tronqué au dernier point (un projet stocké dans www.monsite.com/ est servi sous http://www.monsite.localhost:8000/). Tous les noms en *.localhost pointent vers l'hôte local, et chaque projet dispose de son propre nom d'hôte, donc de ses propres cookies.

Le port d'écoute peut être fourni en paramètre. Si le port est déjà utilisé, un message d'erreur est affiché :

$ bin/comma Temma/serve/8080

Le paramètre --env définit le nom de la plateforme, exporté dans la variable ENVIRONMENT (dev par défaut), qui sert à charger le fichier de configuration spécifique à la plateforme (par exemple etc/temma.dev.php) :

$ bin/comma Temma/serve --env=staging

Le serveur gère jusqu'à huit requêtes simultanées (grâce au mécanisme PHP_CLI_SERVER_WORKERS), ce qui suffit pour une page et ses ressources. Chaque requête est affichée sur la sortie standard. Le serveur s'arrête avec Ctrl+C.

Ce serveur est destiné au développement uniquement. Il ne gère pas TLS et n'est pas conçu pour supporter la moindre charge. En production (ou pour exposer un projet sur le réseau local), utilisez un vrai serveur web comme Apache, Nginx ou FrankenPHP (voir la documentation d'installation).