Versión 2.0 del Servidor HTTP Apache

Apache > Servidor HTTP > Documentación > Versión 2.0

# Variables de entorno de Apache

Idiomas disponibles: en | es | fr | ja | ko

Esta traducción podría estar obsoleta. Consulte la versión en inglés de la documentación para comprobar si se han producido cambios recientemente.

El servidor HTTP Apache HTTP ofrece un mecanismo para almacenar información en variables especiales que se llaman variables de entorno. Esta información puede ser usada para controlar diversas operaciones como por ejemplo, almacenar datos en ficheros de registro (log files) o controlar el acceso al servidor. Las variables de entorno se usan también como un mecanismo de comunicación con programas externos como por ejemplo, scripts CGI. Este documento explica las diferentes maneras de usar y manipular esas variables.

Aunque estas variables se llaman variables de entorno, no son iguales que las variables de entorno que controla el sistema operativo de la máquina en que se está ejecutando Apache. Las variables de entorno de Apache se almacenan y manipulan la en estructura interna de Apache. Solamente se convierten en auténticas variables de entorno del sistema operativo cuando se pasan a scripts CGI o a scripts Server Side Include. Si quiere manipular el entorno del sistema operativo sobre el que Apache se está ejecutando, debe usar los mecanismos estándar de manipulación que tenga su sistema operativo.

## Especificación de variables de entorno

Módulos Relacionados | Directivas Relacionadas
--- | ---

- `mod_env`
- `mod_rewrite`
- `mod_setenvif`
- `mod_unique_id`

- `BrowserMatch`
- `BrowserMatchNoCase`
- `PassEnv`
- `RewriteRule`
- `SetEnv`
- `SetEnvIf`
- `SetEnvIfNoCase`
- `UnsetEnv`

### Manipulación básica del entorno

El modo más básico de especificar el valor de una variable de entorno en Apache es usando la directiva incondicional `SetEnv`. Las variables pueden también pasarse desde el shell en el que se inicio Apache usando la directiva `PassEnv`.

### Especificación condicional por petición

Si necesita más flexibilidad, las directivas incluidas con mod_setenvif permiten especificar valores para las variables de entorno de manera condicional en función de las caracteristicas particulares de la petición que se esté procesando. Por ejemplo, se puede especificar un valor para una variable solamente cuando la petición se haga con un navegador específico, o solamente cuando la petición contenga una determinada información en su cabecera. Si necesita aún más flexibilidad, puede conseguirla con la directiva `RewriteRule` del módulo mod_rewrite que tiene la opción `[E=...]` para especificar valores en las variables de entorno.

### Identificadores únicos

Finalmente, mod_unique_id determina el valor de la variable de entorno `UNIQUE_ID` para cada petición. Este valor está garantizado que sea único entre todas las peticiones bajo condiciones muy específicas.

### Variables CGI estándar

Además de todas las variables de entorno especificadas en la configuración de Apache y las que se pasan desde el shell, los scripts CGI y las páginas SSI tienen un conjunto de variables de entorno que contienen meta-información sobre la petición tal y como establece la especificación CGI.

### Algunas limitaciones

- No es posible reeemplazar los valores o cambiar las variables estándar CGI usando las directivas de manipulación del entorno.
- Cuando se usa `suexec` para lanzar scripts CGI, el entorno se limpia y se queda reducido a un conjunto de variables seguras antes de que se lancen los scripts. La lista de variables seguras se define en el momento de compilar en `suexec.c`.
- Por razones de portabilidad, los nombres de las variables de entorno solo pueden contener letras, números y guiones bajos. Además, el primer caracter no puede ser un número. Los caracteres que no cumplan con esta restricción, se reemplazan automáticamente por un guión bajo cuando se pasan a scripts CGI y a páginas SSI.

## Cómo usar las variables de entorno

Módulos Relacionados | Directivas Relacionadas
--- | ---

- `mod_access`
- `mod_cgi`
- `mod_ext_filter`
- `mod_headers`
- `mod_include`
- `mod_log_config`
- `mod_rewrite`

- `Allow`
- `CustomLog`
- `Deny`
- `ExtFilterDefine`
- `Header`
- `LogFormat`
- `RewriteCond`
- `RewriteRule`

### Scripts CGI

