PHP Manual
后退 |  | 前进

# virtual

(PHP 3, PHP 4, PHP 5)

virtual -- Perform an Apache sub-request

## 说明

int virtual ( string filename )

virtual() is an Apache-specific function which is equivalent to <!--#include virtual...--> in mod_include. It performs an Apache sub-request. It is useful for including CGI scripts or .shtml files, or anything else that you would parse through Apache. Note that for a CGI script, the script must generate valid CGI headers. At the minimum that means it must generate a Content-type header.

To run the sub-request, all buffers are terminated and flushed to the browser, pending headers are sent too.

此函数仅在 PHP 作为 Apache 模块安装时才可使用。

## 参数

filename

  The file that the virtual command will be performed on.

## 返回值

Performs the virtual command on success, or returns `FALSE` on failure.

## 更新日志

版本 | 说明
--- | ---
4.0.6 | This function may be used on PHP files. However, it is typically better to use include() or require() for PHP files.

## 注释

警告
The query string can be passed to the included file but $_GET is copied from the parent script and only $_SERVER['QUERY_STRING'] is filled with the passed query string. The query string may only be passed when using Apache 2. The requested file will not be listed in the Apache access log.

> 注: 自 PHP 4.3.3 起也可以在 Netscape/iPlanet/SunONE 服务器的 NSAPI server module 中使用本函数。

后退 | 起点 | 前进
getallheaders | 上一级 | Advanced PHP debugger