array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'ru', ), 'this' => array ( 0 => 'function.getenv.php', 1 => 'getenv', ), 'up' => array ( 0 => 'ref.info.php', 1 => 'Опции PHP/информационные функции', ), 'prev' => array ( 0 => 'function.get-resources.php', 1 => 'get_resources', ), 'next' => array ( 0 => 'function.getlastmod.php', 1 => 'getlastmod', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'ru', 'path' => 'reference/info/functions/getenv.xml', ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); ?>
(PHP 4, PHP 5, PHP 7, PHP 8)
getenv — Получает значение одной или всех переменных окружения
Функция получает значение одной или всех переменных окружения.
Список переменных окружения также выводит функция phpinfo(). Многие из этих переменных описывает раздел 4.1. Request Meta-Variables стандарта » RFC 3875.
Функция возвращает значение переменной окружения name
или false
, если переменная окружения name
не существует.
Если значение параметра name
равно null
, функция
возвращает все переменные окружения в виде ассоциативного массива (array).
Версия | Описание |
---|---|
8.0.0 |
Параметр name теперь принимает значение null .
|
7.1.0 |
Теперь, чтобы получить ассоциативный массив (array) всех
переменных окружения, параметр name можно не указывать.
|
7.0.9 |
Добавлен параметр local_only .
|
Пример #1 Пример использования функции getenv()
<?php
// Пример вызова функции getenv()
$ip = getenv('REMOTE_ADDR');
// Или просто получаем значение из суперглобальной переменной $_SERVER или $_ENV
$ip = $_SERVER['REMOTE_ADDR'];
// Надёжно получаем значение переменной окружения независимо от того,
// установили ли или нет значение через интерфейс SAPI или изменили командой putenv
$ip = getenv('REMOTE_ADDR', true) ?: getenv('REMOTE_ADDR');
?>
Если PHP запустили через интерфейс SAPI наподобие Fast CGI, эта функция будет возвращать
значения переменных окружения, которые установили через SAPI, даже если локальную переменную
с таким же именем установили функцией putenv().
Устанавливайте параметр local_only
, чтобы функция возвращала значение
локальных переменных окружения.