virtual
(PHP 4, PHP 5)
virtual — Führt eine Apache-Unteranfrage durch
Beschreibung
virtual() ist eine Apache-spezifische Funktion, die <!--#include virtual... --> aus mod_include entspricht. Diese Funktion führt eine Unteranfrage durch. Das ist nützlich für das Einbinden von CGI-Skripten, .shtml-Dateien oder allen anderen Inhalten, die von Apache verarbeitet werden sollen. Beachten Sie bitte, dass ein CGI-Skript gültige CGI-Header generieren muss, mindestens einen Content-type-Header.
Um die Unteranfrage auszuführen, werden alle Buffer beendet und der Inhalt im Browser ausgegeben. Anstehende Header werden ebenfalls abgeschickt.
Diese Funktion wird nur funktionieren, wenn Sie PHP als Apache Modul übersetzt haben, weil die Apache API benutzt wird um Unterabfragen durchzuführen. Ein Querystring kann an die eingebundene Datei weiter gereicht werden, aber $_GET wird vom Vaterskript kopiert und nur $_SERVER['QUERY_STRING'] enthält den weiter greichten Querystring. Der Querystring kann nur unter Apache 2 weiter gereicht werden. Die angeforderte Datei wird nicht in die Apache access Logdatei geschrieben.
Seit PHP 4.0.6 können Sie virtual() für PHP Dateien benutzen. Trotzdem ist es typischerweise besser, include() oder require() zu benutzen um PHP Dateien einzubinden.
Hinweis: Ab PHP 4.3.3 können Sie diese Funktion auch mit dem NSAPI Server Modul für Netscape/iPlanet/SunONE Webserver nutzen.