virtual
(PHP 4, PHP 5, PHP 7)
virtual — 执行 Apache 子请求
说明
virtual (
string
$filename ) :
bool
virtual() 是一个 Apache 特有函数， 类似于 mod_include 中的 <!--#include virtual...-->。 它执行一个 Apache 子请求。可用于包含一个 CGI 脚本或 .shtml 文件，或任何其它可通过 Apache 解析的请求。注意对一个 CGI 脚本，该脚本 生成合法的 CGI 头，至少必须 生成Content-Type 头。
为运行子请求，所有缓冲将中止并刷新至浏览器，包括头信息。
、 仅在将 PHP 安装为 Apache 模块时，支持此函数。
参数
-
filename -
virtual命令将执行的文件
返回值
成功执行 virtual 命令，或失败时返回 FALSE 。
更新日志
| 版本 | 说明 |
|---|---|
| 4.3.3 | 从 PHP 4.3.3 起，也可在 Netscape/iPlanet/SunONE Web 服务器的 NSAPI 服务器模块使用此函数。 |
| 4.0.6 | 此函数可用于 PHP 文件。但是通常使用 include 或 require 更好。 |
范例
示例请看 apache_note() 。
注释
Warning
查询字符串可被传递至被包含文件，但是 $_GET 是拷贝于父文件，仅有 $_SERVER['QUERY_STRING'] 将填充传递入的查询字符串。 且此查询字符串只在使用 Apache 2 时被填充。 此请求文件将不会显示在 Apache 访问日志中。
Note:
在被请求文件中设置的环境变量在原请求文件中不可见。
