Raccourcis : Contenu - rubriques - sous rubriques
EN FR

Ce chapitre explique comment installer une application existante, créée avec Jelix. Nous allons prendre l'installation de testapp en exemple mais les explications sont valables pour n'importe quelle application.

Testapp est disponible en téléchargement. C'est une application testant divers composants de Jelix. Elle sert principalement aux développeurs de Jelix, mais vous pouvez l'installer pour voir des exemples d'utilisation.

Installation des fichiers

L'application peut être fournie sous forme d'une archive zip ou gz. Il est également possible que vous ayez accés au code source de l'application au travers d'un gestionnaire de code source (subversion, mercurial, git...). Cette deuxième solution est à préférer, surtout en milieu professionnel : ça facilite les mises à jour.

Quand vous décompressez l'archive, ou récupérerez les sources à partir d'un gestionnaire de sources, vous obtenez les répertoires suivants :

  testapp/          répertoire de l'application
      install/      scripts d'installation
      modules/      modules de l'application
      plugins/      plugins de l'application
      responses/    les réponses personnalisées
      var/          répertoire qui contient tout les fichiers créés ou susceptibles d'être modifiés par Jelix, pendant l'exécution
         config/    fichiers de configuration de l'application
         log/       fichiers journaux de l'application et de Jelix
      www/          racine du site de l'application (document root)

Peut être aussi est-il fourni le répertoire lib/ de Jelix, ainsi qu'un répertoire temp. Si ce n'est pas le cas, vous devez télécharger Jelix.

Vous copierez ensuite tout ces répertoires sur le serveur, dans le répertoire adéquate, qu'on appellera ici monsite/. Vous avez donc :

  monsite/
      lib/
      temp/
      testapp/

Par défaut, l'arborescence des sources est organisée de façon à installer l'application sur un serveur sur lequel vous pouvez spécifier le répertoire racine public du site (document root). Ce répertoire est monsite/testapp/www/ .

Vous pouvez modifier l'emplacement de ces répertoires si par exemple vous ne pouvez pas modifier le document root, mais ce n'est pas recommandé, pour des raisons de sécurité.

Vous remarquerez que les fichiers propres à l'application et ceux du framework sont séparés. Vous pouvez ainsi partager le répertoire lib avec plusieurs applications.

Renommer les fichiers de configuration

Dans testapp/var/config/ vous avez probablement des fichiers *.dist. Renommez-les en enlevant cette particule '.dist'. Il y a certainement des choses à modifier dans ces nouveaux fichiers, comme les paramètres d'accès à la base de donnée (profiles.ini.php) etc. Nous allons voir comment plus loin.

Créer le répertoire temporaire

Dans monsite/temp/ vous devez créer le dossier testapp. Peut-être votre application contient-elle plusieurs fichiers *.init.php, similaires au fichier application.init.php. Il se peut que chacun de ces fichiers déclare un répertoire temporaire différent. Créez donc ces répertoires temporaires.

Configurer le serveur

Vous devez configurer le serveur web correctement (virtual host, document root..) ainsi qu'une éventuelle base de donnée. Reportez vous au chapitre correspondant, et continuez à la section suivante.

Installer l'application

Il y a trois façon d'installer une application Jelix, selon ce qui est fourni avec l'application.

Avec un assistant d'installation

Un script testapp/www/install.php peut être fourni. Il s'agit alors très probablement d'un script d'installation se lançant via le navigateur (un wizard). Ouvrez donc votre navigateur, et taper l'url de votre application, par exemple http://www.monsite.com/install.php. Suivez alors les instructions. Un wizard bien conçu modifiera pour vous les fichiers de configuration, comme pour la connexion à la base de données, et d'autres paramètres, après vous avoir demander les informations nécessaires.

Avec le script d'installation de l'application

Si il y a un script testapp/install/installer.php, il s'agit alors d'un script à lancer en ligne de commande, et qui va installer l'application. Il vous faut au préalable renseigner vous même à la main les fichiers profiles.ini.php et mainconfig.ini.php. Lisez la documentation de l'application. Ensuite, en ligne de commande, vous taperez php.exe installer.php en étant dans le répertoire testapp/install/.

Avec l'installateur de Jelix

Si il n'y a ni wizard, ni script d'installation dédié, il faudra alors utiliser la commande installapp de jelix-scripts. Comme précédemment, renseignez bien le contenu des fichiers profiles.ini.php et mainconfig.ini.php, et lancez en ligne de commande, dans le répertoire testapp/, php cmd.php installapp. Voir le chapitre sur jelix-scripts pour plus de détails sur le fonctionnement de cmd.php

Après l'une de ces manipulations, l'application devrait fonctionner correctement.

Si le system d'installation est désactivé dans la configuration

Pour certains projets, spécialement pour des projets internes où le processus de mise en production ou de mise à jour est vraiment spécifique, le choix de désactiver le système d'installation de jelix (disableInstallers=on) a pu être fait. Dans ce cas, il n'y a pas besoin de lancer l'installateur de l'application ou de jelix, il est de la responsabilité de l'intervenant de configurer et d'installer tout ce qu'il faut pour que l'application fonctionne (base de données et son contenu par ex), "à la main" ou par des scripts "maison" du processus d'installation interne.