Effectue une sous-requête Apache

# virtual

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

virtual — Effectue une sous-requête Apache

### Description

function virtual(string `$uri`): bool

virtual() est une fonction spécifique au serveur Apache. Elle est similaire à "`<!--#include virtual...-->`" dans `mod_include`. Cette fonction effectue une sous-requête Apache. C'est utile pour inclure 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.

Cette fonction est supportée lorsque PHP est installé comme module d'Apache.

### 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 de requête peut être passée au fichier inclus, mais $_GET est copié depuis le script parent et seule la variable $_SERVER['QUERY_STRING'] est remplie avec la chaîne de requête passée. La chaîne de requête ne peut être passée qu'avec 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() - Lit et affecte les notes de requête Apache

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open