getenv

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

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

說明

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

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

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

參數(shù)

varname

變量名。

local_only

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

返回值

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

更新日志

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

注釋

警告

如果 PHP 在諸如 Fast CGI 之類的 SAPI 中運行，則此函數(shù)將始終返回由 SAPI 設置的環(huán)境變量的值，即使已使用 putenv() 來設置同名的本地環(huán)境變量。使用 local_only 參數(shù)返回本地設置的環(huán)境變量的值。

范例

示例 #1 getenv() 例子

<?php
// getenv() 使用示例
$ip = getenv('REMOTE_ADDR');

// 或簡單僅使用全局變量（$_SERVER 或 $_ENV）
$ip = $_SERVER['REMOTE_ADDR'];

// 安全地獲取環(huán)境變量，忽略通過 SAPI 或 putenv 修改的值
$ip = getenv('REMOTE_ADDR', true) ?: getenv('REMOTE_ADDR')
?>

參見