VIRTUAL(3)								 1								VIRTUAL(3)

virtual - Perform an Apache sub-request

SYNOPSIS

       bool virtual (string  $filename)

DESCRIPTION

       virtual(3) 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.

       This function is supported when PHP is installed as an Apache module or by the NSAPI server module in Netscape/iPlanet/SunONE webservers.

PARAMETERS

	      o $filename
		- The file that the virtual command will be performed on.

RETURN VALUES

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

EXAMPLES

	See apache_note(3) for an example.

NOTES

       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.

       Note

	       This function may be used on PHP files. However, it is typically better to use include(3) or require(3) for PHP files.

SEE ALSO

       apache_note(3).

PHP Documentation Group 														VIRTUAL(3)