大网数据广告活动
PHP 语言与运行手册

virtual · 执行 Apache 子请求

· 52CE 我爱测

virtual() 是一个 Apache 特有函数, 类似于 mod_include 中的 <!--#include virtual...-->。 它执行一个 Apache 子请求。可用于包含一个 CGI 脚本或 .shtml 文件,或任何其它可通过 Apache 解析的请求。注意对一个 CGI 脚本,该脚本 生成合法的 CGI 头,至少必须 生成Content-Type 头。

virtual

(PHP 4, PHP 5, PHP 7, PHP 8)

virtual — 执行 Apache 子请求

说明

function virtual(string $uri): bool

virtual() 是一个 Apache 特有函数, 类似于 mod_include 中的 <!--#include virtual...-->。 它执行一个 Apache 子请求。可用于包含一个 CGI 脚本或 .shtml 文件,或任何其它可通过 Apache 解析的请求。注意对一个 CGI 脚本,该脚本 生成合法的 CGI 头,至少必须 生成Content-Type 头。

为运行子请求,所有缓冲将中止并刷新至浏览器,包括头信息。

仅在 PHP 以 Apache 模块运行时,才支持此函数。

参数

uri

virtual命令将执行的文件

返回值

成功执行 virtual 命令,或失败时返回 false 。

示例

示例请看 apache_note() 。

注释

警告

查询字符串可被传递至被包含文件,但是 $_GET 是拷贝于父文件,仅有 $_SERVER['QUERY_STRING'] 将填充传递入的查询字符串。 且此查询字符串只在使用 Apache 2 时被填充。 此请求文件将不会显示在 Apache 访问日志中。

注意:

在被请求文件中设置的环境变量在原请求文件中不可见。

注意:

此函数可以用于 PHP 文件。然而一般来说对 PHP 文件最好是使用 include 或者 require。

参见

来源:PHP Documentation Group · 作者与贡献记录 · CC BY 3.0。离线整理了版式、链接和媒体显示。

资料来源与适用范围

资料来源
PHP Documentation Group
适用范围
请按文中版本与环境说明核对
内容语言
中文;命令、路径和错误标识保留技术原文
本地收录日期
2026-11-15
授权说明
CC BY 3.0

正文与所需资源由本站本地存储。查看来源及更新记录 ↗

请按适用版本和实际日志确认原因;本站没有对每一种系统或设备逐项执行文中的操作。