virtual
(PHP 4, PHP 5)
virtual — Effectue une sous-requête Apache
Description
$filename
)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.
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.3.3 |
Depuis PHP 4.3.3, vous pouvez utiliser cette fonction avec le module NSAPI des serveurs Netscape/iPlanet/SunONE. |
| 4.0.6 | Cette fonction peut être utilisée sur des fichiers PHP. Toutefois, il est conseillé d'utiliser les fonctions include ou require pour les fichiers PHP. |
Exemples
Voir la fonction apache_note() pour un exemple.
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.
