getallheaders
IIS
Fonctions Apache
PHP Manual

# virtual

(PHP 4, PHP 5)

virtual — Effectue une sous-requête Apache

### Description

bool virtual ( string `$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.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.

### Exemples

Voir la fonction apache_note() pour un exemple.

### Notes

Avertissement

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.

### Voir aussi

- apache_note() - Affiche ou affecte le paramètre "apache request notes"

getallheaders
IIS
Fonctions Apache
PHP Manual