Manuel PHP
Précédent |  | Suivant

# virtual

(PHP 3, 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 `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

Avertissement
La chaîne requise peut être passée au fichier inclus mais `$_GET` est copié depuis le script parent et uniquement `$_SERVER['QUERY_STRING']` est transmis 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.

Précédent | Sommaire | Suivant
getallheaders | Niveau supérieur | Alternative PHP Cache