   #PHP Manual Apache-specific Functions getallheaders Array Functions

   PHP Manual
   Prev  Next
   ______________________________________________________________________

                                    virtual

   (PHP 3, PHP 4 )
   virtual -- Perform an Apache sub-request

Description

   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.

   As of PHP 4.0.6, you can use virtual() on PHP files. However, it is
   typically better to use include() or require() if you need to include
   another PHP file.

     Note: From PHP 4.3.3 on you can use this function with the NSAPI
     server module in Netscape/iPlanet/SunONE webservers, too.
   ______________________________________________________________________

   Prev          Home            Next
   getallheaders  Up  Array Functions