Uno de los principales usos de las variables de entorno es pasar información a scripts CGI. Tal y como se explicaba más arriba, el entorno que se pasa a los scripts CGI incluye meta-información estándar acerca de la petición además de cualquier variable especificada en la configuración de Apache. Para obtener más información sobre este tema consulte el tutorial sobre CGIs.

### Páginas SSI

Los documentos procesados por el servidor con el filtro `INCLUDES` perteneciente a mod_include pueden imprimir las variables de entorno usando el elemento `echo`, y pueden usar las variables de entorno en elementos de control de flujo para dividir en partes una página condicional según las características de la petición. Apache también sirve páginas SSI con las variables CGI estándar tal y como se explica más arriba en este documento. Para obetener más información, consulte el tutorial sobre SSI.

### Control de acceso

El acceso al servidor puede ser controlado en función del valor de las variables de entorno usando las directivas `allow from env=` y `deny from env=`. En combinación con la directiva `SetEnvIf`, se puede tener un control más flexible del acceso al servidor en función de las características del cliente. Por ejemplo, puede usar estas directivas para denegar el acceso si el cliente usa un determinado navegador.

### Registro condicional

Los valores de las variables de entorno pueden registrarse en el log de acceso usando la directiva `LogFormat` con la opción `%e`. Además, la decisión sobre qué peticiones se registran puede ser tomada en función del valor de las variables de entorno usando la forma condicional de la directiva `CustomLog`. En combinación con `SetEnvIf`, esto permite controlar de forma flexible de qué peticiones se guarda registro. Por ejemplo, puede elegir no registrar las peticiones que se hagan a ficheros cuyo nombre termine en `gif`, o puede elegir registrar únicamente las peticiones que provengan de clientes que estén fuera de su propia red.

### Cabeceras de respuesta condicionales

La directiva `Header` puede utilizar la presencia o ausencia de una variable de entorno para determinar si una determinada cabecera HTTP se incluye en la respuesta al cliente. Esto permite, por ejemplo, que una determinada cabecera de respuesta sea enviada únicamente si también estaba presente en la petición del cliente.

### Activación de filtros externos

External filters configured by `mod_ext_filter` using the `ExtFilterDefine` directive can by activated conditional on an environment variable using the `disableenv=` and `enableenv=` options.

### Reescritura de URLs

La expresion `%{ENV:...}` de TestString en una directiva `RewriteCond` permite que el motor de reescritura de mod_rewrite pueda tomar decisiones en función del valor de variables de entorno. Tenga en cuenta que las variables accesibles en mod_rewrite sin el prefijo `ENV:` no son realmente variables de entorno. En realidad, son variables especiales de mod_rewrite que no pueden ser accedidas desde otros módulos.

## Variables de entorno con funciones especiales

Los problemas de interoperatividad han conducido a la introducción de mecanismos para modificar el comportamiento de Apache cuando se comunica con determinados clientes. Para hacer que esos mecanismos sean tan flexibles como sea posible, se invocan definiendo variables de entorno, normalmente con la directiva `BrowserMatch`, aunque también se puede usar por ejemplo con las directivas `SetEnv` y `PassEnv`.

### downgrade-1.0

Fuerza que la petición sea tratada como una petición HTTP/1.0 incluso si viene en una especificación posterior.

### force-no-vary

Hace que cualquier campo `Vary` se elimine de la cabecera de la respuesta antes de ser enviada al cliente. Algunos clientes no interpretan este campo correctamente (consulte la sección sobre problemas conocidos con clientes); usar esta variable puede evitar esos problemas. Usar esta variable implica también el uso de force-response-1.0.

### force-response-1.0

Fuerza que la respuesta a una petición HTTP/1.0 se haga también según la especificación HTTP/1.0. Esto se implementó originalmente como resultado de un problema con los proxies de AOL. Algunos clientes HTTP/1.0 no se comportan correctamente cuando se les envía una respuesta HTTP/1.1, y este mecanismo hace que se pueda interactuar con ellos.

### gzip-only-text/html

Cuando tiene valor "1", esta variable desactiva el filtro de salida DEFLATE de `mod_deflate` para contenidos de tipo diferentes de `text/html`.

### no-gzip

