putenv

(PHP 4, PHP 5, PHP 7)

putenvУстанавливает значение переменной среды

Описание

putenv ( string $setting ) : bool

Добавляет setting в переменные окружения сервера. Переменная будет существовать только на время выполнения текущего запроса. По его завершении переменная вернется в изначальное состояние.

Изменение множества переменных среды потенциально небезопасно. Директива safe_mode_allowed_env_vars содержит список разделенных запятой префиксов. В безопасном режиме пользователь может менять значения только тех переменных, имена которых начинаются с перечисленных префиксов. По умолчанию пользователи могут менять только те переменные, которые начинаются с PHP_ (например, PHP_FOO=BAR). Замечание: Если эта директива пустая, PHP позволит пользователям менять ЛЮБЫЕ переменные!

Директива safe_mode_protected_env_vars содержит список разделенных запятой имен переменных среды, которые пользователю запрещено изменять функцией putenv(). Эти переменные будут защищены, даже если safe_mode_allowed_env_vars разрешает их изменение.

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

setting

Установка вида "FOO=BAR"

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

Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.

Примеры

Пример #1 Установка значения переменной среды

<?php
putenv
("UNIQID=$uniqid");
?>

Примечания

Внимание

Директивы safe_mode_allowed_env_vars и safe_mode_protected_env_vars работают только в безопасном режиме.

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

  • getenv() - Получение значения переменной окружения
  • apache_setenv() - Устанавливает переменную subprocess_env Apache