import_request_variables()

将页面传值写入全局作用域

import_request_variables 函数可以在 register_global = off 时，把 GET/POST/Cookie 变量导入全局作用域中。

描述

1
bool import_request_variables ( string types [, string prefix])
将 GET/POST/Cookie 变量导入到全局作用域中。如果你禁止了 register_globals，但又想用到一些全局变量，那么此函数就很有用。

你可以使用 types 参数指定需要导入的变量。可以用字母'G'、'P'和'C'分别表示 GET、POST 和 Cookie。这些字母不区分大小写，所以你可以使用'g'、'p'和'c'的任何组合。POST 包含了通过 POST 方法上传的文件信息。注意这些字母的顺序，当使用“gp”时，POST 变量将使用相同的名字覆盖 GET 变量。任何 GPC 以外的字母都将被忽略。

prefix 参数作为变量名的前缀，置于所有被导入到全局作用域的变量之前。所以如果你有个名为“userid”的 GET 变量，同时提供了“pref_”作为前缀，那么你将获得一个名为 $pref_userid 的全局变量。

如果你对导入其它全局变量（例如 SERVER 变量）感兴趣，请考虑使用 extract()。

注: 虽然 prefix 参数是可选的，但如果不指定前缀，或者指定一个空字符串作为前缀，你将获得一个 E_NOTICE 级别的错误。使用默认错误报告级别是不显示注意（Notice）级别的错误的。

code

1
<?php
2
// This will import GET and POST vars
3
// with an "rvar_" prefix
4
import_request_variables("gp", "rvar_");
5
echo $rvar_foo;
6
?>
使用import_request_variables()函数可以有选择地注册全局变量集合。你可以使用该函数导入 $_GET、$_POST和$_COOKIE的值，还可以为每个导入的变量添加前缀（prefix）。

参数中types字符串中允许为g、p、c字符，或者3个字符间任意的组合。其中，“g”表示GET变量，“p”表示POST变量，“c”表示cookies。注意：3个字符的排列顺序是有区别的，当使用“pg”时，POST变量将使用相同的名字覆盖$_GET变量；反之，当使用“gp”时，$_GET变量数组将优先于$_POST。

使用import_request_variable（）函数实现变量导入的脚本例子如下：

1
//导入POST提交的变量值，前缀为post_
2
import_request_variable("p"， "post_");
3
//导入GET和POST提交的变量值，前缀为gp_，GET优先于POST
4
import_request_variable("gp"， "gp_"); 
5
//导入Cookie和GET的变量值，Cookie变量值优先于GET
6
import_request_variable("cg"， "cg_");
如果我们在import_request_variables()函数中使用了“pg参数”，请看如下脚本实例：

01
<?php
02
if(isset($_REQUEST['btn_submit'])){
03
echo "正常取得的表单POST变量值：".$_REQUEST['Username']."<br />";
04
import_request_variables("pg", "import_");
05
//显示导入的变量名称
06
echo "使用import_request_variables函数导入的变量值：".$import_Username;
07
}
08
?>
09
<form id="test_form" name="test_form" method="POST" action="">
10
请输入您的名字：
11
<label>
12
<input type="text" name="Username" id="Username" />
13
</label>
14
<label>
15
<input type="submit" name="btn_submit" id="btn_submit" value="提交" />
16
</label>
17
<br />
18
</form>
该表单提示用户输入一个名字，完成并提交后，脚本会把提交的名字显示在浏览器上。

注意：prefix前缀参数是必选的，如果未指定前缀，或者指定一个空字符串作为变量前缀，PHP会抛出一个E_NOTICE错误。

import_request_variables()函数为我们提供一个中间方法，适用于如下几种情况：

当用户不能使用超级变量数组时；
在php.ini配置文件的register_globals参数为Off（PHP 5之后的版本默认为Off）时，使用import_request_variables将GET/POST/Cookie这几个超级变量数组导入到全局作用域中。
在开发时，只要声明了引入的变量范围，就不必写$_GET或$_REQUEST一堆很长的超级全局数组名称了。