Versi�n 2.0 del Servidor HTTP Apache
Versi�n 2.0 del Servidor HTTP Apache
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.
| M�dulos Relacionados | Directivas Relacionadas |
|---|---|
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.
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.
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.
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.
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.| M�dulos Relacionados | Directivas Relacionadas |
|---|---|
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.
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.
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.
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.
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.
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.
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.
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.
Fuerza que la petici�n sea tratada como una petici�n HTTP/1.0 incluso si viene en una especificaci�n posterior.
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.
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.
Cuando tiene valor "1", esta variable desactiva el filtro
de salida DEFLATE de mod_deflate para
contenidos de tipo diferentes de text/html.
Cuando se especifica, se desactiva el filtro
DEFLATE de mod_deflate.
Desactiva KeepAlive.
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.
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.
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.
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
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
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".