virtual

(PHP 4, PHP 5)

virtual — Perform an Apache sub-request

说明

bool virtual ( string $filename )

virtual() is an Apache-specific function which is similar to  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.3.3	Note: 从 PHP 4.3.3 起，也可在 Netscape/iPlanet/SunONE Web 服务器的 NSAPI 服务器模块使用此函数。
4.0.6	This function may be used on PHP files. However, it is typically better to use include() or require() for PHP files.

范例

See apache_note() for an example.

注释

Warning

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.