getenv

(PHP 4, PHP 5, PHP 7, PHP 8)

getenv — 獲取一個(gè)環(huán)境變量的值

說(shuō)明

getenv(string $varname, bool $local_only = false): string
getenv(): array

獲取一個(gè)環(huán)境變量的值。

使用 phpinfo() 你可以看到所有環(huán)境變量的列表。 這些變量很多都在 ? RFC 3875 的范圍之內(nèi)， 尤其是章節(jié)4.1，"Request Meta-Variables"。

參數(shù)

varname

變量名。

local_only

設(shè)置為 true 以僅返回本地環(huán)境變量（由操作系統(tǒng)或 putenv() 設(shè)置）。

返回值

返回環(huán)境變量 varname 的值， 如果環(huán)境變量 varname 不存在則返回 false。 如果省略 varname，則所有環(huán)境變量都將作為關(guān)聯(lián)數(shù)組 array 返回。

更新日志

版本 說(shuō)明
7.1.0 現(xiàn)在可以省略 varname 來(lái)檢索所有環(huán)境變量的關(guān)聯(lián)數(shù)組 array。
5.5.38, 5.6.24, 7.0.9 添加 local_only 參數(shù)。

注釋

警告

如果 PHP 在諸如 Fast CGI 之類的 SAPI 中運(yùn)行，則此函數(shù)將始終返回由 SAPI 設(shè)置的環(huán)境變量的值，即使已使用 putenv() 來(lái)設(shè)置同名的本地環(huán)境變量。使用 local_only 參數(shù)返回本地設(shè)置的環(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')
?>

參見(jiàn)