Variables d’environnement

Un certain nombre de variables d’environnement peut être utilisé pour contrôler le comportement de Mapserver ou spécifier l’emplacement de certaines ressources

CURL_CA_BUNDLE

Utilisé pour spécifier l’emplacement d’un fichier d’une Autorité de certification (CA) qui sera utilisé par Curl quand on utilise des connexions HTTPS pour accéder à des couches via les clients WMS/WFS. Curl est fourni avec son propre fichier de CA par défaut, ainsi cette variable n’est pas nécessaire à moins que vous ayiez une installation inhabituelle:

export CURL_CA_BUNDLE=/path/to/ca-bundle.crt

Nouveau dans la version 5.4.1.

MS_DEBUGLEVEL

Un niveau de DEBUG par défaut peut être défini en utilisant la variable d’environnement MS_DEBUGLEVEL en combinaison avec la variable MS_ERRORFILE.

Quand elle est définie, cette valeur est utilisée comme la valeur de debug par défaut pour tous les objets MAP et LAYER quand ils sont chargés par le parseur de mapfile. Cette option définit aussi le niveau de debug pour n’importe quel appel msDebug() effectué en dehors du contexte d’un objet MAP ou LAYER, par exemple, pour des instructions de debug relative à l’initialisation avant qu’un mapfile soit chargé. Si une valeur DEBUG est spécifiée aussi dans le mapfile au niveau d’un objet MAP ou LAYER alors la valeur locale (dans le mapfile) a la précédence sur la valeur provenant de la variable d’environnement.

Cette option est principalement utile quand on optimise les applications en permettant une sortie de timing/debug avant que la carte soit chargée, pour décompter tout le temps pris par le processus complet d’initialisation et de chargement de la carte, par exemple.

Nouveau dans la version 5.0.

MS_ENCRYPTION_KEY

Voir aussi

msencrypt

Nouveau dans la version 4.10.

MS_ERRORFILE

La variable d’environnement MS_ERRORFILE spécifie l’emplacement de la sortie de log/debug, avec des valeurs pouvant être autant un chemin vers un fichier sur un disque qu’une des valeurs spéciales suivantes:

  • “stderr” pour envoyer la sortie vers l’erreur standard. Sous Apache, stderr est le fichier error_log de Apache. Sous IIS stderr va vers stdout (la sortie standard) ainsi son usage est à éviter. Avec IIS il est recommandé de diriger la sortie vers un fichier sur le disque à la place.

  • “stdout” pour envoyer la sortie vers la sortie standard, combinée avec le reste de la sortie MapServer.

  • “windowsdebug” pour envoyer la sortie vers l’API OutputDebugString de Windows, qui permet l’utilisation de programmes externes comme debugview fourni par SysInternals pour afficher la sortie de debug.

Il est possible de spécifier MS_ERRORFILE soit comme une variable d’environnement ou via une directive CONFIG dans un mapfile:

CONFIG  "MS_ERRORFILE" "/tmp/mapserver.log"

ou:

CONFIG  "MS_ERRORFILE" "stderr"

Si à la fois la variable d’environnement MS_ERRORFILE est définie et qu’un CONFIG MS_ERRORFILE est défini, alors la directive CONFIG prend la précédence.

Si MS_ERRORFILE n’est pas défini, alors le suivi de log des erreurs/debug est désactivé. Pendant le parsage d’un mapfile, le log des erreurs/debug risque de devenir disponible seulement après que la directive MS_ERRORFILE ait été parsé.

MS_MAP_NO_PATH

La variable d’environnement MS_MAP_NO_PATH peut être définie à n’importe quelle valeur pour interdire l’utilisation de chemins explicites dans le paramètre d’URL map=... . Définir MS_MAP_NO_PATH à n’importe quelle valeur force l’utilisation du mécanisme map=<env_variable_name> dans les URL appelant mapserv CGI.

Si cette variable n’est pas définie alors rien ne change et le programme CGI mapserv accepte toujours les chemins de fichiers explicites via le paramètre d’URL map=... .

Exemple, définir `MS_MAP_NOPATH`et d’autres chemins de mapfile dans le fichier httpd.conf de Apache:

SetEnv MS_MAP_NO_PATH "foo"
SetEnv MY_MAPFILE "/opt/mapserver/map1/mymapfile.map"

et ensuite les appels vers le programme CGI mapserv doivent utiliser des variables d’environnement pour le paramètre map=...

http://localhost/cgi-bin/mapserv?map=MY_MAPFILE&mode=...

Nouveau dans la version 5.4.

MS_MAPFILE

Le mapfile à utiliser si le paramètre d’URL map=... URL n’est pas fourni.

Il est aussi possible d’utiliser une nom de variable d’environnement comme valeur du paramètre dans l’URL map=... La valeur de cette variable d’environnement sera utilisée comme chemin de mapfile:

map=ENV_VAR
MS_MAPFILE_PATTERN

MS_MAPFILE_PATTERN peut être utilisée pour surcharger l’expression régulière par défaut qui est utilisée pour valider les extensions des noms de fichiers mapfile.

La valeur par défaut pour cette variable est:

MS_MAPFILE_PATTERN='\.map$'
MS_MAP_PATTERN

la variable d’environnement MS_MAP_PATTERN peut être utilisée pour spécifier une expression régulière qui doit être respectée par tous les chemins de mapfile passés au programme CGI mapserv dans le paramètre de l’URL map=...

Si MS_MAP_PATTERN n’est pas défini alors n’importe quel fichier .map peut être chargé.

Example, utilisez la directive SetEnv? de Apache pour restreindre vos mapfiles au répertoire /opt/mapserver/ et à ses sous-répertoires:

SetEnv MS_MAP_PATTERN "^/opt/mapserver/"

Nouveau dans la version 5.4.

MS_MODE

La valeur par défaut pour le paramètre d’URL mode=... Définir le mode=... dans l’URL prend la précédence sur la variable d’environnement.

MS_OPENLAYERS_JS_URL

L’URL vers la bibliothèque javascript OpenLayers (peut être utilisée quand vous testez des services WMS en utilisant imagetype application/openlayers), par exemple:

http://openlayers.org/api/OpenLayers.js
MS_TEMPPATH

Définir le TEMPPATH de WEB.

Nouveau dans la version 6.0.

MS_XMLMAPFILE_XSLT

Utilisé pour activer le support des Mapfiles XML. Pointe vers l’emplacement du XSLT à utiliser pour la conversion mapfile XML->mapfile texte.

PROJ_LIB

La variable d’environnement PROJ_LIB ou la directive CONFIG peut être utilisé pour spécifier le répertoire où les fichiers de données PROJ.4 (incluant le fichier “epsg”) sont situés, s’ils ne sont pas dans le répertoire par défaut où PROJ.4 les attend.

Voir aussi

Définir la localisation du fichier epsg dans Erreurs.