NSAPI_VIRTUAL(3) 1 NSAPI_VIRTUAL(3)
nsapi_virtual - Perform an NSAPI sub-request
SYNOPSIS
bool nsapi_virtual (string $uri)
DESCRIPTION
nsapi_virtual(3) is an NSAPI-specific function which is equivalent to <!--#include virtual...--> in SSI ( .shtml files). It does an NSAPI
sub-request. It is useful for including CGI scripts or .shtml files, or anything else that you'd parse through webserver.
To run the sub-request, all buffers are terminated and flushed to the browser, pending headers are sent too.
You cannot make recursive requests with this function to other PHP scripts. If you want to include PHP scripts, use include(3) or
require(3).
Note
This function depends on a undocumented feature of the Netscape/iPlanet/Sun webservers. Use phpinfo(3) to determine if it is avail-
able. In the Unix environment it should always work, in Windows it depends on the name of a ns-httpdXX.dll file.
Read the note about subrequests in the NSAPI section (UNIX, Windows) if you experience this problem.
PARAMETERS
o $uri
- The URI of the script.
RETURN VALUES
Returns TRUE on success or FALSE on failure.
PHP Documentation Group NSAPI_VIRTUAL(3)
