From 442d653551b93894aba848b7acc20f3b0cb5cb92 Mon Sep 17 00:00:00 2001 From: Jesus Blanco Izquierdo Date: Tue, 7 Jun 2005 16:40:43 +0000 Subject: Spanish Translation for env.xml.es Translated by Jesus Blanco (blanco at apache dot org) Reviewed by Daniel Lopez (ridruejo at apache dot org) git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/branches/2.0.x@188811 13f79535-47bb-0310-9956-ffa450edef68 --- docs/manual/env.xml.es | 472 +++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 472 insertions(+) create mode 100644 docs/manual/env.xml.es (limited to 'docs/manual/env.xml.es') diff --git a/docs/manual/env.xml.es b/docs/manual/env.xml.es new file mode 100644 index 0000000000..9474beef55 --- /dev/null +++ b/docs/manual/env.xml.es @@ -0,0 +1,472 @@ + + + + + + + + + + Variables de entorno de 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.

+ + +
+ Especificación de variables de entorno + + + 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 + + + + 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".

+
-- cgit v1.2.1