virtual
(PHP 4, PHP 5)
virtual — Végrehajt egy Apache allekérést
Leírás
A virtual() egy Apache-specifikus függvény, amely megegyezik a mod_include <!--#include virtual...--> megoldásával. Végrehajt egy Apache alkérést. Ez hasznos CGI szkriptek vagy .shtml fájlok beillesztésénél, vagy bármi másnál, amit egyébként az Apache dolgozott volna fel. Fontos a CGI szkripteknél, hogy a szkript érvényes CGI fejléceket generáljon. Ezt azt jelenti, hogy minimálisan egy Content-type fejlécet kell ki kell adnia.
Az alkérés futtatásához minden puffert le kell zárni és kiűríteni a tartalmát a kliens böngésző felé, és ezzel együtt minden függőben lévő fejléc is kiküldésre kerül.
Ez a függvény csak abban az esetben fog működni, ha Apache modulként működik a PHP-d, mivel annak API-ját használja az al-lekérések kivitelezéséhez. Teljes, adatokkal telitűzdelt GET hivatkozást adhatsz itt meg, de ezt csak a futtatandó script $_SERVER['QUERY_STRING'] változója fogja tükrözni. A hívó $_GET tömbjét fogja átvenni a meghívott PHP program. A QUERY_STRING átadása csak az Apache 2 használata esetén történik meg. A meghívott fájl az acces_log-ban nem fog nyomot hagyni.
A PHP 4.0.6-os változatától felfele használható a virtual() PHP fájlokra is. Persze ettől függetlenül okosabb az include() vagy require() függvényeket használni erre a célra.