virtual

virtual

(PHP 3, PHP 4, PHP 5)

virtual -- Realizar una sub-petici贸n de Apache

Descripci贸n

bool virtual ( string nombre_archivo )

virtual() es una funci贸n espec铆fica de Apache que es similar a <!--#include virtual...--> en mod_include. Realiza una sub-petici贸n de Apache. Es 煤til para incluir scripts CGI o archivos .shtml, o cualquier otra cosa que quisiera procesar a trav茅s de Apache. Note que para un script CGI, el script debe generar cabeceras CGI v谩lidas. Esto quiere decir que, por lo menos, debe generar una cabecera Content-type.

Para ejecutar la sub-petici贸n, todos los b煤feres son terminados y volcados al navegador, y las cabeceras pendientes son enviadas tambi茅n.

This function is only supported when PHP is installed as an Apache module.

Lista de par谩metros

nombre_archivo

El archivo sobre el que se efectuar谩 el comando virtual.

Valores retornados

Ejecuta el comando virtual en caso de 茅xito, o devuelvo FALSE si ocurre un error.

Registro de cambios

Versi贸nDescripci贸n
4.0.6 Esta funci贸n puede ser usada sobre archivos PHP. Sin embargo, usualmente es mejor usar include() o require() para archivos PHP.

Notes

Aviso

La cadena de petici贸n puede ser pasada al archivo incluido pero la variable $_GET es copiada desde el script padre, y solo $_SERVER['QUERY_STRING'] se llena con la cadena de query pasada. Puede que la cadena query s贸lo pueda ser pasada cuando se usa Apache 2. El archivo solicitado no ser谩 listado en el archivo de registro (log) access de Apache.

Nota: Las variables de entorno definidas en el archivo solicitado no est谩n disponibles desde el script que hace el llamado.

Nota: A partir de PHP 4.3.3 se puede usar tambien esta funcion con el modulo de servidor NSAPI de los servidores web, Netscape/iPlanet/SunONE.