getenv

(PHP 4, PHP 5, PHP 7)

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

Описание

string getenv ( string $varname [, bool $local_only = FALSE ] )
array getenv ( void )

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

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

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

varname

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

local_only

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

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

Возвращает значение переменной среды varname или FALSE, если переменной varname не существует. Если varname опущен, будет возвращены все переменные окружения в виде ассоциативного массива (array).

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

Версия Описание
7.1.0 Параметр varname теперь может быть опущен для получения ассоциативного массива ( array) всех переменных окружения.
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 или $_ENV)
$ip $_SERVER['REMOTE_ADDR'];

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

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