(PHP 4, PHP 5, PHP 7, PHP 8)
getenv — 獲取一個(gè)環(huán)境變量的值
$varname, bool $local_only = false): string獲取一個(gè)環(huán)境變量的值。
使用 phpinfo() 你可以看到所有環(huán)境變量的列表。 這些變量很多都在 ? RFC 3875 的范圍之內， 尤其是章節4.1，"Request Meta-Variables"。
返回環(huán)境變量 varname 的值，
如果環(huán)境變量 varname 不存在則返回 false。
如果省略 varname，則所有環(huán)境變量都將作為關(guān)聯(lián)數組 array 返回。
| 版本 | 說(shuō)明 |
|---|---|
| 7.1.0 |
現在可以省略 varname 來(lái)檢索所有環(huán)境變量的關(guān)聯(lián)數組 array。
|
| 5.5.38, 5.6.24, 7.0.9 |
添加 local_only 參數。
|
如果 PHP 在諸如 Fast CGI 之類(lèi)的 SAPI 中運行，則此函數將始終返回由 SAPI 設置的環(huán)境變量的值，即使已使用 putenv() 來(lái)設置同名的本地環(huán)境變量。使用 local_only 參數返回本地設置的環(huán)境變量的值。
示例 #1 getenv() 例子
<?php
// getenv() 使用示例
$ip = getenv('REMOTE_ADDR');
// 或簡(jiǎn)單僅使用全局變量（$_SERVER 或 $_ENV）
$ip = $_SERVER['REMOTE_ADDR'];
// 安全地獲取環(huán)境變量，忽略通過(guò) SAPI 或 putenv 修改的值
$ip = getenv('REMOTE_ADDR', true) ?: getenv('REMOTE_ADDR')
?>