Опции PHP/Информационные функции
PHP Manual

getenv

(PHP 4, PHP 5, PHP 7)

getenv Получение значения переменной окружения

Описание

string getenv ( string $varname [, bool $local_only = false ] )

Получает значение переменной среды.

Список всех переменных окружения можно посмотреть с помощью функции phpinfo(). Многие из этих переменных есть в документе » RFC 3875, по большей части в разделе 4.1, "Request Meta-Variables".

Список параметров

varname

Имя переменной.

local_only

Установите в значение TRUE для получения только локальных переменных окружения (установленные операционной системой или командой putenv).

Возвращаемые значения

Возвращает значение переменной среды varname или FALSE, если переменной varname не существует.

Список изменений

Версия Описание
5.5.38, 5.6.24, 7.0.9 Был добавлен параметр local_only.

Примечания

Внимание

Если PHP запущен в SAPI, например как Fast CGI, эта функция будет возвращать значения переменных окружения установленных SAPI, даже если вы использовали putenv() для установки локальной переменной с таким же именем. Используйте параметр local_only для получения установленных локально переменных.

Примеры

Пример #1 Пример использования getenv()

<?php
// Пример использования getenv()
$ip getenv('REMOTE_ADDR');

// можно еще воспользоваться суперглобальной переменной ($_SERVER or $_ENV)
$ip $_SERVER['REMOTE_ADDR'];

// Гарантированно получаем значение переменной окружения, не обращая внимания,
// была ли она переопределена SAPI или изменена с помощью putenv
$ip getenv('REMOTE_ADDR'true) ?: getenv('REMOTE_ADDR')
?>

Смотрите также


Опции PHP/Информационные функции
PHP Manual