array ( 0 => 'index.php', 1 => 'PHP Manual', ), 'head' => array ( 0 => 'UTF-8', 1 => 'fr', ), 'this' => array ( 0 => 'function.virtual.php', 1 => 'virtual', 2 => 'Effectue une sous-requête Apache', ), 'up' => array ( 0 => 'ref.apache.php', 1 => 'Fonctions Apache', ), 'prev' => array ( 0 => 'function.getallheaders.php', 1 => 'getallheaders', ), 'next' => array ( 0 => 'book.fpm.php', 1 => 'Gestionnaire de processus FastCGI', ), 'alternatives' => array ( ), 'source' => array ( 'lang' => 'fr', 'path' => 'reference/apache/functions/virtual.xml', ), 'history' => array ( ), ); $setup["toc"] = $TOC; $setup["toc_deprecated"] = $TOC_DEPRECATED; $setup["parents"] = $PARENTS; manual_setup($setup); contributors($setup); ?>

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 à "<!--#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