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

<!-- $Revision$ -->

<!-- EN-Revision: a331ac8a86bb5929b79be9a369fac1e3af516241 Maintainer: yannick Status: ready -->

<!-- Reviewed: yes -->

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

<refnamediv>

<refname>virtual</refname>

<refpurpose>Effectue une sous-requête 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> est une fonction spécifique au

serveur Apache. Elle est similaire à

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

<literal>mod_include</literal>.

Cette fonction effectue une sous-requête Apache. C'est utile pour inclure

des scripts CGI, des

fichiers <filename>.shtml</filename> ou n'importe quel autre type de

fichier à travers le serveur Apache. Il est à noter que lors

de l'utilisation avec des scripts CGI, ces derniers doivent

générer un en-tête valide, c'est-à-dire,

au minimum un en-tête <literal>Content-Type</literal>.

</para>

<para>

Pour exécuter une sous-requête, tous les tampons sont arrêtés et vidés vers le

navigateur, les en-têtes restants le sont aussi.

</para>

&apache.req.module;

</refsect1>

<refsect1 role="parameters">

&reftitle.parameters;

<para>

<variablelist>

<varlistentry>

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

<listitem>

<para>

Le fichier sur lequel la commande virtuelle sera effectuée.

</para>

</listitem>

</varlistentry>

</variablelist>

</para>

</refsect1>

<refsect1 role="returnvalues">

&reftitle.returnvalues;

<para>

Exécute une commande virtuelle en cas de succès ou retourne &false; en cas

d'échec.

</para>

</refsect1>

<refsect1 role="examples">

&reftitle.examples;

<para>

Voir la fonction <function>apache_note</function> pour un exemple.

</para>

</refsect1>

<refsect1 role="notes">

&reftitle.notes;

<warning>

<para>

La chaîne de requête peut être passée au fichier inclus,

mais <varname>$_GET</varname> est copié depuis le script parent et

seule la variable <varname>$_SERVER['QUERY_STRING']</varname>

est remplie avec la chaîne de requête passée. La chaîne de requête

ne peut être passée qu'avec Apache 2. Les fichiers demandés ne sont pas listés dans

les logs d'accès Apache.

</para>

</warning>

<note>

<para>

Les variables d'environnement fixées dans le fichier demandé ne sont pas

visibles dans le fichier appelant.

</para>

</note>

<note>

<para>

Cette fonction peut être utilisée sur les fichiers PHP. Cependant,

il est conseillé d'utiliser <function>include</function> ou

<function>require</function> pour les fichiers PHP.

</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

-->