Raccourcis : Contenu - rubriques - sous rubriques
EN FR
La page correspondant à la dernière version stable est consultable dans le Manuel Jelix 1.8

Cette section ne concerne pas les modules fraîchement créés avec la commande createmodule, puisque celle-ci leurs assigne automatiquement un niveau d'accès et les installe. Par contre, pour créer un module "à la main" ou utiliser un module existant fourni avec jelix ou provenant d'un autre projet, il faut suivre les instructions qui suivent.

Niveau d'accès aux modules

Il ne suffit pas d'avoir un module dans un dépôt de module pour que celui-ci soit utilisable directement. Il faut aussi indiquer de quel manière il sera possible d'y accéder, avant de "l'installer". Ceci pour améliorer la sécurité et éviter des dysfonctionnements. En effet, il se peut que vous ayez un dépôt de modules partagé par plusieurs applications, et vous ne voulez pas forcément que certains de ses modules soient utilisables par votre application.

Pour ce faire, il y a une section "modules" dans le fichier defaultconfig.ini.php, qui doit contenir le niveau d'accès de chaque module. Il suffit donc d'indiquer le nom d'un module, suivit de ".access", et de lui attribuer un chiffre. La signification de ce chiffre :

  • 0: le module n'est pas du tout utilisé. C'est l'état par défaut d'un module si celui-ci n'est pas indiqué dans la section modules.
  • 1: les ressources du modules (classes métiers, daos, templates...) peuvent être utilisées par d'autres modules, mais les contrôleurs de ce module, si ils existent, ne peuvent être exécuté. Le module n'est donc pas exécutable depuis un navigateur web, même si des urls sont définies vers ses contrôleurs.
  • 2: le module est utilisable normalement, on peut faire pointer des urls vers ses contrôleurs.

Un exemple :


[modules]
testapp.access = 2
junittests.access = 2
jWSDL.access = 2
jacldb.access = 0
jacl2db.access = 1
jauthdb.access = 1
jauth.access = 2

Les modules testapp, junittests, jWSDL et jauth sont activés normalement. Les modules jacl2db et jauthdb ne sont activés que pour un usage "interne", donc ne sont pas accessible depuis le web, et seul d'autres modules peuvent appeler leurs daos, templates etc. Le module jacldb n'est pas du tout activé. Il n'est pas utilisable, et est "invisible" pour tout les modules.

Bien sûr, si vous avez plusieurs points d'entrée, vous avez alors forcément des modules utilisables par certains points d'entrées et pas par d'autres. Il faut alors définir la section modules dans les configurations de chaque point d'entrée, sachant que les valeurs définies dans le fichier defaultconfig.ini.php sont les valeurs "par défaut". Il ne faudra pas oublier aussi de configurer correctement le moteur d'url, afin que les urls générées par Jelix utilisent bien le point d'entrée associé à chacun des modules.

Notez que lorsque vous utilisez la commande createmodule, le module est par défaut activé avec le niveau 2. De plus, les options de configurations checktrustedModules, trustedModules et unusedModules qui existaient dans les versions précédentes de Jelix, ne sont plus supportées et n'ont aucun effet.

Note : si vous voulez rendre accessible tous les modules (access=2), vous pouvez mettre dans la section globale l'option enableAllModules=on. Les valeurs access dans la section modules ne seront pas pris en compte et ne sont donc pas utiles. Attention, ne l'utilisez que si vous êtes sûr de ce que vous faîtes, vous pourriez activer des modules sans le savoir. À réserver donc que dans des cas particuliers où vous maitrisez la gestion des modules.

Paramètres d'installation

Un module peut avoir un script pour l'installer, et ce script peut avoir besoin de paramètres. Ces paramètres peuvent être indiqués dans une option spécifique de la section "modules" : themodule.installparam=something. Un example pour un module "news":


   news.installparam = "enablecategories,defaultcategory=In the world"

Les paramètres, séparés par une virgule, peuvent être de simples mot-clefs, ou des clés/valeurs.

Si vous ne voulez pas exécuter le script d'installation du module, indiquez le avec l'option "skipinstaller" et la valeur "skip":


news.skipinstaller=skip

Installation d'un module

Après avoir défini le niveau d'accès d'un module, il faut ensuite "installer" le module. Ceci ce fait au moyen de la commande installmodule, qui, concrètement, exécute les scripts d'installations éventuels fournis dans le module (qui se chargeront par exemple de créer les tables nécessaires en base de données, voir le chapitre sur la création de tels scripts), puis met à jour un fichier var/config/installer.ini.php, qui contient entre autre le numéro de la version de chaque module installé, pour chaque point d'entrée.

Par exemple, pour utiliser le module jauth fourni avec jelix, après lui avoir déclaré son niveau d'accès dans la configuration, il faut faire ceci :


php jelix.php --myapp installmodule jauth

Notez que la commande createmodule active automatiquement le module nouvellement créé.

Note : il est possible de désactiver complètement le système d'installation, donc que les modules soient implicitement "installés", sans avoir à exécuter la commande installapp ou installmodule. Pour ce faire, dans la section globale de la configuration, mettez disableInstallers=on. Mais attention, les mises à jour des modules et de jelix deviendront très compliquées si vous désactivez cela, car vous devrez faire les installations et les modifications des mises à jour à la main (faire les requêtes nécessaires en base de données etc..). À réserver donc pour des projets bien particuliers, et pour ceux qui maîtrisent totalement le système d'installation, surtout si vous serez amenez à vouloir réactiver les installateurs plus tard. Par conséquent, il est fortement déconseillé de mettre disableInstallers=on.

Mise à jour d'un module

Pour mettre à jour un module, il suffit d'abord de remplacer les sources du module existant par celles de la nouvelle version, puis de lancer la commande installmodule. Le système d'installation de Jelix va alors se charger d'exécuter les scripts de migration du module si il y en a, et de mettre à jour le fichier var/config/installer.ini.php. Bien entendu, cela ne fonctionnera que si le fichier module.xml du module est bien renseigné au niveau du numéro de version du module.

Si vous avez plusieurs modules à mettre à jour, vous pouvez exécuter la commande installapp, qui migrera tous les modules à jour. Cela est très utile en fait pour mettre à jour une application en production.

Note : si vous avez désactivé le système d'installation avec disableInstallers=on, il ne sert à rien d'exécuter la commande installmodule. Mettez à jour les sources du module, faites les mises à jour "à la main" (base de données etc), et c'est tout.