virtual

(PHP 4, PHP 5, PHP 7, PHP 8)

virtualEsegue una sotto-richiesta Apache

Descrizione

virtual(string $uri): bool

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.

Elenco dei parametri

uri

Il file su cui verrà eseguito il comando virtuale.

Valori restituiti

Esegue il comando virtuale in caso di successo, o restituisce false in caso di fallimento.

Esempi

Vedere apache_note() per un esempio.

Note

Avviso

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.

Vedere anche:

  • apache_note() - Ricava o imposta una variabile nella tabella notes di Apache