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 Serveur sur un hôte virtuel différent que celui de Lizmap Web Client. L’URL de QGIS Serveur 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.

Extensions 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/

• AtlasPrint

  • Pour activer le PDF basé sur la mise en page d’un atlas QGIS

  • https://github.com/3liz/qgis-atlasprint

• Cadastre

  • Cas d’utilisation français uniquement

  • Nécessaire pour le module Cadastre de Lizmap

  • https://docs.3liz.org/QgisCadastrePlugin/module-lizmap/

• Lizmap

  • Lizmap n’est pas seulement une application PHP, il y a aussi une extension Python pour QGIS Serveur pour

    • évaluer QGIS Expressions dans un formulaire sur :

      • contraintes

      • valeur par défaut

      • visibilité des groupes

      • Lire Formulaire avancé.

    • Vérification des listes de contrôle d’accès (ACL, Access Control List) pour les entités et les couches :

      • filtrage par polygone

      • par attribut

    • ajout des variables @lizmap_user et lizmap_user_groups

  • https://github.com/3liz/qgis-lizmap-server-plugin

  • Le plugin n’est pas requis, mais quelques fonctionnalités ne fonctionneront pas comme attendue si le plugin n’est pas installé ou mis à jour.

  • Le nom du plugin est Lizmap server. N’installez pas le plugin Lizmap, qui est le plugin pour Qgis Desktop.

• WfsOutputExtension

  • Pour ajouter un nouveau format lors de l’export des données vectorielles

  • https://github.com/3liz/qgis-wfsOutputExtension

• Journalisation

  • Pour enregistrer dans les journaux de QGIS Server et vider le cache dans QGIS Server

  • https://github.com/3liz/qgis-logging-plugin.

  • Ce plugin est obsolète.

PostgreSQL

PostgreSQL peut être utilisé à deux fins différentes dans Lizmap :

• Pour stocker des données SIG. Aucune configuration n’est nécessaire côté serveur Lizmap Web Client, seul le serveur PostgreSQL doit être accessible depuis le serveur Lizmap Web Client. Il est possible d’éditer des couches avec Lizmap, mais la couche doit être stockée dans PostgreSQL. Voir Pré-requis.

• Pour stocker les utilisateurs et les actions des utilisateurs du client Web Lizmap. Lizmap utilise des tableaux. Ce réglage doit être fait lors de l”installation de Lizmap.