getallheaders
IIS
Apache Funktionen
PHP Manual

# virtual

(PHP 4, PHP 5)

virtual — Führt eine Apache-Unteranfrage durch

### Beschreibung

bool virtual ( string `$filename` )

virtual() ist eine apachespezifische Funktion ähnlich wie <!--#include virtual...--> in mod_include. Sie führt eine Apache-Unteranfrage aus. Dies ist hilfreich, wenn man CGI-Skripte oder .shtml-Dateien oder irgendetwas anderes einbinden will, das Sie vom Apache parsen lassen möchten. Beachten Sie bei CGI-Skripten, dass diese valide CGI-Header erzeugen. Dies bedeutet, dass zumindest der Content-Type-Header generiert werden muss.

Um die Unteranfrage auszuführen, werden alle Buffer beendet und der Inhalt an den Browser ausgegeben. Anstehende Header werden ebenfalls abgeschickt.

Diese Funktion wird nur unterstützt, wenn PHP als Apache-Modul installiert wurde.

### Parameter-Liste

`filename`

  Die Datei, die das virtuelle Kommando ausführen soll.

### Rückgabewerte

Führt bei Erfolg ein virtuelles Kommando aus, im Fehlerfall wird `FALSE` zurückgegeben.

### Changelog

Version | Beschreibung
--- | ---
4.0.6 | Diese Funktion kann auf PHP-Dateien angewendet werden. Es ist allerdings deutlich sinnvoller, in diesem Fall die Funktionen include() oder require() zu verwenden.

### Beispiele

Ein passendes Beispiel finden Sie unter apache_note().

### Anmerkungen

Warnung

Der Querystring kann an das eingebundene File übergeben werden, aber $_GET wird vom Elternskript kopiert und nur $_SERVER['QUERY_STRING'] wird mit dem übergebenen Querystring befüllt. Der Querystring kann nur übergeben werden, wenn Apache 2 verwendet wird. Die angeforderte Datei wird nicht im Zugriffslog des Apache aufgeführt.

> Hinweis: Umgebungsvariablen, die in der aufgerufenen Datei gesetzt werden, sind nicht für das aufrufende Skript sichtbar.

> Hinweis: Ab PHP 4.3.3 können Sie diese Funktion auch mit dem NSAPI-Server-Modul für Netscape/iPlanet/SunONE-Webserver nutzen.

### Siehe auch

- apache_note() - Setzt und liest Apache Request Notes

getallheaders
IIS
Apache Funktionen
PHP Manual