<?xml version="1.0" encoding="utf-8"?>

<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>&lt;!--#include virtual...--&gt;</literal>,

используемой в <literal>mod_include</literal>.

Данная функция выполняет подзапрос Apache. Это бывает полезным

в тех случаях, когда необходимо включить в свой скрипт результат

выполнения других CGI-скриптов или файлов <filename>.shtml</filename>, а также

добавления всего, что должно быть обработано Apache.

Обратите внимание, что CGI-скрипты должны отдавать корректные 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>

Имя файла, для которого будет выполнен подзапрос.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Результат выполнения подзапроса в случае успешного выполнения или &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.

Запрошенный файл не будет отражён в журнале доступа (access log) Apache.

</para>

</warning>

<note>

<para>

Переменные окружения, установленные в запрошенном файле, не видимы из

вызвавшего его скрипта.

</para>

</note>

<note>

<para>

Эта функция может быть использована в 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>