virtual Perform an Apache sub-request


virtual

(PHP 4, PHP 5)

virtualPerform an Apache sub-request

说明

bool virtual ( string $filename )

virtual() is an Apache-specific function which is similar 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.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.

Note:

Environment variables set in the requested file are not visible to the calling script.

参见


«  vfprintf
» vprintf
快速导航

Copyright © 2016 phpStudy | 豫ICP备2021030365号-3