php-doc-en/reference/nsapi/functions/nsapi-virtual.xml
Dave Barr 91e836093c - Standardize the Unix acronym. Unix is the preferred capitalization
as UNIX is a registered trademark by the Open Group. References to UNIX
  were left in where it made sense, like example outputs, and so forth.
  You can read the Trademark User Guide for "UNIX" at:
  http://www.unix.org/tmug2.ps or http://www.unix.org/tmug2.pdf


git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@147067 c90b9560-bf6c-de11-be94-00142212c4b1
2003-12-21 04:22:00 +00:00

62 lines
2.1 KiB
XML

<?xml version="1.0" encoding="iso-8859-1"?>
<!-- $Revision: 1.6 $ -->
<refentry id="function.nsapi-virtual">
<refnamediv>
<refname>nsapi_virtual</refname>
<refpurpose>Perform an NSAPI sub-request</refpurpose>
</refnamediv>
<refsect1>
<title>Description</title>
<methodsynopsis>
<type>int</type><methodname>nsapi_virtual</methodname>
<methodparam><type>string</type><parameter>uri</parameter></methodparam>
</methodsynopsis>
<para>
<function>nsapi_virtual</function> is an NSAPI-specific function which
is equivalent to &lt;!--#include virtual...--&gt; in SSI
(<filename>.shtml</filename> 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.
</para>
<para>
To run the sub-request, all buffers are terminated and flushed to the
browser, pending headers are sent too.
</para>
<para>
You cannot make recursive requests with this function to other PHP scripts.
If you want to include PHP scripts, use <function>include</function> or
<function>require</function>.
</para>
<note>
<para>
This function depends on a undocumented feature of the Netscape/iPlanet/SunONE
webservers. Use <function>phpinfo</function> to determine if it is available.
In the Unix environment it should always work, in windows it depends on the name of
a <filename>ns-httpdXX.dll</filename> file.
Read the note about <link linkend='install.netscape.notes'>subrequests in the
install section</link> if you experience this problem.
</para>
</note>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:1
sgml-indent-data:t
indent-tabs-mode:nil
sgml-parent-document:nil
sgml-default-dtd-file:"../../../../manual.ced"
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
vim600: syn=xml fen fdm=syntax fdl=2 si
vim: et tw=78 syn=sgml
vi: ts=1 sw=1
-->