(PHP 4, PHP 5)

putenv — 设置环境变量的值

说明

添加 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。

范例

Example #1 设置一个环境变量

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

注释

The safe_mode_allowed_env_vars 和 safe_mode_protected_env_vars 指令仅仅在启用安全模式时有效。

参见

getenv() - 获取一个环境变量的值