Efectúa una subpetición Apache

# virtual

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

virtual — Efectúa una subpetición Apache

### Descripción

function 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

- apache_note() - Muestra o asigna la tabla de notas de Apache

`↑` and `↓` to navigate • `Enter` to select • `Esc` to close • `/` to open