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

<refentry xml:id="function.virtual" xmlns="http://docbook.org/ns/docbook">

<refnamediv>

<refname>virtual</refname>

<refpurpose>Efectúa una subpetición 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> es una función específica del

servidor Apache. Es similar a la directiva

"<literal>&lt;!--#include virtual...--&gt;</literal>" cuando se

utiliza el módulo <literal>mod_include</literal> de Apache.

Esta función efectúa una subpetición Apache.

Es muy útil cuando se desea analizar scripts CGI, archivos

<filename>.shtml</filename> o cualquier otro tipo de archivo a través del servidor Apache. Se debe tener en cuenta que al utilizarse con scripts CGI, estos deben generar un encabezado válido, es decir, al menos un encabezado <literal>Content-Type</literal>.

</para>

<para>

Para ejecutar una subpetición, todos los búferes son detenidos y vaciados hacia el navegador, los encabezados restantes también lo son.

</para>

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

<term><parameter>uri</parameter></term>

<listitem>

<para>

El archivo sobre el cual se ejecutará el comando virtual.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Ejecuta un comando virtual en caso de éxito o devuelve &false; en caso de error.

</para>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

Ver la función <function>apache_note</function> para un ejemplo.

</para>

</refsect1>

<refsect1 role="notes">

&reftitle.notes;

<warning>

<para>

La cadena requerida puede ser pasada al archivo incluido, pero <varname>$_GET</varname> es copiado desde el script padre y solo la variable <varname>$_SERVER['QUERY_STRING']</varname> es transmitida al pasar la cadena requerida. La cadena requerida pasada funciona únicamente bajo Apache 2. Los archivos solicitados no son listados en los logs de acceso de Apache.

</para>

</warning>

<note>

<para>

Las variables de entorno establecidas en el archivo solicitado no son visibles en el archivo llamador.

</para>

</note>

<note>

<para>

Esta función puede ser utilizada sobre archivos PHP. Sin embargo, se recomienda utilizar <function>include</function> o <function>require</function> para archivos PHP.

</para>

</note>

</refsect1>

<refsect1 role="seealso">

&reftitle.seealso;

<para>

<simplelist>

<member><function>apache_note</function></member>

</simplelist>

</para>

</refsect1>

</refentry>