Prérequis pour l’installation de Lizmap Web Client

Note

Si vous voulez installer rapidement pour tester Lizmap Web Client en quelques étapes, suivez ces instructions.

Qgis serveur

Avertissement

Avant d’installer la partie Qgis Server, il est hautement recommandé d’utiliser la même version de Qgis Desktop et de Qgis Server.

Même si des fonctions devraient fonctionner, il y a une probabilité que certaines configurations ne fonctionnent pas si ces deux versions sont différentes.

La raison est que QGIS Server version X peut ne pas pouvoir charger un projet créé avec la version Y de QGIS Desktop.

Suivez la documentation de QGIS pour installer QGIS Server : https://docs.qgis.org/latest/fr/docs/server_manual/index.html .

En plus d’un serveur web (Apache ou Nginx), vous devez installer QGIS Server. Avec Nginx, la configuration recommandée est d’utiliser spawn-fcgi. Ne pas utiliser fcgiwrap, cette solution n’est pas efficace.

Dans la configuration Nginx, il est conseillé d’utiliser la variable QGIS_OPTIONS_PATH pour un dossier avec les droits d’écriture pour www-data. Cela est expliqué dans la documentation Qgis serveur.

Vous devriez également installer et configurer XVFB mentionné dans la documentation QGIS. Cela est utile pour les impressions PDF. Vous pouvez ignorer la section si vous ne planifiez pas d’imprimer en PDF du côté serveur.

Après avoir configurer votre serveur web avec Qgis serveur, vérifiez que l’URL de Qgis serveur fonctionne. Vous obtiendrez probablement un XML semblable à :

<ServerException>Project file error</ServerException>

Gardez cette URL, nous l’utiliserons plus tard dans le panneau d’administration de Lizmap.

Avertissement

Nous vous encourageons fortement de configurer QGIS Server sur un hôte virtuel différent que celui de Lizmap Web Client. L’URL de QGIS Server doit rester privée, accessible uniquement depuis le PHP de Lizmap.

Sinon, surtout après avoir installé le plugin Lizmap dans QGIS Server, un utilisateur pourrait accéder à des données privées en contournant Lizmap, en passant directement par l’URL du serveur QGIS.

Plugins Qgis serveur

Certains plugins peuvent être ajoutés à Qgis serveur. Cela activera certaines fonctionnalités dans Lizmap. Ce n’est pas obligatoire mais dans certaines situations, c’est mieux.

Soit vous configurez la variable d’environnement QGIS_PLUGIN_PATH pendant l’installation de Qgis serveur, soit utiliser celle par défaut fournie par Qgis. https://docs.qgis.org/latest/fr/docs/server_manual/config.html#environment-variables

Astuce

Pour configurer les extensions QGIS Serveur, nous encourageons l’utilisation de qgis-plugin-manager, un outil CLI pour installer et mettre à jour des extensions. https://pypi.org/project/qgis-plugin-manager/

PostgreSQL

It’s possible to edit layers with Lizmap, but the layer must be stored in PostgreSQL. See Pré-requis.