Cuando se especifica, se desactiva el filtro `DEFLATE` de `mod_deflate`.

### nokeepalive

Desactiva `KeepAlive`.

### prefer-language

Influye en el comportamiento de `mod_negotiation`. Si contiene una etiqueta de idioma (del tipo `en`, `ja` o `x-klingon`), `mod_negotiation` intenta que se use ese mismo idioma en la respuesta. Si no está disponible ese idioma, se aplica el proceso de negociación normal.

### redirect-carefully

Fuerza que el servidor sea especialmente cuidadoso al enviar una redirección al cliente. Se usa normalmente cuando un cliente tiene un problema conocido tratando las redirecciones. Fue implementado originalmente por el problema que presentaba el software de WebFolders de Microsoft, que tenía problemas interpretando redirecciones originadas cuando se accedía a recursos servidos usando DAV.

### suppress-error-charset

Disponible en las versiones de Apache 2.0.40 y posteriores

Cuando Apache efectúa una redirección en respuesta a la petición de un cliente, la respuesta incluye algún texto para que se muestre en caso de que el cliente no pueda seguir (o no siga) automáticamente la redirección. Apache normalmente etiqueta este texto siguiendo la codificación ISO-8859-1.

Sin embargo, si la redirección es a una página que usa una codificación diferente, algunas versiones de navegadores que no funcionan correctamente intentarán usar la codificación del texto de redirección en lugar de la de pagina a la que ha sido redireccionado. La consecuencia de esto puede ser, por ejemplo, que una página en griego no se muestre correctamente.

Especificar un valor en esta variable de entorno hace que Apache omita la codificación en el texto que incluye con las redirecciones, y que esos navegadores que no funcionan correctamente muestren correctamente la página de destino.

## Ejemplos

### Cómo cambiar el comportamiento de clientes que se comportan de manera inapropiada

Recomendamos que incluya las siguentes líneas en el fichero httpd.conf para evitar problemas conocidos

    #
    # Las siguientes directivas modifican el comportamiento normal de las respuestas HTTP.
    # La primera directiva desactiva keepalive para Netscape 2.x y para navegadores
    # que la simulan. Hay problemas conocidos con esos navegadores.
    # La segunda directiva es para Microsoft Internet Explorer 4.0b2
    # que tiene un fallo en la implemantación de HTTP/1.1 y no soporta
    # keepalive adecuadamente cuando se usan respuestas 301 ó 302 (redirecciones).
    #
    BrowserMatch "Mozilla/2" nokeepalive
    BrowserMatch "MSIE 4\.0b2;" nokeepalive downgrade-1.0 force-response-1.0

    #
    # La siguiente directiva desactiva las respuestas HTTP/1.1 para navegadores que
    # violan la especificación HTTP/1.0 @@@ by not being able to grok a
    # basic 1.1 response @@@.
    #
    BrowserMatch "RealPlayer 4\.0" force-response-1.0
    BrowserMatch "Java/1\.0" force-response-1.0
    BrowserMatch "JDK/1\.0" force-response-1.0

### No almacenar entradas en registro de acceso para las imágenes

Este ejemplo evita que las peticiones de imágenes aparezcan en el registro de acceso. Puede ser modificada fácilmente para evitar que se registren entradas de peticiones de directorios, o provenientes de determinados clientes.

    SetEnvIf Request_URI \.gif image-request
    SetEnvIf Request_URI \.jpg image-request
    SetEnvIf Request_URI \.png image-request
    CustomLog logs/access_log common env=!image-request

### Evitar el "robo de imagenes"

Este ejemplo muestra como evitar que otras webs usen las imágenes de su servidor para sus páginas. Esta configuración no se recomienda, pero puede funcionar en determinadas circunstancias. Asumimos que que todas sus imágenes están en un directorio llamado /web/images.

    SetEnvIf Referer "^http://www.example.com/" local_referal
    # Allow browsers that do not send Referer info
    SetEnvIf Referer "^$" local_referal
    <Directory  /web/images>
       Order Deny,Allow
       Deny from all
       Allow from env=local_referal
    </Directory>

Para obtener más información sobre esta técnica, consulte el tutorial de ApacheToday " Keeping Your Images from Adorning Other Sites".

Idiomas disponibles: en | es | fr | ja | ko