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


(PHP 4, PHP 5)

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

Описание

bool putenv ( string $setting )

Добавляет 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() - Получение значения переменной окружения