virtual
(PHP 4, PHP 5)
virtual — Effectue une sous-requête Apache
Description
virtual() est une fonction spécifique au serveur Apache. Elle est similaire à la directive "<!--#include virtual...-->" lorsque vous utilisez le 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 au navigateur, les en-têtes restants le sont aussi.
Liste de paramètres
- filename
-
Le fichier sur lequel la commande virtuelle sera effectuée.
Valeurs de retour
Exécute une commande virtuelle en cas de succès ou retourne FALSE en cas d'échec.
Historique
| 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. |
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.
Note: Les variables d'environnement fixées dans le fichier demandé ne sont pas visibles dans le fichier appelant.
Note: Depuis PHP 4.3.3, vous pouvez utiliser cette fonction avec le module NSAPI des serveurs Netscape/iPlanet/SunONE.