You are viewing a plain text version of this content. The canonical link for it is here.
Posted to cvs@httpd.apache.org by lg...@apache.org on 2017/04/01 17:29:47 UTC
svn commit: r1789828 [3/4] - /httpd/httpd/branches/2.4.x/docs/manual/howto/
Added: httpd/httpd/branches/2.4.x/docs/manual/howto/cgi.xml.es
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/howto/cgi.xml.es?rev=1789828&view=auto
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/howto/cgi.xml.es (added)
+++ httpd/httpd/branches/2.4.x/docs/manual/howto/cgi.xml.es [utf-8] Sat Apr 1 17:29:47 2017
@@ -0,0 +1,594 @@
+<?xml version='1.0' encoding='UTF-8' ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.es.xsl"?>
+<!-- English Revision: 1773247 -->
+<!-- Spanish translation : Daniel Ferradal -->
+<!-- Reviewed by Luis Gil de Bernab� Pfeiffer lgilbernabe[AT]apache.org -->
+
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<manualpage metafile="cgi.xml.meta">
+ <parentdocument href="./">How-To / Tutoriales</parentdocument>
+ <title>Tutorial de Apache: Contenido Din�mico con CGI</title>
+
+ <section id="intro">
+ <title>Introducci�n</title>
+ <related>
+ <modulelist>
+ <module>mod_alias</module>
+ <module>mod_cgi</module>
+ <module>mod_cgid</module>
+ </modulelist>
+
+ <directivelist>
+ <directive module="mod_mime">AddHandler</directive>
+ <directive module="core">Options</directive>
+ <directive module="mod_alias">ScriptAlias</directive>
+ </directivelist>
+ </related>
+
+ <p>CGI (Common Gateway Interface) es un m�todo por el cual
+ un servidor web puede interactuar con programas externos de
+ generaci�n de contenido, a ellos nos referimos com�nmente como
+ programas CGI o scripts CGI. Es el m�todo m�s com�n y sencillo de
+ mostrar contenido din�mico en su sitio web. Este documento es una
+ introducci�n para configurar CGI en su servidor web Apache, y de
+ iniciaci�n para escribir programas CGI.</p>
+ </section>
+
+ <section id="configuring">
+ <title>Configurando Apache para permitir CGI</title>
+
+ <p>Para conseguir que sus programas CGI funcionen correctamente,
+ deber� configurar Apache para que permita la ejecuci�n de CGI. Hay
+ distintas formas de hacerlo.</p>
+
+ <note type="warning">Nota: Si Apache ha sido compilado con soporte
+ de m�dulos compartidos, necesitar� que el m�dulo de CGI est� cargado;
+ en su <code>httpd.conf</code> tiene que asegurarse de que la directiva
+ <directive module="mod_so">LoadModule</directive>
+ no ha sido comentada. Una directiva configurada correctamente ser�a as�:
+
+ <highlight language="config">
+ LoadModule cgid_module modules/mod_cgid.so
+ </highlight>
+
+ En Windows, o si usa un mpm que no es multihilo, como prefork, una
+ directiva configurada correctamente podr�a definirse as�:
+
+ <highlight language="config">
+ LoadModule cgi_module modules/mod_cgi.so
+ </highlight></note>
+
+ <section id="scriptalias">
+ <title>ScriptAlias</title>
+
+ <p>La directiva
+ <directive module="mod_alias">ScriptAlias</directive>
+ indica a Apache que un directorio se ha configurado espec�ficamente
+ para programas CGI. Apache asumir� que cada fichero en este
+ directorio es un programa CGI, e intentar� ejecutarlos cuando un
+ cliente solicita este recurso.</p>
+
+ <p>La directiva
+ <directive module="mod_alias">ScriptAlias</directive> se puede
+ definir as�:</p>
+
+ <highlight language="config">
+ ScriptAlias "/cgi-bin/" "/usr/local/apache2/cgi-bin/"
+ </highlight>
+
+ <p>El ejemplo que se muestra es de un archivo de configuraci�n
+ <code>httpd.conf</code> por defecto si usted instal� Apache
+ en la ubicaci�n por defecto. La directiva
+ <directive module="mod_alias">ScriptAlias</directive> es muy
+ parecida a la directiva <directive module="mod_alias">Alias</directive>,
+ �sta define un prefijo de URL que se enlaza a un directorio
+ en particular. <directive>Alias</directive> y
+ <directive>ScriptAlias</directive> se usan generalmente para
+ directorios que se encuentran fuera del directorio
+ <directive module="core">DocumentRoot</directive>. La diferencia
+ entre <directive>Alias</directive> y <directive>ScriptAlias</directive>
+ es que en <directive>ScriptAlias</directive> cualquier elemento
+ debajo de ese prefijo de URL ser� considerado un programa CGI. As�,
+ el ejemplo de m�s arriba le indica a Apache que
+ cualquier solicitud para un recurso que comience con
+ <code>/cgi-bin/</code> deber�a servirse desde el directorio
+ <code>/usr/local/apache2/cgi-bin/</code>, y deber�a tratarse como un
+ programa CGI.</p>
+
+ <p>Por ejemplo, si se solicita la URL
+ <code>http://www.example.com/cgi-bin/test.pl</code>,
+ Apache intentar� ejecutar el archivo
+ <code>/usr/local/apache2/cgi-bin/test.pl</code> y dar
+ el resultado. Por supuesto el archivo debe existir y ser ejecutable,
+ y dar el resultado de una manera espec�fica o Apache devolver�
+ un mensaje de error.</p>
+ </section>
+
+ <section id="nonscriptalias">
+ <title>CGI fuera de directorios ScriptAlias</title>
+
+ <p>Los programas CGI habitualmente se restringen a los directorios de
+ <directive module="mod_alias">ScriptAlias</directive> por razones de
+ seguridad. De esta manera, los administradores pueden controlar de una
+ manera m�s segura quien puede ejecutar programas CGI. Aun as�, si no
+ se toman suficientes precauciones, no hay ninguna raz�n por la que
+ programas CGI no se puedan ejecutar desde directorios seleccionados de
+ manera arbitraria. Por ejemplo, quiz�s quiera permitir que usuarios del
+ sistema tengan contenido web en sus directorios home con la directiva
+ <directive module="mod_userdir">UserDir</directive>. Si quieren
+ tener sus propios programas CGI, pero no tienen acceso al directorio
+ principal <code>cgi-bin</code>, necesitar�n ser capaces de
+ ejecutar sus scripts CGI en alg�n otro sitio.</p>
+
+ <p>Hay dos pasos a seguir para permitir la ejecuci�n CGI en directorios
+ seleccionados de manera arbitraria. Primero, el handler
+ <code>cgi-script</code> debe estar activado usando la directiva
+ <directive module="mod_mime">AddHandler</directive> o la directiva
+ <directive module="core">SetHandler</directive>. Segundo, el par�metro
+ <code>ExecCGI</code> debe estar definido en la directiva
+ <directive module="core">Options</directive>.</p>
+ </section>
+
+ <section id="options">
+ <title>Usando Options de manera expl�cita para permitir ejecuci�n de
+ CGI</title>
+
+ <p>Puede usar la directiva
+ <directive module="core">Options</directive>, en el archivo de
+ configuraci�n principal para especificar que se permite la ejecuci�n
+ de CGI en un directorio en particular:</p>
+
+ <highlight language="config">
+<Directory "/usr/local/apache2/htdocs/somedir">
+ Options +ExecCGI
+</Directory>
+ </highlight>
+
+ <p>Esta directiva de aqu� arriba le indica a Apache que debe
+ permitir la ejecuci�n de archivos CGI. Tambi�n necesitar� indicarle
+ al servidor que los archivos son archivos CGI. La directiva
+ <directive module="mod_mime">AddHandler</directive> le indica al
+ servidor que debe tratar a todos los archivos con la extensi�n
+ <code>cgi</code> o <code>pl</code> como programas CGI:</p>
+
+ <highlight language="config">
+ AddHandler cgi-script .cgi .pl
+ </highlight>
+ </section>
+
+ <section id="htaccess">
+ <title>Ficheros .htaccess</title>
+
+ <p>El <a href="htaccess.html">tutorial <code>.htaccess</code></a>
+ ense�a como activar programas CGI si no tienes acceso a
+ <code>httpd.conf</code>.</p>
+ </section>
+
+ <section id="userdir">
+ <title>Directorios de Usuario</title>
+
+ <p>Para permitir la ejecuci�n de programas CGI para cualquier
+ archivo que acabe en <code>.cgi</code> en directorios de usuario,
+ puedes usar la siguiente configuraci�n:</p>
+
+ <highlight language="config">
+<Directory "/home/*/public_html">
+ Options +ExecCGI
+ AddHandler cgi-script .cgi
+</Directory>
+ </highlight>
+
+ <p>Si quiere designar un subdirectorio <code>cgi-bin</code> dentro
+ de un directorio de usuario en el que todos los ficheros ser�n
+ tratados como un programa CGI, puede usar lo siguiente:</p>
+
+ <highlight language="config">
+<Directory "/home/*/public_html/cgi-bin">
+ Options ExecCGI
+ SetHandler cgi-script
+</Directory>
+ </highlight>
+ </section>
+ </section>
+
+ <section id="writing">
+ <title>Escribiendo un programa CGI</title>
+
+ <p>Hay dos diferencias principales entre programaci�n ``regular'' y
+ programaci�n en CGI.</p>
+
+ <p>Primera, el resultado al completo de tu programa CGI debe estar
+ precedido de una cabecera <glossary>MIME-type</glossary>. Esta
+ cabecera HTTP le indica al cliente que tipo de contenido est�
+ recibiendo. La mayor parte de las veces, �sto ser� algo como:</p>
+
+ <example>
+ Content-type: text/html
+ </example>
+
+ <p>Segunda, el resultado debe estar en formato HTML, o cualquier
+ otro formato que su navegador sea capaz de mostrar. La mayor
+ parte de las veces, ser� HTML, pero otras escribir� un programa
+ CGI que devuelve una imagen gif, u otro contenido no-HTML.</p>
+
+ <p>Aparte de estas dos cosas, escribir un programa en CGI se
+ parecer� bastante a cualquier otro programa que vaya a escribir.
+ </p>
+
+
+ <section id="firstcgi">
+ <title>Su primer programa CGI</title>
+
+ <p>A continuaci�n podr� ver un ejemplo de programa CGI que muestra
+ una l�nea de texto en su navegador. Escriba lo siguiente,
+ gu�rdelo en un archivo con el nombre <code>first.pl</code>, y
+ p�ngalo en su directorio <code>cgi-bin</code>.</p>
+
+ <highlight language="perl">
+#!/usr/bin/perl
+print "Content-type: text/html\n\n";
+print "Hola, Mundo.";
+ </highlight>
+
+ <p>Incluso si Perl no le resulta familiar, podr� ver lo que est�
+ ocurriendo aqu�. La primera l�nea le dice a Apache (o a
+ cualquier shell en la que se est� ejecutando) que este programa
+ puede ejecutarse con el int�rprete en la ubicaci�n
+ <code>/usr/bin/perl</code>. La segunda l�nea imprime la
+ declaraci�n de Content-Type que mencionamos antes, seguida de
+ dos pares de retornos de carro. Esto pone una l�nea en blanco
+ despu�s de la cabecera para indicar el final de las cabeceras
+ HTTP, y el comienzo del cuerpo del contenido. La tercera
+ imprime la cadena de caracteres "Hola, Mundo.". Y ese es el
+ final del programa.</p>
+
+ <p>Si lo abre con su navegador favorito y le dice que solicite la
+ direcci�n</p>
+
+ <example>
+ http://www.example.com/cgi-bin/first.pl
+ </example>
+
+ <p>o donde quiera que pusiera el archivo, ver� una l�nea
+ <code>Hola, Mundo.</code> aparecer�n la ventana del navegador. No es
+ muy emocionante, pero una vez que consiga que funcione podr� hacer
+ lo mismo con casi cualquier programa.</p>
+ </section>
+ </section>
+
+ <section id="troubleshoot">
+ <title>�Pero todav�a no funciona!</title>
+
+ <p>Hay 4 cosas b�sicas que puede llegar a ver en su navegador cuando
+ intenta acceder a un programa CGI desde la web:</p>
+
+ <dl>
+ <dt>El resultado del programa CGI</dt>
+ <dd>�Genial! Esto indica que todo funcion� correctamente. Si el
+ resultado es correcto, pero el navegador no lo procesa
+ correctamente, aseg�rese de que tiene especificado
+ correctamente el <code>Content-Type</code> en su programa
+ CGI.</dd>
+
+ <dt>El c�digo fuente de su programa CGI o un mensaje del tipo
+ "POST Method Not Allowed".</dt>
+
+ <dd>Eso significa que no ha configurado Apache de manera
+ apropiada para interpretar su programa CGI. Relea la secci�n
+ de <a href="#configuring">Configurando Apache</a> e intente
+ encontrar qu� le falta.</dd>
+
+ <dt>Un mensaje que empieza con "Forbidden"</dt>
+ <dd>Eso significa que hay un problema de permisos. Compruebe el
+ <a href="#errorlogs">Log de Errores de Apache</a> y la
+ secci�n de m�s abajo de <a href="#permissions">Permisos de
+ Fichero</a>.</dd>
+
+ <dt>Un mensaje indicando "Internal Server Error"</dt>
+ <dd>Si comprueba el <a href="#errorlogs">Log de errores de
+ Apache</a>, probablemente encontrar� que indica "Premature
+ end of script headers", posiblemente acompa�ado de otro
+ mensaje de error generado por su programa CGI. En este caso,
+ querr� comprobar cada una de las secciones de m�s adelante
+ para ver qu� impide que su programa CGI genere las cabeceras
+ HTTP adecuadas.</dd>
+ </dl>
+
+ <section id="permissions">
+ <title>Permisos de Fichero</title>
+
+ <p>Recuerde que el servidor no se ejecuta con su usuario. Es decir,
+ cuando el servidor arranca, est� funcionando con un usuario sin
+ privilegios, generalmente el usuario <code>nobody</code>, o
+ <code>www-data</code>, as� que necesitar� permisos extra para
+ ejecutar los archivos de los que usted es due�o. Generalmente,
+ el m�todo para dar permisos suficientes para que se pueda
+ ejecutar con <code>nobody</code> es dar permisos de ejecuci�n a
+ todo el mundo en el fichero:</p>
+
+ <example>
+ chmod a+x first.pl
+ </example>
+
+ <p>Adem�s, si su programa lee desde o escribe a cualquier otro/s
+ archivo/s, esos archivos necesitar�n tener los permisos correctos
+ para permitir esas acciones.</p>
+
+ </section>
+
+ <section id="pathinformation">
+ <title>Informaci�n de Ruta y Entorno</title>
+
+ <p>Cuando ejecuta un programa desde la l�nea de comandos, usted tiene
+ cierta informaci�n que se le pasa a la shell sin que usted se
+ percate de ello. Por ejemplo, usted tiene un <code>PATH</code>,
+ que le indica a la shell d�nde debe buscar archivos a los que usted
+ hace referencia.</p>
+
+ <p>Cuando un programa se ejecuta a trav�s del servidor web como un
+ programa CGI, puede que no tenga el mismo <code>PATH</code>.
+ Cualquier programa que invoque desde su programa CGI (como por
+ ejemplo <code>sendmail</code>) necesitar� que se le indique la
+ ruta absoluta, as� la shell puede encontrarlos cuando intenta
+ ejecutar su programa CGI.</p>
+
+ <p>Una manifestaci�n com�n de esto es la ruta del int�rprete del
+ script (a menudo <code>perl</code>) indicado en la primera l�nea
+ de su programa CGI, que parecer� algo como:</p>
+
+ <highlight language="perl">
+ #!/usr/bin/perl
+ </highlight>
+
+ <p>Aseg�rese de que �ste es de hecho el path de su int�rprete.</p>
+ <note type="warning">
+ Cuando edita scripts CGI en Windows, los caracteres de retorno de
+ carro podr�an a�adirse a la l�nea donde se especifica el int�rprete.
+ Aseg�rese de que los archivos se transfieren al servidor en modo
+ ASCII. Fallar en esto puede acabar con avisos del tipo "Command not
+ found" del Sistema Operativo, debido a que �ste no reconoce los
+ caracteres de final de l�nea interpretados como parte del nombre
+ de fichero del int�rprete.
+ </note>
+ </section>
+
+ <section id="missingenv">
+ <title>Faltan Variables de Entorno</title>
+
+ <p>Si su programa CGI depende de <a
+ href="#env">variables de entorno</a> no est�ndar, necesitar�
+ asegurarse de que Apache pasa esas variables.</p>
+
+ <p>Cuando no encuentra ciertas cabeceras HTTP del entorno, aseg�rese
+ de que est�n formateadas seg�n el
+ <a href="http://tools.ietf.org/html/rfc2616">RFC 2616</a>,
+ secci�n 4.2: Nombres de Cabeceras deben empezar con una letra,
+ seguida solo de letras, n�meros o gui�n. Cualquier cabecera
+ que no cumpla esta regla ser� ignorada de manera silenciosa.</p>
+
+ </section>
+
+ <section id="syntaxerrors">
+ <title>Errores de Programa</title>
+
+ <p>La mayor parte de las veces cuando un programa CGI falla, es por un
+ problema en el programa mismo. Esto ocurre generalmente cuando se
+ maneja bien con "esto del CGI", y ya no comete los dos errores
+ mencionados m�s arriba. Lo primero que hay que hacer es asegurarse
+ de que su programa se ejecuta correctamente en l�nea de comandos
+ antes de probarlo a trav�s del servidor web. Por ejemplo,
+ intente:</p>
+
+ <example>
+ cd /usr/local/apache2/cgi-bin<br/>
+ ./first.pl
+ </example>
+
+ <p>(No llame al int�rprete de <code>perl</code>. La consola y Apache
+ tienen que poder encontrar el int�rprete usando l�nea
+ <a href="#pathinformation">l�nea de informaci�n</a> en la primera
+ l�nea del script.)</p>
+
+ <p>Lo primero que debe ver escrito por su programa es un conjunto de
+ cabeceras HTTP, incluyendo el <code>Content-Type</code>,
+ seguido de una l�nea en blanco. Si ve alguna otra cosa, Apache
+ devolver� el error <code>Premature end of script headers</code> si
+ intenta lanzar el script en el servidor web. Vea
+ <a href="#writing">Escribiendo un programa CGI</a> m�s arriba para
+ m�s detalle.</p>
+ </section>
+
+ <section id="errorlogs">
+ <title>Log de Errores</title>
+
+ <p>El log de errores es su amigo. Cualquier cosa que vaya mal generar�
+ un mensaje en el log de errores. Deber�a mirar siempre ah� primero.
+ Si el lugar donde est� alojando su sitio web no permite que acceda
+ al log de errores, probablemente deber�a alojarlo en otro sitio.
+ Aprenda a leer el log de errores y se dar� cuenta de que enseguida
+ averiguar� el motivo del error y lo solucionar� r�pidamente.</p>
+ </section>
+
+ <section id="suexec">
+ <title>Suexec</title>
+
+ <p>El programa de soporte <a href="../suexec.html">suexec</a> permite
+ que programas CGI se ejecuten con permisos de usuario distintos,
+ dependiendo del virtualhost o el directorio home donde se
+ encuentren. Suexec tiene una comprobaci�n de permisos muy estricta,
+ y cualquier fallo en esa comprobaci�n dar� como resultado un error
+ con el mensaje <code>Premature end of script headers</code>.</p>
+
+ <p>Para comprobar si est� usando Suexec, ejecute
+ <code>apachectl -V</code> y compruebe la ubicaci�n de
+ <code>SUEXEC_BIN</code>. Si Apache encuentra un binario
+ <program>suexec</program> al arrancar, suexec se activar�.</p>
+
+ <p>A menos que comprenda suxec perfectamente, no deber�a usarlo.
+ Para desactivar suexec, basta con eliminar el binario
+ <program>suexec</program> al que apunta <code>SUEXEC_BIN</code> y
+ reiniciar el servidor. Si despu�s de leer sobre
+ <a href="../suexec.html">suexec</a> todav�a quiere usarlo, entonces
+ ejecute <code>suexec -V</code> para encontrar la ubicaci�n del
+ fichero log de suexec, y use ese log para encontrar que pol�tica no
+ est� cumpliendo.</p>
+ </section>
+ </section>
+
+ <section id="behindscenes">
+ <title>�Qu� ocurre entre bastidores?</title>
+
+ <p>En cuanto tenga conocimiento avanzado de programaci�n CGI, le ser�
+ �til comprender m�s de lo que ocurre entre bastidores.
+ Espec�ficamente, c�mo el navegador y el servidor se comunican el uno
+ con el otro. Porque aunque est� muy bien escribir un programa que
+ diga "Hola, Mundo.", no tiene una gran utilidad.</p>
+
+ <section id="env">
+ <title>Variables de Entorno</title>
+
+ <p>Las variables de entorno son valores que est�n ah� cuando
+ usa el ordenador. Son cosas �tiles como el path (donde su ordenador
+ busca el archivo espec�fico que se lanza cuando usted escribe un
+ comando), su nombre de usuario, el tipo de terminal que usa, etc.
+ Para una lista completa de la variables de entorno normales que se
+ se usan en su d�a a d�a escriba <code>env</code> en la l�nea de
+ comandos.</p>
+
+ <p>Durante la transacci�n CGI, el servidor y el navegador tambi�n
+ configuran variables de entorno, y as� pueden comunicarse entre
+ ellos. Cosas como el tipo de navegador (Netscape, IE, Lynx), el tipo
+ de servidor (Apache, IIS, WebSite), el nombre del programa CGI que
+ se est� ejecutando, etc.</p>
+
+ <p>Estas variables est�n disponibles para el programador de CGI, y son
+ la mitad de la historia de la comunicaci�n cliente-servidor. La
+ lista completa de las variables necesarias se encuentra en
+ <a href="http://www.ietf.org/rfc/rfc3875">el RFC de Common Gateway
+ Interface</a>.</p>
+
+ <p>Este sencillo programa CGI en Perl mostrar� todas las variables
+ de entorno que se est�n pasando entre el cliente y el navegador. Dos
+ programas similares est�n incluidos en el directorio
+ <code>cgi-bin</code> de la distribuci�n de Apache. Tenga en cuenta
+ que algunas variables son necesarias mientras que otras son
+ opcionales, as� que es posible que vea algunas variables que no
+ est�n en la lista oficial. Adicionalmente, Apache aporta distintas
+ maneras diferentes para que pueda
+ <a href="../env.html">a�adir sus variables de entorno</a> a las
+ b�sicas que se proveen por defecto.</p>
+
+ <highlight language="perl">
+#!/usr/bin/perl
+use strict;
+use warnings;
+
+print "Content-type: text/html\n\n";
+
+foreach my $key (keys %ENV) {
+ print "$key --> $ENV{$key}<br>";
+}
+ </highlight>
+ </section>
+
+ <section id="stdin">
+ <title>STDIN y STDOUT</title>
+
+ <p>Otra comunicaci�n entre el servidor y el cliente ocurre en la
+ entrada est�ndar (<code>STDIN</code>) y la salida est�ndar
+ (<code>STDOUT</code>). En el contexto normal de cada d�a,
+ <code>STDIN</code> es la entrada con el teclado, o un fichero que se
+ le da a un programa para que act�e sobre �l, y <code>STDOUT</code>
+ generalmente es la consola o la pantalla.</p>
+
+ <p>Cuando hace <code>POST</code> con un formulario de web a un programa
+ CGI, los datos en ese formulario se empaquetan en un formato especial
+ que se entrega a su programa CGI en el <code>STDIN</code>.
+ Entonces el programa puede procesar la informaci�n como si le llegara
+ desde el teclado, o desde un fichero.</p>
+
+ <p>El "formato especial" es muy sencillo. Un nombre de campo y su
+ valor se asocian juntos con el signo igual (=), y pares de valores
+ se asocian juntos con el ampersand � et en espa�ol (&).
+ Caracteres inconvenientes como los espacios, ampersands y signos de
+ igual, se convierten en su equivalente hexadecimal para no impidan
+ el funcionamiento correcto del programa. La cadena de datos al
+ completo ser� algo como:</p>
+
+ <example>
+ name=Rich%20Bowen&city=Lexington&state=KY&sidekick=Squirrel%20Monkey
+ </example>
+
+ <p>A veces tendr� este tipo de cadena de caracteres al final de una
+ URL. Cuando esto ocurre, el servidor pone esa cadena en una variable
+ de entorno que se llama <code>QUERY_STRING</code>. Esto se llama
+ solicitud <code>GET</code>. Su formulario HTML especifica si se usa
+ un <code>GET</code> o un <code>POST</code> para entregar la
+ informaci�n, configurando el atributo <code>METHOD</code> en la
+ etiqueta <code>FORM</code>.</p>
+
+ <p>Su programa es el responsable de convertir esa cadena de
+ caracteres en informaci�n �til. Afortunadamente, hay librer�as y
+ m�dulos disponibles que ayudan a procesar la informaci�n, as� como a
+ gestionar los distintos aspectos de su programa CGI.</p>
+ </section>
+ </section>
+
+ <section id="libraries">
+ <title>M�dulos/librer�as CGI</title>
+
+ <p>Cuando escribe programas CGI, deber�a considerar usar una librer�a de
+ c�digo, o m�dulo, para hacer todo el trabajo m�s arduo por usted.
+ Esto lleva a tener menos errores y un desarrollo de c�digo m�s
+ r�pido.</p>
+
+ <p>Si est� escribiendo un programa CGI en Perl, existen m�dulos
+ disponibles en <a href="http://www.cpan.org/">CPAN</a>. El m�dulo m�s
+ conocido para este prop�sito es <code>CGI.pm</code>. Quiz�s quiera
+ considerar <code>CGI::Lite</code>, que implementa una funcionalidad
+ m�nima, que es todo lo que se necesita en la mayor�a de los programas.</p>
+
+ <p>Si est� escribiendo programas CGI en C, hay varidad de opciones. Una
+ de estas es la librer�a <code>CGIC</code>, de
+ <a href="http://www.boutell.com/cgic/">http://www.boutell.com/cgic/</a>.
+ </p>
+ </section>
+
+ <section id="moreinfo">
+ <title>Para m�s informaci�n</title>
+
+ <p>La especificaci�n actual de CGI est� disponible en el
+ <a href="http://www.ietf.org/rfc/rfc3875">RFC de Common Gateway
+ Interface</a>.</p>
+
+ <p>Cuando env�e una pregunta sobre un problema de CGI, o bien a una
+ lista de correo, o a un grupo de noticias, aseg�rese de que facilita suficiente
+ informaci�n de lo que ha ocurrido, de lo que espera que ocurra, y de
+ lo que est� ocurriendo en su lugar que es diferente, el servidor que
+ est� ejecutando, en qu� lenguaje CGI est� hecho su programa, y si es
+ posible, el c�digo que falla. Esto har� encontrar el problema mucho m�s
+ f�cil.</p>
+
+ <p>Tenga en cuenta que las preguntas sobre problemas CGI
+ <strong>nunca</strong> deber�an enviarse a la base de datos de bugs de
+ bugs de Apache a menos que est� seguro de haber encontrado un
+ problema en el c�digo fuente de Apache.</p>
+ </section>
+</manualpage>
Modified: httpd/httpd/branches/2.4.x/docs/manual/howto/cgi.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/howto/cgi.xml.meta?rev=1789828&r1=1789827&r2=1789828&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/howto/cgi.xml.meta (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/howto/cgi.xml.meta Sat Apr 1 17:29:47 2017
@@ -8,6 +8,7 @@
<variants>
<variant>en</variant>
+ <variant>es</variant>
<variant>fr</variant>
<variant outdated="yes">ja</variant>
<variant outdated="yes">ko</variant>
Modified: httpd/httpd/branches/2.4.x/docs/manual/howto/htaccess.html
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/howto/htaccess.html?rev=1789828&r1=1789827&r2=1789828&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/howto/htaccess.html (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/howto/htaccess.html Sat Apr 1 17:29:47 2017
@@ -4,6 +4,10 @@ URI: htaccess.html.en
Content-Language: en
Content-type: text/html; charset=ISO-8859-1
+URI: htaccess.html.es
+Content-Language: es
+Content-type: text/html; charset=ISO-8859-1
+
URI: htaccess.html.fr
Content-Language: fr
Content-type: text/html; charset=ISO-8859-1
Added: httpd/httpd/branches/2.4.x/docs/manual/howto/htaccess.html.es
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/howto/htaccess.html.es?rev=1789828&view=auto
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/howto/htaccess.html.es (added)
+++ httpd/httpd/branches/2.4.x/docs/manual/howto/htaccess.html.es Sat Apr 1 17:29:47 2017
@@ -0,0 +1,464 @@
+<?xml version="1.0" encoding="ISO-8859-1"?>
+<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
+<html xmlns="http://www.w3.org/1999/xhtml" lang="es" xml:lang="es"><head>
+<meta content="text/html; charset=ISO-8859-1" http-equiv="Content-Type" />
+<!--
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ This file is generated from xml source: DO NOT EDIT
+ XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
+ -->
+<title>Tutorial del Servidor Apache HTTP: Ficheros .htaccess - Servidor Apache HTTP Versión 2.4</title>
+<link href="../style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
+<link href="../style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
+<link href="../style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" /><link rel="stylesheet" type="text/css" href="../style/css/prettify.css" />
+<script src="../style/scripts/prettify.min.js" type="text/javascript">
+</script>
+
+<link href="../images/favicon.ico" rel="shortcut icon" /></head>
+<body id="manual-page"><div id="page-header">
+<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p>
+<p class="apache">Versión 2.4 del Servidor HTTP Apache</p>
+<img alt="" src="../images/feather.png" /></div>
+<div class="up"><a href="./"><img title="<-" alt="<-" src="../images/left.gif" /></a></div>
+<div id="path">
+<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a> > <a href="../">Versión 2.4</a> > <a href="./">How-To / Tutoriales</a></div><div id="page-content"><div id="preamble"><h1>Tutorial del Servidor Apache HTTP: Ficheros .htaccess</h1>
+<div class="toplang">
+<p><span>Idiomas disponibles: </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../es/howto/htaccess.html" title="Español"> es </a> |
+<a href="../fr/howto/htaccess.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
+<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
+<a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
+<a href="../pt-br/howto/htaccess.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a></p>
+</div>
+
+ <p>Los ficheros <code>.htaccess</code> facilitan una forma de realizar
+ cambios en la configuración en contexto directorio.</p>
+</div>
+<div id="quickview"><a href="https://www.apache.org/foundation/contributing.html" class="badge"><img src="https://www.apache.org/images/SupportApache-small.png" alt="Support Apache!" /></a><ul id="toc"><li><img alt="" src="../images/down.gif" /> <a href="#related">Ficheros .htaccess</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#what">Qué son/Cómo usarlos</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#when">Cuando (no) usar ficheros .htaccess</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#how">How directives are applied</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#auth">Ejemplo de Autenticación</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#ssi">Ejemplo de Server Side Includes</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#rewrite">Reglas de Rewrite en ficheros .htaccess</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#cgi">Ejemplo de CGI</a></li>
+<li><img alt="" src="../images/down.gif" /> <a href="#troubleshoot">Resolución de problemas</a></li>
+</ul><h3>Consulte también</h3><ul class="seealso"><li><a href="#comments_section">Comentarios</a></li></ul></div>
+<div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="related" id="related">Ficheros .htaccess</a></h2>
+ <table class="related"><tr><th>Módulos Relacionados</th><th>Directivas Relacionadas</th></tr><tr><td><ul><li><code class="module"><a href="../mod/core.html">core</a></code></li><li><code class="module"><a href="../mod/mod_authn_file.html">mod_authn_file</a></code></li><li><code class="module"><a href="../mod/mod_authz_groupfile.html">mod_authz_groupfile</a></code></li><li><code class="module"><a href="../mod/mod_cgi.html">mod_cgi</a></code></li><li><code class="module"><a href="../mod/mod_include.html">mod_include</a></code></li><li><code class="module"><a href="../mod/mod_mime.html">mod_mime</a></code></li></ul></td><td><ul><li><code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code></li><li><code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code></li><li><code class="directive"><a href="../mod/core.html#options">Options</a></code></li><li><code class="directive"><a href="../mod/mod_mime.html#addhandler">A
ddHandler</a></code></li><li><code class="directive"><a href="../mod/core.html#sethandler">SetHandler</a></code></li><li><code class="directive"><a href="../mod/mod_authn_core.html#authtype">AuthType</a></code></li><li><code class="directive"><a href="../mod/mod_authn_core.html#authname">AuthName</a></code></li><li><code class="directive"><a href="../mod/mod_authn_file.html#authuserfile">AuthUserFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_groupfile.html#authgroupfile">AuthGroupFile</a></code></li><li><code class="directive"><a href="../mod/mod_authz_core.html#require">Require</a></code></li></ul></td></tr></table>
+
+ <div class="note">Debería evitar usar ficheros <code>.htaccess</code> completamente si
+ tiene acceso al fichero de configuración principal de httpd. Usar ficheros
+ <code>.htaccess</code> ralentiza su servidor Apache http. Cualquier
+ directiva que pueda incluir en un fichero <code>.htaccess</code>
+ estará mejor configurada dentro de una sección
+ <code class="directive"><a href="../mod/core.html#directory">Directory</a></code>, tendrá el mismo efecto y
+ mejor rendimiento.</div>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="what" id="what">Qué son/Cómo usarlos</a></h2>
+
+
+ <p>Los ficheros <code>.htaccess</code> (o "ficheros de configuración
+ distribuida") facilitan una forma de realizar cambios en la configuración
+ en contexto directorio. Un fichero, que contiene una o más directivas, se
+ coloca en un documento específico de un directorio, y estas directivas
+ aplican a ese directorio y todos sus subdirectorios.</p>
+
+ <div class="note"><h3>Nota:</h3>
+ <p>Si quiere llamar a su fichero <code>.htaccess</code> de otra manera,
+ puede cambiar el nombre del fichero usando la directiva <code class="directive"><a href="../mod/core.html#accessfilename">AccessFileName</a></code>. Por ejemplo, si usted prefiere
+ llamar al fichero <code>.config</code>, entonces puede poner lo siguiente
+ en el fichero de configuración de su servidor:</p>
+
+ <pre class="prettyprint lang-config">AccessFileName ".config"</pre>
+
+ </div>
+
+ <p>Generalmente, los ficheros <code>.htaccess</code> usan la misma sintáxis
+ que los <a href="../configuring.html#syntax">ficheros de la configuración
+ principal</a>. Lo que puede utilizar en estos ficheros lo determina la
+ directiva <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>. Esta directiva
+ especifica, en categorías, qué directivas tendrán efecto si se encuentran en
+ un fichero <code>.htaccess</code>. Si se permite una directiva en un fichero
+ <code>.htaccess</code>, la documentación para esa directiva contendrá una
+ sección Override, especificando qué valor debe ir en
+ <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> para que se permita esa
+ directiva.</p>
+
+ <p>Por ejemplo, si busca en la documentación la directiva <code class="directive"><a href="../mod/core.html#adddefaultcharset">AddDefaultCharset</a></code>, encontrará que se permite en
+ ficheros <code>.htaccess</code>. (Vea la línea de Contexto en el sumario de
+ la directiva.) La línea <a href="../mod/directive-dict.html#Context">Override</a> muestra
+ <code>FileInfo</code>. De este modo, debe tener al menos
+ <code>AllowOverride FileInfo</code> para que esta directiva se aplique en
+ ficheros <code>.htaccess</code>.</p>
+
+ <div class="example"><h3>Ejemplo:</h3><table>
+ <tr>
+ <td><a href="../mod/directive-dict.html#Context">Context:</a></td>
+ <td>server config, virtual host, directory, .htaccess</td>
+ </tr>
+
+ <tr>
+ <td><a href="../mod/directive-dict.html#Override">Override:</a></td>
+ <td>FileInfo</td>
+ </tr>
+ </table></div>
+
+ <p>Si no está seguro de cuándo, una directiva en concreto, se puede usar en un
+ fichero <code>.htaccess</code>, consulte la documentación para esa directiva,
+ y compruebe la línea Context buscando ".htaccess".</p>
+ </div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="when" id="when">Cuando (no) usar ficheros .htaccess</a></h2>
+
+ <p>Generalmente, solo debería usar ficheros <code>.htaccess</code> cuando no
+ tiene acceso al fichero principal de configuración del servidor. Hay, por
+ ejemplo, una creencia errónea de que la autenticación de usuario debería
+ hacerse siempre dentro de ficheros <code>.htaccess</code>, y, más recientemente, otra creencia errónea de que las directivas de
+ <code class="module"><a href="../mod/mod_rewrite.html">mod_rewrite</a></code> deben ir en ficheros <code>.htaccess</code>.
+ Esto sencillamente no es el caso. Puede poner las configuraciones de
+ autenticación de usuario en la configuración principal del servidor, y esto
+ es de hecho, el método preferido de configurar Apache. Del mismo modo, las
+ directivas <code>mod_rewrite</code> funcionan mejor, en muchos sentidos, en
+ el fichero de configuración principal del servidor.</p>
+
+ <p>Los ficheros <code>.htaccess</code> deberían usarse cuando su proveedor
+ de contenidos le permite hacer modificaciones de configuración
+ en contexto directorio, pero usted no tiene acceso de root en el servidor.
+ En el caso de que el administrador no esté dispuesto a hacer cambios
+ frecuentes en la configuración, puede que sea necesario permitir a usuarios
+ individuales realizar estos cambios de configuración en ficheros
+ <code>.htaccess</code> por ellos mismos. Lo cual ocurre a menudo, por
+ ejemplo, en casos donde los ISP están albergando múltiples sitios web de
+ usuario en una sola máquina, y quieren que sus usuarios tengan la
+ posibilidad de modificar sus configuraciones.</p>
+
+ <p>Aun así, generalmente, el uso de ficheros <code>.htaccess</code> debería
+ evitarse cuando sea posible. Cualquier configuración que consideraría poner
+ en un fichero <code>.htaccess</code>, puede usarse con la misma efectividad
+ en una sección <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> en el fichero de configuración
+ del servidor.</p>
+
+ <p>Hay dos razones para evitar el uso de ficheros <code>.htaccess</code>.</p>
+
+ <p>La primera es el rendimiento. Cuando <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>
+ está configurado para permitir el uso de ficheros <code>.htaccess</code>,
+ httpd buscará ficheros <code>.htaccess</code> en cada directorio. Así,
+ permitiendo ficheros <code>.htaccess</code> provoca una pérdida de
+ rendimiento, ¡incluso aunque no los use! Además, los ficheros
+ <code>.htaccess</code> se cargan cada vez que se solicita un documento.</p>
+
+ <p>Además tenga en cuenta que httpd debe buscar ficheros
+ <code>.htaccess</code> en todos los directorios de mayor jerarquía,
+ para poder terner la lista completa de directivas que debe aplicar. (Vea
+ la sección sobre <a href="#how">Cómo se aplican las directivas</a>.) Así, si
+ se solicita un fichero de un directorio <code>/www/htdocs/example</code>,
+ httpd debe buscar los siguientes ficheros:</p>
+
+ <div class="example"><p><code>
+ /.htaccess<br />
+ /www/.htaccess<br />
+ /www/htdocs/.htaccess<br />
+ /www/htdocs/example/.htaccess
+ </code></p></div>
+
+ <p>De esta manera, por cada acceso a un fichero de ese directorio, hay 4
+ accesos adicionales al sistema de ficheros, incluso si ninguno de esos
+ ficheros está presente. (Tenga en cuenta que este caso solo se daría si los
+ ficheros <code>.htaccess</code> están activados en <code>/</code>, que
+ generalmente no es el caso.).</p>
+
+ <p>En el caso de las directivas <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>, en el contexto de
+ <code>.htaccess</code> estas expresiones regulares deben recompilarse con
+ cada solicitud a ese directorio, cuando en el contexto de configuración del
+ servidor solo se compilan una vez y se cachean. Adicionalmente, las reglas
+ en sí mismas son más complicadas, puesto que uno debe sortear las
+ restricciones que vienen acompañadas del contexto directorio y
+ <code>mod_rewrite</code>. Consulte la <a href="../rewrite/intro.html#htaccess">Guía de Rewrite</a> para un mayor
+ detalle sobre este tema.</p>
+
+ <p>La segunda consideración es de seguridad. Estará permitiendo que usuarios
+ modifiquen la configuración del servidor, lo cual puede dar lugar a cambios sobre los que usted no tendrá ningún control. Medite profundamente si debe
+ dar a sus usuarios ese privilegio. Además tenga en cuenta que dar a los usuarios menos privilegios de los que necesitan dará lugar a más peticiones
+ de soporte. Asegúrese de que le indica a sus usuarios claramente el nivel de privilegios que les está dando. Especificando exactamente cómo ha
+ configurado <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>, e invíteles
+ a revisar la documentación relacionada, lo cual le ahorrará
+ bastantes confusiones más adelante.</p>
+
+ <p>Tenga en cuenta que esto es equivalente por completo a poner un fichero
+ <code>.htaccess</code> en un directorio <code>/www/htdocs/example</code>
+ con una directiva, y poner la misma directiva en una sección
+ Directory <code><Directory "/www/htdocs/example"></code> en su
+ configuración principal del servidor:</p>
+
+ <p>Fichero <code>.htaccess</code> en <code>/www/htdocs/example</code>:</p>
+
+ <div class="example"><h3>Contenido de fichero .htaccess en
+ <code>/www/htdocs/example</code></h3><pre class="prettyprint lang-config">AddType text/example ".exm"</pre>
+</div>
+
+ <div class="example"><h3>Sección de su fichero <code>httpd.conf</code></h3><pre class="prettyprint lang-config"><Directory "/www/htdocs/example">
+ AddType text/example ".exm"
+</Directory></pre>
+</div>
+
+ <p>Aun así, poniendo ésta en el fichero de configuración dará como resultado
+ una menor pérdida de rendimiento, y como la configuración se carga una vez
+ cuando el httpd arranca, en lugar de cada vez que se solicita un fichero.</p>
+
+ <p>El uso de ficheros <code>.htaccess</code> puede desactivarse por completo
+ configurando la directiva <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>
+ a <code>none</code>:</p>
+
+ <pre class="prettyprint lang-config">AllowOverride None</pre>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="how" id="how">How directives are applied</a></h2>
+
+ <p>Las directivas de configuración que se encuentran en el fichero
+ <code>.htaccess</code> se aplican al directorio en el que el fichero
+ <code>.htaccess</code> se encuentra, y a todos sus subdirectorios. Sin
+ embargo, es importante recordar que puede haber otros ficheros
+ <code>.htaccess</code> en directorios previos. Las directivas se aplican en
+ el orden en el que se encuentran. Por lo tanto, un fichero
+ <code>.htaccess</code> puede sobrescribir directivas que se encuentran
+ en ficheros <code>.htaccess</code> que se encuentran en directorios previos
+ del árbol de directorios. Y estos, en cambio, pueden haber sobrescrito
+ directivas que se encontraban más arriba, o en el fichero principal de
+ configuración del servidor mismo.</p>
+
+ <p>Ejemplo:</p>
+
+ <p>En el directorio <code>/www/htdocs/example1</code> tenemos un fichero
+ <code>.htaccess</code> que contiene lo siguiente:</p>
+
+ <pre class="prettyprint lang-config">Options +ExecCGI</pre>
+
+
+ <p>(Nota: debe terner "<code>AllowOverride Options</code>" configurado para
+ permitir el uso de la directiva "<code class="directive"><a href="../mod/core.html#options">Options</a></code>" en ficheros
+ <code>.htaccess</code> files.)</p>
+
+ <p>En el directorio <code>/www/htdocs/example1/example2</code> tenemos un
+ fichero <code>.htaccess</code> que contiene:</p>
+
+ <pre class="prettyprint lang-config">Options Includes</pre>
+
+
+ <p>Por este segundo fichero <code>.htaccess</code>, en el directorio
+ <code>/www/htdocs/example1/example2</code>, la ejecución de CGI execution no
+ está permitida, porque solo se ha definido <code>Options Includes</code>,
+ que sobrescribe completamente una configuración previa que se pudiera haber
+ definido.</p>
+
+ <h3><a name="merge" id="merge">Incorporando el .htaccess en los ficheros de
+ configuración principal</a></h3>
+
+ <p>Como se ha comentado en la documentación en las <a href="../sections.html">Secciones de Configuración</a>, los ficheros
+ <code>.htaccess</code> pueden sobrescribir las secciones <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code> por el directorio
+ correspondiente, pero se sobrescribirán por otros tipos de secciones de
+ configuración de los ficheros de configuración principal. Este hecho se
+ puede usar para forzar ciertas configuraciones, incluso en presencia
+ de una configuración laxa de
+ <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code>. Por ejemplo, para
+ prevenir la ejecución de un script mientras se permite cualquier otra cosa
+ en <code>.htaccess</code> puede usar:</p>
+
+ <pre class="prettyprint lang-config"><Directory "/www/htdocs">
+ AllowOverride All
+</Directory>
+
+<Location "/">
+ Options +IncludesNoExec -ExecCGI
+</Location></pre>
+
+
+ <div class="note">Este ejemplo asume que su <code class="directive"><a href="../mod/core.html#documentroot">DocumentRoot</a></code> es <code>/www/htdocs</code>.</div>
+
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="auth" id="auth">Ejemplo de Autenticación</a></h2>
+
+ <p>Si saltó directamente a esta parte del documento para averiguar como
+ hacer la autenticación, es important que tenga en cuenta una cosa. Hay una
+ creencia errónea de que necesita usar ficheros <code>.htaccess</code> para
+ configurar autenticación con contraseña. Este no es el caso. Colocar las
+ directivas de autenticación en una sección
+ <code class="directive"><a href="../mod/core.html#directory"><Directory></a></code>, en su fichero
+ de configuración principal, es el método recomendado para configurar esto,
+ y los ficheros <code>.htaccess</code> deberían usarse solamente si no tiene
+ acceso al fichero de configuración principal del servidor. Vea <a href="#when">más arriba</a> una explicación de cuando debería y cuando no
+ debería usar ficheros <code>.htaccess</code>.</p>
+
+ <p>Dicho esto, si todavía cree que debe usar el fichero
+ <code>.htaccess</code>, podrá ver que una configuración como la que sigue
+ podría servirle.</p>
+
+ <p>Contenido del fichero <code>.htaccess</code>:</p>
+
+ <pre class="prettyprint lang-config">AuthType Basic
+AuthName "Password Required"
+AuthUserFile "/www/passwords/password.file"
+AuthGroupFile "/www/passwords/group.file"
+Require group admins</pre>
+
+
+ <p>Tenga en cuenta que <code>AllowOverride AuthConfig</code> debe estar
+ habilitado para que estas directivas tengan algún efecto.</p>
+
+ <p>Por favor vea el <a href="auth.html">tutorial de autenticación</a> para
+ una explicación más completa de la autenticación y la autorización.</p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="ssi" id="ssi">Ejemplo de Server Side Includes</a></h2>
+
+ <p>Otro uso común de ficheros <code>.htaccess</code> es activar Server Side
+ Includes para un directorio en particular. Esto puede hacerse
+ con las siguientes directivas de configuración, colocadas en un fichero
+ <code>.htaccess</code> y el directorio deseado:</p>
+
+ <pre class="prettyprint lang-config">Options +Includes
+AddType text/html "shtml"
+AddHandler server-parsed shtml</pre>
+
+
+ <p>Tenga en cuenta que <code>AllowOverride Options</code> y
+ <code>AllowOverride FileInfo</code> deben estar activadas para que estas
+ directivas tengan efecto.</p>
+
+ <p>Por favor vea el <a href="ssi.html">tutorial de SSI</a> para una
+ explicación más completa de server-side includes.</p>
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="rewrite" id="rewrite">Reglas de Rewrite en ficheros .htaccess</a></h2>
+ <p>Cuando use <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code> en
+ ficheros <code>.htaccess</code>, tenga en cuenta que el contexto
+ directorio cambia las cosas un poco. En concreto, las reglas son
+ relativas al directorio actual, en lugar de serlo de la petición de URI
+ solicitada originalmente.
+ Considere los siguientes ejemplos:</p>
+
+<pre class="prettyprint lang-config"># En httpd.conf
+RewriteRule "^/images/(.+)\.jpg" "/images/$1.png"
+
+# En .htaccess en el directorio raíz
+RewriteRule "^images/(.+)\.jpg" "images/$1.png"
+
+# En .htaccess en images/
+RewriteRule "^(.+)\.jpg" "$1.png"</pre>
+
+
+ <p>En un <code>.htaccess</code> en cualquier directorio del DocumentRoot, la
+ barra ("/") inicial se elimina del valor facilitado a <code class="directive"><a href="../mod/mod_rewrite.html#rewriterule">RewriteRule</a></code>, y en el subdirectorio
+ <code>images</code>, se elimina <code>/images/</code> también de este valor.
+ Así, su expresión regular necesita omitir también esa parte.</p>
+
+ <p>Consulte la <a href="../rewrite/">documentación de mod_rewrite</a> para
+ más detalles al usar <code>mod_rewrite</code>.</p>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="cgi" id="cgi">Ejemplo de CGI</a></h2>
+
+ <p>Finalmente, puede que quiera usar un fichero <code>.htaccess</code> para
+ permitir la ejecución de programas CGI en un directorio en particular. Esto
+ se puede implementar con la siguiente configuración:</p>
+
+ <pre class="prettyprint lang-config">Options +ExecCGI
+AddHandler cgi-script "cgi" "pl"</pre>
+
+
+ <p>Alternativamente, si quiere considerar como programas CGI todos los
+ ficheros de un directorio concreto, esto se puede conseguir con la siguiente
+ configuración:</p>
+
+ <pre class="prettyprint lang-config">Options +ExecCGI
+SetHandler cgi-script</pre>
+
+
+ <p>Tenga en cuenta que <code>AllowOverride Options</code> y
+ <code>AllowOverride FileInfo</code> deben estar ambas activadas para que
+ estas directivas tengan efecto.</p>
+
+ <p>Por favor vea el <a href="cgi.html">tutorial CGI</a> para mayor detalle
+ sobre programación y configuración de CGI.</p>
+
+</div><div class="top"><a href="#page-header"><img alt="top" src="../images/up.gif" /></a></div>
+<div class="section">
+<h2><a name="troubleshoot" id="troubleshoot">Resolución de problemas</a></h2>
+
+ <p>Cuando pone directivas en un fichero <code>.htaccess</code> y no obtiene
+ el efecto deseado hay una serie de cosas que pueden haber ido mal.</p>
+
+ <p>El problema más común es que <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride
+ </a></code> no está configurada para que sus directivas puedan surtir
+ efecto. Asegúrese de que no tiene <code>AllowOverride None</code>
+ configurado para el directorio en cuestión. Una buena forma de probar esto
+ es poner "basura" en su fichero <code>.htaccess</code> y recargar la página.
+ Si no se genera un error en el servidor, casi seguro que tiene configurado
+ <code>AllowOverride None</code>.</p>
+
+ <p>Si, por otro lado, obtiene errores de servidor al intentar acceder a
+ documentos, compruebe el log de errores de httpd. Seguramente le indiquen
+ que la directiva en uso en su fichero <code>.htaccess</code> no está
+ permitida.</p>
+
+ <div class="example"><p><code>
+ [Fri Sep 17 18:43:16 2010] [alert] [client 192.168.200.51] /var/www/html/.htaccess: DirectoryIndex not allowed here
+ </code></p></div>
+
+ <p>Esto indicará que o bien ha usado una directiva que no se permite nunca
+ en ficheros <code>.htaccess</code>, o que simplementa no tiene
+ <code class="directive"><a href="../mod/core.html#allowoverride">AllowOverride</a></code> configurado
+ a un nivel suficiente para la directiva que ha usado. Consulte la
+ documentación para esa directiva en particular para determinar cual es el
+ caso.</p>
+
+ <p>Alternativamente, puede que le indique que hay un error de sintaxis en
+ el uso de la propia directiva.</p>
+
+ <div class="example"><p><code>
+ [Sat Aug 09 16:22:34 2008] [alert] [client 192.168.200.51] /var/www/html/.htaccess: RewriteCond: bad flag delimiters
+ </code></p></div>
+
+ <p>En este caso, el mensaje de error debería ser específico para el error de
+ sintaxis concreto que ha cometido.</p>
+
+</div></div>
+<div class="bottomlang">
+<p><span>Idiomas disponibles: </span><a href="../en/howto/htaccess.html" hreflang="en" rel="alternate" title="English"> en </a> |
+<a href="../es/howto/htaccess.html" title="Español"> es </a> |
+<a href="../fr/howto/htaccess.html" hreflang="fr" rel="alternate" title="Français"> fr </a> |
+<a href="../ja/howto/htaccess.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
+<a href="../ko/howto/htaccess.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> |
+<a href="../pt-br/howto/htaccess.html" hreflang="pt-br" rel="alternate" title="Português (Brasil)"> pt-br </a></p>
+</div><div class="top"><a href="#page-header"><img src="../images/up.gif" alt="top" /></a></div><div class="section"><h2><a id="comments_section" name="comments_section">Comentarios</a></h2><div class="warning"><strong>Notice:</strong><br />This is not a Q&A section. Comments placed here should be pointed towards suggestions on improving the documentation or server, and may be removed again by our moderators if they are either implemented or considered invalid/off-topic. Questions on how to manage the Apache HTTP Server should be directed at either our IRC channel, #httpd, on Freenode, or sent to our <a href="http://httpd.apache.org/lists.html">mailing lists</a>.</div>
+<script type="text/javascript"><!--//--><![CDATA[//><!--
+var comments_shortname = 'httpd';
+var comments_identifier = 'http://httpd.apache.org/docs/2.4/howto/htaccess.html';
+(function(w, d) {
+ if (w.location.hostname.toLowerCase() == "httpd.apache.org") {
+ d.write('<div id="comments_thread"><\/div>');
+ var s = d.createElement('script');
+ s.type = 'text/javascript';
+ s.async = true;
+ s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier;
+ (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s);
+ }
+ else {
+ d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>');
+ }
+})(window, document);
+//--><!]]></script></div><div id="footer">
+<p class="apache">Copyright 2017 The Apache Software Foundation.<br />Licencia bajo los términos de <a href="http://www.apache.org/licenses/LICENSE-2.0">Apache License, Version 2.0</a>.</p>
+<p class="menu"><a href="../mod/">Módulos</a> | <a href="../mod/directives.html">Directivas</a> | <a href="http://wiki.apache.org/httpd/FAQ">Preguntas Frecuentes</a> | <a href="../glossary.html">Glosario</a> | <a href="../sitemap.html">Mapa del sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!--
+if (typeof(prettyPrint) !== 'undefined') {
+ prettyPrint();
+}
+//--><!]]></script>
+</body></html>
\ No newline at end of file
Added: httpd/httpd/branches/2.4.x/docs/manual/howto/htaccess.xml.es
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/howto/htaccess.xml.es?rev=1789828&view=auto
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/howto/htaccess.xml.es (added)
+++ httpd/httpd/branches/2.4.x/docs/manual/howto/htaccess.xml.es [utf-8] Sat Apr 1 17:29:47 2017
@@ -0,0 +1,475 @@
+<?xml version='1.0' encoding='UTF-8' ?>
+<!DOCTYPE manualpage SYSTEM "../style/manualpage.dtd">
+<?xml-stylesheet type="text/xsl" href="../style/manual.es.xsl"?>
+<!-- English Revision: 1741841 -->
+<!-- Spanish translation : Daniel Ferradal -->
+<!-- Reviewed by Luis Joaquin Gil de Bernab� Pfeiffer -->
+<!--
+ Licensed to the Apache Software Foundation (ASF) under one or more
+ contributor license agreements. See the NOTICE file distributed with
+ this work for additional information regarding copyright ownership.
+ The ASF licenses this file to You under the Apache License, Version 2.0
+ (the "License"); you may not use this file except in compliance with
+ the License. You may obtain a copy of the License at
+
+ http://www.apache.org/licenses/LICENSE-2.0
+
+ Unless required by applicable law or agreed to in writing, software
+ distributed under the License is distributed on an "AS IS" BASIS,
+ WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ See the License for the specific language governing permissions and
+ limitations under the License.
+-->
+
+<manualpage metafile="htaccess.xml.meta">
+<parentdocument href="./">How-To / Tutoriales</parentdocument>
+
+<title>Tutorial del Servidor Apache HTTP: Ficheros .htaccess</title>
+
+<summary>
+ <p>Los ficheros <code>.htaccess</code> facilitan una forma de realizar
+ cambios en la configuraci�n en contexto directorio.</p>
+</summary>
+
+<section id="related"><title>Ficheros .htaccess</title>
+ <related>
+ <modulelist>
+ <module>core</module>
+ <module>mod_authn_file</module>
+ <module>mod_authz_groupfile</module>
+ <module>mod_cgi</module>
+ <module>mod_include</module>
+ <module>mod_mime</module>
+ </modulelist>
+
+ <directivelist>
+ <directive module="core">AccessFileName</directive>
+ <directive module="core">AllowOverride</directive>
+ <directive module="core">Options</directive>
+ <directive module="mod_mime">AddHandler</directive>
+ <directive module="core">SetHandler</directive>
+ <directive module="mod_authn_core">AuthType</directive>
+ <directive module="mod_authn_core">AuthName</directive>
+ <directive module="mod_authn_file">AuthUserFile</directive>
+ <directive module="mod_authz_groupfile">AuthGroupFile</directive>
+ <directive module="mod_authz_core">Require</directive>
+ </directivelist>
+
+ </related>
+
+ <note>Deber�a evitar usar ficheros <code>.htaccess</code> completamente si
+ tiene acceso al fichero de configuraci�n principal de httpd. Usar ficheros
+ <code>.htaccess</code> ralentiza su servidor Apache http. Cualquier
+ directiva que pueda incluir en un fichero <code>.htaccess</code>
+ estar� mejor configurada dentro de una secci�n
+ <directive module="core">Directory</directive>, tendr� el mismo efecto y
+ mejor rendimiento.</note>
+</section>
+
+<section id="what">
+<title>Qu� son/C�mo usarlos</title>
+
+ <p>Los ficheros <code>.htaccess</code> (o "ficheros de configuraci�n
+ distribuida") facilitan una forma de realizar cambios en la configuraci�n
+ en contexto directorio. Un fichero, que contiene una o m�s directivas, se
+ coloca en un documento espec�fico de un directorio, y estas directivas
+ aplican a ese directorio y todos sus subdirectorios.</p>
+
+ <note><title>Nota:</title>
+ <p>Si quiere llamar a su fichero <code>.htaccess</code> de otra manera,
+ puede cambiar el nombre del fichero usando la directiva <directive
+ module="core">AccessFileName</directive>. Por ejemplo, si usted prefiere
+ llamar al fichero <code>.config</code>, entonces puede poner lo siguiente
+ en el fichero de configuraci�n de su servidor:</p>
+
+ <highlight language="config">
+AccessFileName ".config"
+ </highlight>
+ </note>
+
+ <p>Generalmente, los ficheros <code>.htaccess</code> usan la misma sint�xis
+ que los <a href="../configuring.html#syntax">ficheros de la configuraci�n
+ principal</a>. Lo que puede utilizar en estos ficheros lo determina la
+ directiva <directive module="core">AllowOverride</directive>. Esta directiva
+ especifica, en categor�as, qu� directivas tendr�n efecto si se encuentran en
+ un fichero <code>.htaccess</code>. Si se permite una directiva en un fichero
+ <code>.htaccess</code>, la documentaci�n para esa directiva contendr� una
+ secci�n Override, especificando qu� valor debe ir en
+ <directive module="core">AllowOverride</directive> para que se permita esa
+ directiva.</p>
+
+ <p>Por ejemplo, si busca en la documentaci�n la directiva <directive
+ module="core">AddDefaultCharset</directive>, encontrar� que se permite en
+ ficheros <code>.htaccess</code>. (Vea la l�nea de Contexto en el sumario de
+ la directiva.) La l�nea <a
+ href="../mod/directive-dict.html#Context">Override</a> muestra
+ <code>FileInfo</code>. De este modo, debe tener al menos
+ <code>AllowOverride FileInfo</code> para que esta directiva se aplique en
+ ficheros <code>.htaccess</code>.</p>
+
+ <example><title>Ejemplo:</title>
+ <table>
+ <tr>
+ <td><a
+ href="../mod/directive-dict.html#Context">Context:</a></td>
+ <td>server config, virtual host, directory, .htaccess</td>
+ </tr>
+
+ <tr>
+ <td><a
+ href="../mod/directive-dict.html#Override">Override:</a></td>
+ <td>FileInfo</td>
+ </tr>
+ </table>
+ </example>
+
+ <p>Si no est� seguro de cu�ndo, una directiva en concreto, se puede usar en un
+ fichero <code>.htaccess</code>, consulte la documentaci�n para esa directiva,
+ y compruebe la l�nea Context buscando ".htaccess".</p>
+ </section>
+
+ <section id="when"><title>Cuando (no) usar ficheros .htaccess</title>
+
+ <p>Generalmente, solo deber�a usar ficheros <code>.htaccess</code> cuando no
+ tiene acceso al fichero principal de configuraci�n del servidor. Hay, por
+ ejemplo, una creencia err�nea de que la autenticaci�n de usuario deber�a
+ hacerse siempre dentro de ficheros <code>.htaccess</code>, y, m�s recientemente, otra creencia err�nea de que las directivas de
+ <module>mod_rewrite</module> deben ir en ficheros <code>.htaccess</code>.
+ Esto sencillamente no es el caso. Puede poner las configuraciones de
+ autenticaci�n de usuario en la configuraci�n principal del servidor, y esto
+ es de hecho, el m�todo preferido de configurar Apache. Del mismo modo, las
+ directivas <code>mod_rewrite</code> funcionan mejor, en muchos sentidos, en
+ el fichero de configuraci�n principal del servidor.</p>
+
+ <p>Los ficheros <code>.htaccess</code> deber�an usarse cuando su proveedor
+ de contenidos le permite hacer modificaciones de configuraci�n
+ en contexto directorio, pero usted no tiene acceso de root en el servidor.
+ En el caso de que el administrador no est� dispuesto a hacer cambios
+ frecuentes en la configuraci�n, puede que sea necesario permitir a usuarios
+ individuales realizar estos cambios de configuraci�n en ficheros
+ <code>.htaccess</code> por ellos mismos. Lo cual ocurre a menudo, por
+ ejemplo, en casos donde los ISP est�n albergando m�ltiples sitios web de
+ usuario en una sola m�quina, y quieren que sus usuarios tengan la
+ posibilidad de modificar sus configuraciones.</p>
+
+ <p>Aun as�, generalmente, el uso de ficheros <code>.htaccess</code> deber�a
+ evitarse cuando sea posible. Cualquier configuraci�n que considerar�a poner
+ en un fichero <code>.htaccess</code>, puede usarse con la misma efectividad
+ en una secci�n <directive module="core"
+ type="section">Directory</directive> en el fichero de configuraci�n
+ del servidor.</p>
+
+ <p>Hay dos razones para evitar el uso de ficheros <code>.htaccess</code>.</p>
+
+ <p>La primera es el rendimiento. Cuando <directive
+ module="core">AllowOverride</directive>
+ est� configurado para permitir el uso de ficheros <code>.htaccess</code>,
+ httpd buscar� ficheros <code>.htaccess</code> en cada directorio. As�,
+ permitiendo ficheros <code>.htaccess</code> provoca una p�rdida de
+ rendimiento, �incluso aunque no los use! Adem�s, los ficheros
+ <code>.htaccess</code> se cargan cada vez que se solicita un documento.</p>
+
+ <p>Adem�s tenga en cuenta que httpd debe buscar ficheros
+ <code>.htaccess</code> en todos los directorios de mayor jerarqu�a,
+ para poder terner la lista completa de directivas que debe aplicar. (Vea
+ la secci�n sobre <a href="#how">C�mo se aplican las directivas</a>.) As�, si
+ se solicita un fichero de un directorio <code>/www/htdocs/example</code>,
+ httpd debe buscar los siguientes ficheros:</p>
+
+ <example>
+ /.htaccess<br />
+ /www/.htaccess<br />
+ /www/htdocs/.htaccess<br />
+ /www/htdocs/example/.htaccess
+ </example>
+
+ <p>De esta manera, por cada acceso a un fichero de ese directorio, hay 4
+ accesos adicionales al sistema de ficheros, incluso si ninguno de esos
+ ficheros est� presente. (Tenga en cuenta que este caso solo se dar�a si los
+ ficheros <code>.htaccess</code> est�n activados en <code>/</code>, que
+ generalmente no es el caso.).</p>
+
+ <p>En el caso de las directivas <directive
+ module="mod_rewrite">RewriteRule</directive>, en el contexto de
+ <code>.htaccess</code> estas expresiones regulares deben recompilarse con
+ cada solicitud a ese directorio, cuando en el contexto de configuraci�n del
+ servidor solo se compilan una vez y se cachean. Adicionalmente, las reglas
+ en s� mismas son m�s complicadas, puesto que uno debe sortear las
+ restricciones que vienen acompa�adas del contexto directorio y
+ <code>mod_rewrite</code>. Consulte la <a
+ href="../rewrite/intro.html#htaccess">Gu�a de Rewrite</a> para un mayor
+ detalle sobre este tema.</p>
+
+ <p>La segunda consideraci�n es de seguridad. Estar� permitiendo que usuarios
+ modifiquen la configuraci�n del servidor, lo cual puede dar lugar a cambios sobre los que usted no tendr� ning�n control. Medite profundamente si debe
+ dar a sus usuarios ese privilegio. Adem�s tenga en cuenta que dar a los usuarios menos privilegios de los que necesitan dar� lugar a m�s peticiones
+ de soporte. Aseg�rese de que le indica a sus usuarios claramente el nivel de privilegios que les est� dando. Especificando exactamente c�mo ha
+ configurado <directive module="core">AllowOverride</directive>, e inv�teles
+ a revisar la documentaci�n relacionada, lo cual le ahorrar�
+ bastantes confusiones m�s adelante.</p>
+
+ <p>Tenga en cuenta que esto es equivalente por completo a poner un fichero
+ <code>.htaccess</code> en un directorio <code>/www/htdocs/example</code>
+ con una directiva, y poner la misma directiva en una secci�n
+ Directory <code><Directory "/www/htdocs/example"></code> en su
+ configuraci�n principal del servidor:</p>
+
+ <p>Fichero <code>.htaccess</code> en <code>/www/htdocs/example</code>:</p>
+
+ <example><title>Contenido de fichero .htaccess en
+ <code>/www/htdocs/example</code></title>
+ <highlight language="config">
+AddType text/example ".exm"
+ </highlight>
+ </example>
+
+ <example><title>Secci�n de su fichero <code>httpd.conf</code></title>
+ <highlight language="config">
+<Directory "/www/htdocs/example">
+ AddType text/example ".exm"
+</Directory>
+ </highlight>
+ </example>
+
+ <p>Aun as�, poniendo �sta en el fichero de configuraci�n dar� como resultado
+ una menor p�rdida de rendimiento, y como la configuraci�n se carga una vez
+ cuando el httpd arranca, en lugar de cada vez que se solicita un fichero.</p>
+
+ <p>El uso de ficheros <code>.htaccess</code> puede desactivarse por completo
+ configurando la directiva <directive module="core">AllowOverride</directive>
+ a <code>none</code>:</p>
+
+ <highlight language="config">
+AllowOverride None
+ </highlight>
+</section>
+
+<section id="how"><title>How directives are applied</title>
+
+ <p>Las directivas de configuraci�n que se encuentran en el fichero
+ <code>.htaccess</code> se aplican al directorio en el que el fichero
+ <code>.htaccess</code> se encuentra, y a todos sus subdirectorios. Sin
+ embargo, es importante recordar que puede haber otros ficheros
+ <code>.htaccess</code> en directorios previos. Las directivas se aplican en
+ el orden en el que se encuentran. Por lo tanto, un fichero
+ <code>.htaccess</code> puede sobrescribir directivas que se encuentran
+ en ficheros <code>.htaccess</code> que se encuentran en directorios previos
+ del �rbol de directorios. Y estos, en cambio, pueden haber sobrescrito
+ directivas que se encontraban m�s arriba, o en el fichero principal de
+ configuraci�n del servidor mismo.</p>
+
+ <p>Ejemplo:</p>
+
+ <p>En el directorio <code>/www/htdocs/example1</code> tenemos un fichero
+ <code>.htaccess</code> que contiene lo siguiente:</p>
+
+ <highlight language="config">
+Options +ExecCGI
+ </highlight>
+
+ <p>(Nota: debe terner "<code>AllowOverride Options</code>" configurado para
+ permitir el uso de la directiva "<directive
+ module="core">Options</directive>" en ficheros
+ <code>.htaccess</code> files.)</p>
+
+ <p>En el directorio <code>/www/htdocs/example1/example2</code> tenemos un
+ fichero <code>.htaccess</code> que contiene:</p>
+
+ <highlight language="config">
+Options Includes
+ </highlight>
+
+ <p>Por este segundo fichero <code>.htaccess</code>, en el directorio
+ <code>/www/htdocs/example1/example2</code>, la ejecuci�n de CGI execution no
+ est� permitida, porque solo se ha definido <code>Options Includes</code>,
+ que sobrescribe completamente una configuraci�n previa que se pudiera haber
+ definido.</p>
+
+ <section id="merge"><title>Incorporando el .htaccess en los ficheros de
+ configuraci�n principal</title>
+
+ <p>Como se ha comentado en la documentaci�n en las <a
+ href="../sections.html">Secciones de Configuraci�n</a>, los ficheros
+ <code>.htaccess</code> pueden sobrescribir las secciones <directive
+ type="section" module="core">Directory</directive> por el directorio
+ correspondiente, pero se sobrescribir�n por otros tipos de secciones de
+ configuraci�n de los ficheros de configuraci�n principal. Este hecho se
+ puede usar para forzar ciertas configuraciones, incluso en presencia
+ de una configuraci�n laxa de
+ <directive module="core">AllowOverride</directive>. Por ejemplo, para
+ prevenir la ejecuci�n de un script mientras se permite cualquier otra cosa
+ en <code>.htaccess</code> puede usar:</p>
+
+ <highlight language="config">
+<Directory "/www/htdocs">
+ AllowOverride All
+</Directory>
+
+<Location "/">
+ Options +IncludesNoExec -ExecCGI
+</Location>
+ </highlight>
+
+ <note>Este ejemplo asume que su <directive
+ module="core">DocumentRoot</directive> es <code>/www/htdocs</code>.</note>
+</section>
+
+</section>
+
+<section id="auth"><title>Ejemplo de Autenticaci�n</title>
+
+ <p>Si salt� directamente a esta parte del documento para averiguar como
+ hacer la autenticaci�n, es important que tenga en cuenta una cosa. Hay una
+ creencia err�nea de que necesita usar ficheros <code>.htaccess</code> para
+ configurar autenticaci�n con contrase�a. Este no es el caso. Colocar las
+ directivas de autenticaci�n en una secci�n
+ <directive module="core" type="section">Directory</directive>, en su fichero
+ de configuraci�n principal, es el m�todo recomendado para configurar esto,
+ y los ficheros <code>.htaccess</code> deber�an usarse solamente si no tiene
+ acceso al fichero de configuraci�n principal del servidor. Vea <a
+ href="#when">m�s arriba</a> una explicaci�n de cuando deber�a y cuando no
+ deber�a usar ficheros <code>.htaccess</code>.</p>
+
+ <p>Dicho esto, si todav�a cree que debe usar el fichero
+ <code>.htaccess</code>, podr� ver que una configuraci�n como la que sigue
+ podr�a servirle.</p>
+
+ <p>Contenido del fichero <code>.htaccess</code>:</p>
+
+ <highlight language="config">
+AuthType Basic
+AuthName "Password Required"
+AuthUserFile "/www/passwords/password.file"
+AuthGroupFile "/www/passwords/group.file"
+Require group admins
+ </highlight>
+
+ <p>Tenga en cuenta que <code>AllowOverride AuthConfig</code> debe estar
+ habilitado para que estas directivas tengan alg�n efecto.</p>
+
+ <p>Por favor vea el <a href="auth.html">tutorial de autenticaci�n</a> para
+ una explicaci�n m�s completa de la autenticaci�n y la autorizaci�n.</p>
+</section>
+
+<section id="ssi"><title>Ejemplo de Server Side Includes</title>
+
+ <p>Otro uso com�n de ficheros <code>.htaccess</code> es activar Server Side
+ Includes para un directorio en particular. Esto puede hacerse
+ con las siguientes directivas de configuraci�n, colocadas en un fichero
+ <code>.htaccess</code> y el directorio deseado:</p>
+
+ <highlight language="config">
+Options +Includes
+AddType text/html "shtml"
+AddHandler server-parsed shtml
+ </highlight>
+
+ <p>Tenga en cuenta que <code>AllowOverride Options</code> y
+ <code>AllowOverride FileInfo</code> deben estar activadas para que estas
+ directivas tengan efecto.</p>
+
+ <p>Por favor vea el <a href="ssi.html">tutorial de SSI</a> para una
+ explicaci�n m�s completa de server-side includes.</p>
+</section>
+
+<section id="rewrite"><title>Reglas de Rewrite en ficheros .htaccess</title>
+ <p>Cuando use <directive module="mod_rewrite">RewriteRule</directive> en
+ ficheros <code>.htaccess</code>, tenga en cuenta que el contexto
+ directorio cambia las cosas un poco. En concreto, las reglas son
+ relativas al directorio actual, en lugar de serlo de la petici�n de URI
+ solicitada originalmente.
+ Considere los siguientes ejemplos:</p>
+
+<highlight language="config">
+# En httpd.conf
+RewriteRule "^/images/(.+)\.jpg" "/images/$1.png"
+
+# En .htaccess en el directorio ra�z
+RewriteRule "^images/(.+)\.jpg" "images/$1.png"
+
+# En .htaccess en images/
+RewriteRule "^(.+)\.jpg" "$1.png"
+</highlight>
+
+ <p>En un <code>.htaccess</code> en cualquier directorio del DocumentRoot, la
+ barra ("/") inicial se elimina del valor facilitado a <directive
+ module="mod_rewrite">RewriteRule</directive>, y en el subdirectorio
+ <code>images</code>, se elimina <code>/images/</code> tambi�n de este valor.
+ As�, su expresi�n regular necesita omitir tambi�n esa parte.</p>
+
+ <p>Consulte la <a href="../rewrite/">documentaci�n de mod_rewrite</a> para
+ m�s detalles al usar <code>mod_rewrite</code>.</p>
+
+</section>
+
+<section id="cgi"><title>Ejemplo de CGI</title>
+
+ <p>Finalmente, puede que quiera usar un fichero <code>.htaccess</code> para
+ permitir la ejecuci�n de programas CGI en un directorio en particular. Esto
+ se puede implementar con la siguiente configuraci�n:</p>
+
+ <highlight language="config">
+Options +ExecCGI
+AddHandler cgi-script "cgi" "pl"
+ </highlight>
+
+ <p>Alternativamente, si quiere considerar como programas CGI todos los
+ ficheros de un directorio concreto, esto se puede conseguir con la siguiente
+ configuraci�n:</p>
+
+ <highlight language="config">
+Options +ExecCGI
+SetHandler cgi-script
+ </highlight>
+
+ <p>Tenga en cuenta que <code>AllowOverride Options</code> y
+ <code>AllowOverride FileInfo</code> deben estar ambas activadas para que
+ estas directivas tengan efecto.</p>
+
+ <p>Por favor vea el <a href="cgi.html">tutorial CGI</a> para mayor detalle
+ sobre programaci�n y configuraci�n de CGI.</p>
+
+</section>
+
+<section id="troubleshoot"><title>Resoluci�n de problemas</title>
+
+ <p>Cuando pone directivas en un fichero <code>.htaccess</code> y no obtiene
+ el efecto deseado hay una serie de cosas que pueden haber ido mal.</p>
+
+ <p>El problema m�s com�n es que <directive module="core">AllowOverride
+ </directive> no est� configurada para que sus directivas puedan surtir
+ efecto. Aseg�rese de que no tiene <code>AllowOverride None</code>
+ configurado para el directorio en cuesti�n. Una buena forma de probar esto
+ es poner "basura" en su fichero <code>.htaccess</code> y recargar la p�gina.
+ Si no se genera un error en el servidor, casi seguro que tiene configurado
+ <code>AllowOverride None</code>.</p>
+
+ <p>Si, por otro lado, obtiene errores de servidor al intentar acceder a
+ documentos, compruebe el log de errores de httpd. Seguramente le indiquen
+ que la directiva en uso en su fichero <code>.htaccess</code> no est�
+ permitida.</p>
+
+ <example>
+ [Fri Sep 17 18:43:16 2010] [alert] [client 192.168.200.51] /var/www/html/.htaccess: DirectoryIndex not allowed here
+ </example>
+
+ <p>Esto indicar� que o bien ha usado una directiva que no se permite nunca
+ en ficheros <code>.htaccess</code>, o que simplementa no tiene
+ <directive module="core">AllowOverride</directive> configurado
+ a un nivel suficiente para la directiva que ha usado. Consulte la
+ documentaci�n para esa directiva en particular para determinar cual es el
+ caso.</p>
+
+ <p>Alternativamente, puede que le indique que hay un error de sintaxis en
+ el uso de la propia directiva.</p>
+
+ <example>
+ [Sat Aug 09 16:22:34 2008] [alert] [client 192.168.200.51] /var/www/html/.htaccess: RewriteCond: bad flag delimiters
+ </example>
+
+ <p>En este caso, el mensaje de error deber�a ser espec�fico para el error de
+ sintaxis concreto que ha cometido.</p>
+
+</section>
+
+</manualpage>
Modified: httpd/httpd/branches/2.4.x/docs/manual/howto/htaccess.xml.meta
URL: http://svn.apache.org/viewvc/httpd/httpd/branches/2.4.x/docs/manual/howto/htaccess.xml.meta?rev=1789828&r1=1789827&r2=1789828&view=diff
==============================================================================
--- httpd/httpd/branches/2.4.x/docs/manual/howto/htaccess.xml.meta (original)
+++ httpd/httpd/branches/2.4.x/docs/manual/howto/htaccess.xml.meta Sat Apr 1 17:29:47 2017
@@ -8,6 +8,7 @@
<variants>
<variant>en</variant>
+ <variant>es</variant>
<variant>fr</variant>
<variant outdated="yes">ja</variant>
<variant outdated="yes">ko</variant>