# virtual

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

virtual — 执行 Apache 子请求

### 说明

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。

### 参见

- apache_note() - 取得或设置 apache 请求记录

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open