(PHP 4, PHP 5)
virtual — Efectuează o sub-interpelare Apache
$filename
)virtual() este o funcție specifică Apache, care este similară cu <!--#include virtual...--> în mod_include. Ea efectuează o sub-interpelare Apache. Ea este utilă pentru includerea script-urilor CGI, sau a fișierelor .shtml, sau orice altceva ce se interpretează de către Apache. Atrageți atenția că în cazul unui script CGI, acesta trebuie să genereze antete CGI valide. Aceasta înseamnă că el trebuie să genereze cel puțin un antet Content-type.
Pentru a rula sub-interpelarea toate zonele-tampon sunt închise și trimise către navigator, antetele rămase sunt de asemenea trimise.
Această funcție e susținută numai dacă PHP este instalat ca modul Apache.
filenameFișierul asupra căruia se va efectua comanda virtuală.
Efectuează comanda virtuală în cazul de succes, sau întoarce FALSE în caz
de eșec.
| Versiunea | Descriere |
|---|---|
| 4.3.3 |
Începând cu PHP 4.3.3 puteți utiliza această funcție cu modulul de server NSAPI și în webserver-ele Netscape/iPlanet/SunONE. |
| 4.0.6 | Această funcție poate fi utilizată asupra fișierelor PHP. Însă în mod normal e mai bine de a utiliza include sau require pentru fișiere PHP. |
Accesați apache_note() pentru un exemplu.
String-ul cu interpelarea poate fi transmis fișierului inclus, însă $_GET este copiat din script-ul părinte și numai $_SERVER['QUERY_STRING'] este completată cu string-ul cu interpelarea. String-ul cu interpelarea poate fi transmis când se utilizează Apache 2. Fișierul interpelat nu va fi afișat în jurnalul de acces al Apache.
Notă:
Variabilele de mediu stabilite în fișierul interpelat nu sunt vizibile script-ului apelant.