Apache module mod_env

This module is contained in the mod_env.c file, and is compiled in by default. It provides for passing environment variables to CGI/SSI scripts. Is is only available in Apache 1.1 and later.

Summary

This module allows Apache's CGI and SSI environment to inherit environment variables from the shell which invoked the httpd process. CERN web-servers are able to do this, so this module is especially useful to web-admins who wish to migrate from CERN to Apache without rewriting all their scripts

Directives


PassAllEnv

Syntax: PassAllEnv On | Off
Default: Off
Context: directory
Status: Base
Module: mod_env
Compatibility: PassAllEnv is only available in Apache 1.3.5 and later.

This directive controls whether all of the server's environment variables should be made available to CGI scripts and SSI documents, or only those explicitly named by PassEnv directives or otherwise created by the server itself.

It is highly recommended that this functionality be enabled only with extreme caution and after careful examination of whether the entire environment is needed.

Because of security considerations, PassAllEnv may only appear inside <Directory> and <Location> containers in the server configuration files.


PassEnv

Syntax: PassEnv variable variable ...
Context: server config, virtual host
Status: Base
Module: mod_env
Compatibility: PassEnv is only available in Apache 1.1 and later.

Specifies one or more environment variables to pass to CGI scripts from the server's own environment. Example:

    PassEnv LD_LIBRARY_PATH

SetEnv

Syntax: SetEnv variable value
Context: server config, virtual host
Status: Base
Module: mod_env
Compatibility: SetEnv is only available in Apache 1.1 and later.

Sets an environment variable, which is then passed on to CGI scripts. Example:

    SetEnv SPECIAL_PATH /foo/bin

UnsetEnv

Syntax: UnsetEnv variable variable ...
Context: server config, virtual host
Status: Base
Module: mod_env
Compatibility: UnsetEnv is only available in Apache 1.1 and later.

Removes one or more environment variables from those passed on to CGI scripts. Example:

    UnsetEnv LD_LIBRARY_PATH