PHP8 getenv — 獲取單個(gè)或者全部環(huán)境變量

2023-09-16 11:10 更新

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

getenv — 獲取單個(gè)或者全部環(huán)境變量

說(shuō)明

getenv(?string $name = null, bool $local_only = false): string|array|false

獲取單個(gè)或者全部環(huán)境變量。

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

參數(shù)

name

string 形式的變量名或?yàn)?nbsp;null。

local_only

當(dāng)設(shè)置為 true 時(shí)，僅返回由操作系統(tǒng)或 putenv() 設(shè)置的本地環(huán)境變量。這只在 name 是 string 時(shí)才生效。

返回值

返回環(huán)境變量 name 的值，如果環(huán)境變量 name 不存在則返回 false。如果 name 是 null，則所有環(huán)境變量都將作為關(guān)聯(lián) array 返回。

更新日志

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

示例

示例 #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')
?>

注釋

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

參見(jiàn)

  • putenv() - 設(shè)置環(huán)境變量的值
  • apache_getenv() - 獲取 Apache subprocess_env 變量
  • 超全局變量


以上內(nèi)容是否對(duì)您有幫助：
在線(xiàn)筆記
App下載
App下載

掃描二維碼

下載編程獅App

公眾號(hào)
微信公眾號(hào)

編程獅公眾號(hào)