| Les deux révisions précédentesRévision précédenteProchaine révision | Révision précédenteProchaine révisionLes deux révisions suivantes |
| tutoriels:principal:creation-application [2008/01/30 08:19] – bballizlife | tutoriels:principal:creation-application [2008/05/16 09:05] – laurent |
|---|
| ====== Création d'une application et d'un module ====== | |
| |
| Nous allons créer une application à partir de rien. Toute application Jelix a un nom : celui de son répertoire. Nous allons appeler la notre "actu.org". | Nous allons créer une application à partir de rien. Toute application Jelix a un nom : celui de son répertoire. Nous allons appeler la notre "actu.org". |
| |
| On considère que vous avez installé Jelix (Édition developer) comme indiqué sur la page d'[[manuel:installation|installation]] et que vous utilisez la configuration par défaut sans avoir modifié son arborescence. Il faut avoir aussi installé PHP et PHP-cli comme il est précisé dans cette même page, pour utiliser le script //jelix.php//. | On considère que vous avez installé Jelix ([[telechargement:stable#edition-developer|Édition Developer]]) comme indiqué sur la page d'[[manuel:installation|installation]] et que vous utilisez la configuration par défaut sans avoir modifié son arborescence. Il faut avoir aussi installé PHP et PHP-cli comme il est précisé dans cette même page, pour utiliser le script //jelix.php//. |
| | |
| |
| |
| ===== Découverte de Jelix-Scripts ===== | ===== Découverte de Jelix-Scripts ===== |
| |
| Jelix est fourni avec un script, jelix.php, qui facilite la création et la modification des différents fichiers d'une application basée sur Jelix : il est possible de créer les répertoires et fichiers de base à la main, mais jelix.php le fait pour vous ! Il faut l'invoquer avec la version ligne de commande de PHP et indiquer en paramètre un nom de commande Jelix, ainsi que d'éventuels paramètres et options : | Jelix (édition //developer//) est fourni avec un script, jelix.php, qui facilite la création et la modification des différents fichiers d'une application basée sur Jelix : il est possible de créer les répertoires et les fichiers de base à la main mais jelix.php le fait pour vous ! Il faut l'invoquer avec la version ligne de commande de PHP et indiquer en paramètre un nom de commande Jelix, ainsi que d'éventuels paramètres et options : |
| |
| <code bash> | <code bash> |
| Il est possible d'éviter cela en stockant le nom de l'application dans la variable d'environnement **JELIX_APP_NAME**. | Il est possible d'éviter cela en stockant le nom de l'application dans la variable d'environnement **JELIX_APP_NAME**. |
| |
| Pour notre exemple, faites donc ceci : | Pour notre exemple faites donc ceci : |
| |
| <code bash> | <code bash> |
| |
| <code bash> | <code bash> |
| php chemin_jelix/lib/jelix-scripts/jelix.php --actu.org createapp # sous linux | php chemin_jelix/lib/jelix-scripts/jelix.php --actu.org help # sous linux |
| php chemin_jelix\lib\jelix-scripts\jelix.php --actu.org createapp # sous windows | php chemin_jelix\lib\jelix-scripts\jelix.php --actu.org help # sous windows |
| </code> | </code> |
| |
| Notez que nous avons utilisé l'option //-nodefaultmodule// pour la commande //createapp//. Sans cette option, la commande créée aussi un module par défaut du même nom que l'appli (donc //actu.org/modules/actu.org//). Mais dans le cadre de ce tutoriel, nous voulons créer nous-même le module. | Notez que nous avons utilisé l'option //-nodefaultmodule// pour la commande //createapp//. Sans cette option, la commande créée aussi un module par défaut du même nom que l'appli (donc //actu.org/modules/actu.org//). Mais dans le cadre de ce tutoriel, nous voulons créer nous-même le module. |
| |
| Donc maintenant que nous avons un squelette d'application, il va falloir créer un module, car pour le moment, votre application ne peut rien faire puisqu'il n'y a aucune action définie. En effet, il va falloir déclarer et implémenter des actions. Une action peut être l'affichage d'une page, la sauvegarde d'un formulaire, un appel de service web, etc… | Donc maintenant que nous avons un squelette d'application, il va falloir créer un module, car pour le moment, votre application ne peut rien faire puisqu'il n'y a aucune action définie. En effet, il va falloir déclarer et implémenter des actions. Une action peut être l'affichage d'une page, la sauvegarde d'un formulaire, un appel de service web, etc... |
| |
| Les actions sont regroupées dans des modules distincts selon le domaine fonctionnel auquel elles sont rattachées. Nous allons créer par exemple un module qui va regrouper les actions pour afficher et gérer des news. Pour ce faire, il existe la commande **createmodule**, qui prend en paramètre le nom du module à créer. | Les actions sont regroupées dans des modules distincts selon le domaine fonctionnel auquel elles sont rattachées. Nous allons créer par exemple un module qui va regrouper les actions pour afficher et gérer des news. Pour ce faire, il existe la commande **createmodule**, qui prend en paramètre le nom du module à créer. |
| Nous sommes maintenant prêts à définir des actions. | Nous sommes maintenant prêts à définir des actions. |
| |
| ---- | |
| * Suite : [[tutoriels:principal:creation-action|Création d'une action]] | |
| * [[tutoriels:principal|Retour au sommaire]] | |
