virtual
Effectue une sous-requête Apache
&reftitle.description;
boolvirtual
stringfilename
virtual est une fonction spécifique au
serveur Apache. Elle est similaire à la directive
"<!--#include virtual...-->" lorsque vous
utilisez le module mod_include d'Apache.
Cette fonction effectue une sous-requête Apache.
C'est très utile lorsque vous voulez analyser 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.
&reftitle.parameters;
filename
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.changelog;
&Version;
&Description;
4.0.6
Cette fonction peut être utilisée sur des fichiers PHP. Toutefois,
il est conseillé d'utiliser les fonctions include
et require pour les fichiers PHP.
&reftitle.examples;
Voir la fonction apache_note pour un exemple.
&reftitle.notes;
La chaîne requise peut être passée au fichier inclus,
mais $_GET est copié depuis le script parent et
seule la variable $_SERVER['QUERY_STRING']
est transmise en passant la chaîne requise. La chaîne requise passée fonctionne
uniquement sous 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.
¬e.apache.nsapi-module;
&reftitle.seealso;
apache_note