# virtual

(PHP 4, PHP 5, PHP 7, PHP 8)

virtual — Effectue une sous-requête Apache

### Description

virtual(string `$uri`): bool

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

`uri`

  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.

### 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:

> Cette fonction peut être utilisée sur les fichiers PHP. Cependant, il est conseillé d'utiliser include ou require pour les fichiers PHP.

### Voir aussi

- apache_note() - Affiche ou affecte la table des notes d'Apache