virtual.xml

<?xml version="1.0" encoding="utf-8"?>
<!-- $Revision$ -->
<!-- EN-Revision: a331ac8a86bb5929b79be9a369fac1e3af516241 Maintainer: hytest Status: ready -->
<!-- Reviewed: no -->

<!-- splitted from ./en/functions/apache.xml, last change in rev 1.20 -->
<refentry xml:id="function.virtual" xmlns="http://docbook.org/ns/docbook">
 <refnamediv>
  <refname>virtual</refname>
  <refpurpose>执行 Apache 子请求</refpurpose>
 </refnamediv>

 <refsect1 role="description">
  &reftitle.description;
  <methodsynopsis>
   <type>bool</type><methodname>virtual</methodname>
   <methodparam><type>string</type><parameter>uri</parameter></methodparam>
  </methodsynopsis>
  <para>
   <function>virtual</function> 是一个 Apache 特有函数，
   类似于
   <literal>mod_include</literal> 中的 <literal>&lt;!--#include virtual...--&gt;</literal>。
   它执行一个 Apache 子请求。可用于包含一个
   CGI 脚本或 <filename>.shtml</filename> 文件，或任何其它可通过
   Apache 解析的请求。注意对一个 CGI 脚本，该脚本
   生成合法的 CGI 头，至少必须
   生成<literal>Content-Type</literal> 头。
  </para>
  <para>
   为运行子请求，所有缓冲将中止并刷新至浏览器，包括头信息。
  </para>
  &apache.req.module;
 </refsect1>

 <refsect1 role="parameters">
  &reftitle.parameters;
  <para>
   <variablelist>
    <varlistentry>
     <term><parameter>uri</parameter></term>
     <listitem>
      <para>
       virtual命令将执行的文件
      </para>
     </listitem>
    </varlistentry>
   </variablelist>
  </para>
 </refsect1>

 <refsect1 role="returnvalues">
  &reftitle.returnvalues;
  <para>
   成功执行 virtual 命令，或失败时返回 &false; 。
  </para>
 </refsect1>

 <refsect1 role="examples">
  &reftitle.examples;
  <para>
   示例请看 <function>apache_note</function> 。
  </para>
 </refsect1>

 <refsect1 role="notes">
  &reftitle.notes;
  <warning>
   <para>
    查询字符串可被传递至被包含文件，但是
    <varname>$_GET</varname> 是拷贝于父文件，仅有
    <varname>$_SERVER['QUERY_STRING']</varname> 将填充传递入的查询字符串。
    且此查询字符串只在使用 Apache 2 时被填充。
    此请求文件将不会显示在 Apache 访问日志中。
   </para>
  </warning>
  <note>
   <para>
    在被请求文件中设置的环境变量在原请求文件中不可见。
   </para>
  </note>
  <note>
   <para>
    此函数可以用于 PHP 文件。然而一般来说对 PHP 文件最好是使用 
    <function>include</function> 或者 <function>require</function>。
   </para>
  </note>
 </refsect1>

 <refsect1 role="seealso">
  &reftitle.seealso;
  <para>
   <simplelist>
    <member><function>apache_note</function></member>
   </simplelist>
  </para>
 </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:"~/.phpdoc/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
-->