virtual

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

virtualEfectúa una subpetición Apache

Descripción

virtual(string $uri): bool

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.

Parámetros

uri

El archivo sobre el cual se ejecutará el comando virtual.

Valores devueltos

Ejecuta un comando virtual en caso de éxito o devuelve false en caso de error.

Ejemplos

Ver la función apache_note() para un ejemplo.

Notas

Advertencia

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.

Ver también