环境变量

许多环境变量可用于控制MapServer的行为或指定某些资源的位置。

CURL_CA_BUNDLE

用于指定当在WMS/WFS客户端层中使用HTTPS连接时,curl要使用的证书颁发机构(CA)绑定文件的位置。默认情况下,curl与自己的CA包捆绑在一起,因此除非您有一个异常的安装,否则不需要此变量:

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

5.4.1 新版功能.

MS_DEBUGLEVEL

DEBUG MS_DEBUGLEVEL MS_ERRORFILE

DEBUG

例如,当通过在加载映射之前启用计时/调试输出来优化应用程序时,此选项才能发挥最大效用,可以用来捕获完整的进程初始化和映射加载时间。

5.0 新版功能.

MS_ENCRYPTION_KEY

参见

msencrypt

4.10 新版功能.

MS_ERRORFILE

'ms-errorfile'环境变量指定日志记录/调试输出的位置,可能的值为磁盘上的文件路径或以下特殊值之一:

  • “stderr”将输出发送到标准错误。apache stderr下是apache错误日志文件。在IIS中,stderr将转到stdout,因此不鼓励使用它。对于IIS,建议直接输出到磁盘上的文件。

  • “stdout”将输出与mapserver的其余输出结合发送到标准输出。

  • “WindowsDebug”将输出发送到Windows OutputDebugString API,允许使用外部程序(如SysInternals DebugView)显示调试输出。

可以将'ms_errorfile'指定为环境变量或通过mapfile中的'config'指令:

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

或:

CONFIG  "MS_ERRORFILE" "stderr"

如果同时设置了'ms-errorfile'环境变量,并且设置了'config``ms-errorfile',则以'config'指令为准。

如果未设置'ms_errorfile',则禁用错误/调试日志记录。在分析 Mapfile 的过程中,只有在分析了'ms_errorfile'指令之后,错误/调试日志记录才可用。

MS_MAP_NO_PATH

'ms_map_no_path'环境变量可以设置为任何值,以禁止在map=中使用显式路径。URL参数。将'ms_map_no_path'设置为**任意值**将强制在mapserv cgi urls中使用map=<env_variable_name>机制。

如果未设置此变量,则不会发生任何更改,并且mapserv cgi仍然通过map=接受显式文件路径。

例如,在Apache的httpd.conf中设置set`ms_map_nopath`和一些mapfile路径:

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

然后调用mapserv cgi必须为map=使用环境变量。参数::

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

5.4 新版功能.

MS_MAPFILE

如果未提供URL参数,则使用的 Mapfile 。

也可以使用环境变量名作为map=的值。此环境变量的值将用作 Mapfile 路径::

map=ENV_VAR
MS_MAPFILE_PATTERN

` ms_mapfile_pattern`可用于重写用于验证mapfile文件扩展名的默认正则表达式。

此变量的默认值为:

MS_MAPFILE_PATTERN='\.map$'
MS_MAP_PATTERN

'ms_map_pattern'环境变量可用于指定正则表达式,该表达式必须与传递给map=中mapserv cgi的所有mapfile路径匹配。URL参数。

如果未设置“ms-map-pattern”,则可以加载任何.map文件。

例如,使用Apache的setenv?将 Mapfile 限制到/opt/mapserver/目录和子目录的指令:

SetEnv MS_MAP_PATTERN "^/opt/mapserver/"

5.4 新版功能.

MS_MODE

模式的默认值为..URL参数。设置模式=…在URL中,优先于环境变量。

MS_OPENLAYERS_JS_URL

可以在使用ImageType应用程序/Openlayers测试WMS服务时使用的Openlayers JavaScript库的URL参数,例如:

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

设置 WEB TEMPPATH.

6.0 新版功能.

MS_XMLMAPFILE_XSLT

用于支持XML Mapfile 的启用。可以指向用于xml->text mapfile转换的XSLT的位置。

PROJ_LIB

The PROJ_LIB environment variable or CONFIG directive can be used to specify the directory where the PROJ data files (including the "epsg" file) are located, if they are not in the default directory where PROJ expects them.

参见

Setting the location of the epsg file 在 :ref:`errors`里面 .