(PHP 4, PHP 5, PHP 7, PHP 8)
virtual — Esegue una sotto-richiesta Apache
virtual() è una funzione specifica Apache che
è simile a <!--#include virtual...-->
in
mod_include
.
Esegue una sotto-richiesta Apache. È utile ad includere
script CGI o file .shtml, o qualsiasi altra cosa si voglia
far caricare ad Apache. Si noti che per uno script CGI, questo
deve generare degli header CGI validi. Come minimo ciò significa che
deve generare un header Content-Type
.
Al fine di eseguire la sotto-richiesta, tutti i buffer vengono chiusi e svuotati verso il browser, e anche gli header in attesa vengono inviati.
This function is only supported when PHP is installed as an Apache module.
uri
Il file su cui verrà eseguito il comando virtuale.
Esegue il comando virtuale in caso di successo, o restituisce false
in caso di fallimento.
Vedere apache_note() per un esempio.
La query string può essere passata al file incluso ma $_GET viene copiato dallo script padre e solo $_SERVER['QUERY_STRING'] viene riempito con la query string passata. La query string può essere passata solo quando si utilizza Apache 2. Il file richiesto non verrà elencato nel registro di accesso di Apache.
Nota:
Le variabili d'ambiente impostate nel file richiesto non sono visibili allo script chiamante.
Nota:
Questa funzione può essere utilizzata sui file PHP. Comunque, in genere è preferibile usare include o require per i file PHP.