Chapitre: Installation d'une application
| « Configurer un serveur de production | ^ Déployer une application jelix | Mettre à jour une application » |
− Table des matières
Ce chapitre explique comment installer une application existante, créée avec Jelix.
Imaginons que l'on veuille installer une application nommée 'testapp'.
Installation des fichiers ¶
L'application peut être fournie sous forme d'une archive zip ou gz. Il est également possible que vous installiez les sources directement à partir d'un gestionnaire de code source (git, mercurial, subversion...). Ou encore que les sources soient copiées et mise à jour sur le serveur par des outils de déploiement.
Quelle que soit la méthode utilisée, vous aurez un répertoire, nommé 'testapp'
par exemple, que vous installez dans le répertoire srv/ par exemple de votre
serveur. Vous obtenez les répertoires suivants :
/srv/testapp/ répertoire de l'application
install/ scripts d'installation
modules/ modules de l'application
plugins/ plugins de l'application
app/system/ fichiers de configuration statiques de l'application
app/responses/ les réponses personnalisées
temp/
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 dépendants de l'environnement
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 peut etre lancer Composer
pour installer les paquets dont dépend l'application, ou tout simplement
télécharger Jelix.
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
/srv/testapp/www/.
Vous pouvez déplacer le contenu du répertoire www/ si par exemple vous ne
pouvez pas modifier le document root, mais attention à ne pas exposer le reste
des fichiers au reste du monde, pour des raisons de sécurité.
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.
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.
Lancer l'installateur de 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, donc une
page web. 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 ¶
Lancez le script testapp/install/configurator.php pour configurer
l'application. Des configurateurs de modules modifieront des choses et vous demanderont peut-être
des informations.
Peut-être qu'il y a des choses à terminer de configurer à la main.
Il faut que les fichiers de configuration comme var/config/profiles.ini.php
et var/config/localconfig.ini.php soient bien renseignés. Lisez la documentation de
l'application.
Ensuite lancez le script testapp/install/installer.php, qui va faire
l'installation ou des mises à jour: création de tables en bases de données
par exemple, mise à jour de données etc.
Après 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.
