« get\_resourcesgetlastmod »PHP ManualОпції PHP/інформаційні функції

getenv

(PHP 4, PHP 5, PHP 7, PHP 8)

getenv — Отримує значення однієї чи всіх змінних оточення

Опис

getenv(?string $name = null, bool $local_only = false): string|array|false

Отримує значення однієї чи всіх змінних оточення.

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

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

name

Ім'я змінної у вигляді рядка (string) або null

local_only

Если установлено значение**true**, повертаються лише локальні змінні оточення, встановлені операційною системою або командою putenv. Це має значення лише в тому випадку, якщо параметр nameявляется строкой (string).

Значення, що повертаються

Повертає значення змінної оточення nameили**false**, якщо змінна оточення name не існує. Якщо name одно null, повертаються всі змінні оточення як асоціативного масиву (array).

список змін

ВерсияОпис
8.0.0Параметрname тепер припускає значення null
7.1.0Параметрname тепер може бути опущений щоб одержати асоціативного масиву (array) всіх змінних оточення.
7.0.9Було додано параметр local_only

Приклади

Приклад #1 Приклад використання getenv()****

Loading...

Примітки

Увага

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

Дивіться також