(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');
?>