apache_getenv
(PHP 4 >= 4.3.0, PHP 5)
apache_getenv — Get an Apache subprocess_env variable
Description
string apache_getenv
( string
$variable
[, bool $walk_to_top = false
] )
Retrieve an Apache environment variable specified by
variable.
This function requires Apache 2 otherwise it's undefined.
Parameters
-
variable -
The Apache environment variable
-
walk_to_top -
Whether to get the top-level variable available to all Apache layers.
Return Values
The value of the Apache environment variable on success, or FALSE on
failure
Examples
Example #1 apache_getenv() example
The example above shows how to retrieve the value of the Apache environment variable SERVER_ADDR.
<?php
$ret = apache_getenv("SERVER_ADDR");
echo $ret;
?>
The above example will output something similar to:
42.24.42.240
See Also
- apache_setenv() - Set an Apache subprocess_env variable
- getenv() - Gets the value of an environment variable
- Superglobals
Коментарии
apache_getenv(key) does not work on an php cgi installation, in this case rather use $_SERVER["REDIRECT_key"]This manual page is unclear as to whether it will fetch Apache configuration environment variables set by "SetEnv" (including "SetEnvIf[NoCase]" or "BrowserMatch" e.g.) as the only example given is with a pre-defined CGI interface variable (which is also available via the $_SERVER[] array). If custom Apache runtime configuration variables are indeed fetchable via this interface, let's say so or give an example of such.