(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 разрешает их изменение.

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


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

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

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


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




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

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

  • getenv() - Получение значения переменной окружения


Environment variables are part of the underlying operating system's
way of doing things, and are used to pass information between a parent
process and its child, as well as to affect the way some internal
functions behave.  They should not be regarded as ordinary PHP

A primary purpose of setting environment variables in a PHP script is
so that they are available to processes invoked by that script using
e.g. the system() function, and it's unlikely that they would need to
be changed for other reasons.

For example, if a particular system command required a special value
of the environment variable LD_LIBRARY_PATH to execute successfully,
then the following code might be used on a *NIX system:

getenv("LD_LIBRARY_PATH");        // save old value
$newld "/extra/library/dir:/another/path/to/lib"// extra paths to add
if ($saved) { $newld .= ":$saved"; }           // append old paths if any
putenv("LD_LIBRARY_PATH=$newld");        // set new value
system("mycommand -with args");        // do system command; 
                        // mycommand is loaded using
                        // libs in the new path list
putenv("LD_LIBRARY_PATH=$saved");        // restore old value

It will usually be appropriate to restore the old value after use;
LD_LIBRARY_PATH is a particularly good example of a variable which it
is important to restore immediately, as it is used by internal

If php.ini configuration allows, the values of environment variables
are made available as PHP global variables on entry to a script, but
these global variables are merely copies and do not track the actual
environment variables once the script is entered.  Changing
$REMOTE_ADDR (or even $HTTP_ENV_VARS["REMOTE_ADDR"]) should not be
expected to affect the actual environment variable; this is why
putenv() is needed.

Finally, do not rely on environment variables maintaining the same
value from one script invocation to the next, especially if you have
used putenv().  The result depends on many factors, such as CGI vs
apache module, and the exact way in which the environment is
manipulated before entering the script.
2000-09-14 01:23:13
The other problem with the code from av01 at bugfix dot cc is that
the behaviour is as per the comments here, not there:
('MYVAR='); // set MYVAR to an empty value.  It is in the environment
putenv('MYVAR'); // unset MYVAR.  It is removed from the environment
2007-02-16 20:41:21
putenv/getenv, $_ENV, and phpinfo(INFO_ENVIRONMENT) are three completely distinct environment stores. doing putenv("x=y") does not affect $_ENV; but also doing $_ENV["x"]="y" likewise does not affect getenv("x"). And neither affect what is returned in phpinfo().

Assuming the USER environment variable is defined as "dave" before running the following:

print "env is: ".$_ENV["USER"]."\n";
"(doing: putenv fred)\n";
"env is: ".$_ENV["USER"]."\n";
"getenv is: ".getenv("USER")."\n";
"(doing: set _env barney)\n";
"getenv is: ".getenv("USER")."\n";
"env is: ".$_ENV["USER"]."\n";


env is: dave
(doing: putenv fred)
env is: dave
getenv is: fred
(doing: set _env barney)
getenv is: fred
env is: barney


Variable => Value
USER => dave
2010-06-21 20:52:25
It's the putenv() type of environment variables that get passed to a child process executed via exec().

If you need to delete an existing environment variable so the child process does not see it, use:


That is, leave out both the "=" and a value.
2012-03-27 21:28:07

    Поддержать сайт на родительском проекте КГБ