virtual
Effectue une sous-requête Apache
&reftitle.description;
boolvirtual
stringuri
virtual est une fonction spécifique au
serveur Apache. Elle est similaire à
"<!--#include virtual...-->" dans
mod_include.
Cette fonction effectue une sous-requête Apache. C'est utile pour inclure
des scripts CGI, des
fichiers .shtml 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 Content-Type.
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.
&apache.req.module;
&reftitle.parameters;
uri
Le fichier sur lequel la commande virtuelle sera effectuée.
&reftitle.returnvalues;
Exécute une commande virtuelle en cas de succès ou retourne &false; en cas
d'échec.
&reftitle.examples;
Voir la fonction apache_note pour un exemple.
&reftitle.notes;
La chaîne de requête peut être passée au fichier inclus,
mais $_GET est copié depuis le script parent et
seule la variable $_SERVER['QUERY_STRING']
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.
Les variables d'environnement fixées dans le fichier demandé ne sont pas
visibles dans le fichier appelant.
Cette fonction peut être utilisée sur les fichiers PHP. Cependant,
il est conseillé d'utiliser include ou
require pour les fichiers PHP.
&reftitle.seealso;
apache_note