putenv
(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
。
范例
Example #1 设置一个环境变量
<?php
putenv("UNIQID=$uniqid");
?>
注释
WarningThe safe_mode_allowed_env_vars 和 safe_mode_protected_env_vars 指令仅仅在启用安全模式时有效。
参见
getenv() - 获取一个环境变量的值