Funciones Apache
PHP Manual

virtual

(PHP 4, PHP 5)

virtualRealiza una sub-petición de Apache

Descripción

bool virtual ( string $filename )

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.

Esta función está soportada sólo cuando PHP está instalado como un módulo de Apache.

Parámetros

filename

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

Valores devueltos

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

Historial de cambios

Versión Descripció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.

Ejemplos

Vea apache_note() para un ejemplo.

Notas

Warning

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.

Note:

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

Note:

A partir de PHP 4.3.3 esta función también puede ser NSAPI server module in Netscape/iPlanet/SunONE utilizada con el servidor web.

Ver también


Funciones Apache
PHP Manual