getenv
(PHP 4, PHP 5, PHP 7)
getenv — Получение значения переменной окружения
Описание
$varname
, bool $local_only = false
) : stringПолучает значение переменной среды.
Список всех переменных окружения можно посмотреть с помощью функции 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');
?>
Смотрите также
- putenv() - Устанавливает значение переменной среды
- apache_getenv() - Возвращает переменную окружения подпроцесса сервера Apache
- Суперглобальные переменные