Chapitre: Créer une application
| « Pré-requis sur le serveur | ^ Mise en route | Configurer le serveur » |
− Table des matières
La façon la plus simple de créer une application Jelix, est l'utilisation de la commande
bin/create-jelix-app. Elle permet de créer un squelette d'application.
Il faut d'abord installer les sources, soit avec Composer, soit à partir du paquet zip de jelix.org.
Installer les sources avec Composer ¶
Pour installer Composer, voir le site https://getcomposer.org.
Si vous n'avez pas encore de projet avec un fichier composer.json, créer
un répertoire pour votre projet (prenons myproject comme nom) et y
mettre un fichier composer.json dont voici un exemple de contenu :
{
"name": "myorganisation/myproject",
"type": "application",
"require": {
"jelix/jelix": "dev-jelix-1.7.x"
},
"minimum-stability": "stable"
}
Vous pouvez aussi créer ce fichier en utilisant la commande composer init.
Dans ce répertoire, on y exécute Composer pour installer les paquets indiqués
dans le composer.json :
cd myproject
composer install
Un répertoire vendor est alors créé, dans lequel Jelix (et d'autres paquets)
sont installés. Vous trouverez celui de Jelix dans vendor/jelix/jelix/.
Dans la suite du manuel, quand il est signalé le répertoire lib/, il s'agit
de vendor/jelix/jelix/lib/.
La commande create-jelix-app se trouve dans vendor/bin/.
Installer les sources à partir du site jelix.org ¶
Vous pouvez télécharger une archive tar.gz ou zip de Jelix. Cette archive
contient un répertoire jelix-X.Y.Z/lib/ qui comprend tous les fichiers du
framework et les bibliothèques dépendantes.
Décompressez l'archive avec des logiciels comme winzip, unzip ou tar.
tar xvzf jelix-1.7.2.tar.gz
Un repertoire jelix-1.7.2 est créé contenant un répertoire lib/ et bin/.
Vous devez mettre ces deux répertoires dans le dossier de votre projet.
La commande create-jelix-app se trouve dans bin/.
Lancer create-jelix-app ¶
Allez dans le répertoire où est installé la commande create-jelix-app (voir précédemment), et lancez-la de la manière suivante :
php create-jelix-app /chemin/vers/le/nouveau/répertoire/de/myproject/myapp
myapp est le nom de votre application (que vous pouvez bien sûr choisir
librement).
create-jelix-app crée un répertoire myapp/ avec le chemin indiqué. Son
contenu est :
myapp/
app/
system/ fichiers de configuration système du framework et de l'application
responses/ classes pour les objets réponses HTML
themes/ les thèmes disponibles pour votre application
overloads/ contiendra les différents fichiers qui redéfinissent des
fichiers de modules
install/ scripts et fichiers pour initialiser l'application.
modules/ modules de l'application
plugins/ plugins de l'application
temp/ tous les fichiers temporaires et de cache créés à l'execution de l'application
var/
config/ fichiers de configuration spécifiques à l'environnement
log/ fichiers de log
themes/ thèmes installés durant la vie de l'application
overloads/ idem que app/overloads, mais pour les fichiers créés à la volé
durant la vie de l'application
www/ racine du répertoire public de votre application
Premier lancement de votre application ¶
Une fois votre application créée, vous pouvez la tester en lançant le serveur web intégré dans PHP (serveur à n'utiliser qu'en phase de développement, pas en production !).
Tapez donc en ligne de commande :
cd myapp
php -S localhost:8080 -t www
Et vous pouvez visiter http://localhost:8080 avec votre navigateur.
Si vous voulez utiliser un autre serveur web, comme Apache ou Nginx, il vous faudra faire quelques réglages supplémentaires. Voir le chapitre suivant.
