(PHP 4, PHP 5, PHP 7, PHP 8)
virtual — Efectúa una subpetición Apache
virtual() es una función específica del
servidor Apache. Es similar a la directiva
"<!--#include virtual...-->
" cuando se
utiliza el módulo mod_include
de Apache.
Esta función efectúa una subpetición Apache.
Es muy útil cuando se desea analizar scripts CGI, archivos
.shtml o cualquier otro tipo de archivo a través del servidor Apache. Se debe tener en cuenta que al utilizarse con scripts CGI, estos deben generar un encabezado válido, es decir, al menos un encabezado Content-Type
.
Para ejecutar una subpetición, todos los búferes son detenidos y vaciados hacia el navegador, los encabezados restantes también lo son.
uri
El archivo sobre el cual se ejecutará el comando virtual.
Ejecuta un comando virtual en caso de éxito o devuelve false
en caso de error.
Ver la función apache_note() para un ejemplo.
La cadena requerida puede ser pasada al archivo incluido, pero $_GET es copiado desde el script padre y solo la variable $_SERVER['QUERY_STRING'] es transmitida al pasar la cadena requerida. La cadena requerida pasada funciona únicamente bajo Apache 2. Los archivos solicitados no son listados en los logs de acceso de Apache.
Nota:
Las variables de entorno establecidas en el archivo solicitado no son visibles en el archivo llamador.
Nota:
Esta función puede ser utilizada sobre archivos PHP. Sin embargo, se recomienda utilizar include o require para archivos PHP.