custom-error.html.es revision 190240988946204427a80158f9533b7fc77ce4ad
<?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">
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
This file is generated from xml source: DO NOT EDIT
XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
-->
<title>Respuestas de error personalizadas - Servidor HTTP Apache</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" />
<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="/faq/">Preguntas Frecuentes</a> | <a href="/glossary.html">Glosario</a> | <a href="/sitemap.html">Mapa de este sitio web</a></p>
<p class="apache">Versi�n 2.3 del Servidor HTTP Apache</p>
<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.3</a></div><div id="page-content"><div id="preamble"><h1>Respuestas de error personalizadas</h1>
<div class="toplang">
<p><span>Idiomas disponibles: </span><a href="/en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> |
</div>
<p>Apache ofrece la posibilidad de que los webmasters puedan
configurar las respuestas que muestra el servidor Apache cuando se
producen algunos errores o problemas.</p>
<p>Las respuestas personalizadas pueden definirse para activarse
en caso de que el servidor detecte un error o problema.</p>
<p>Si un script termina de forma anormal y se produce una respuesta
"500 Server Error", esta respuesta puede ser sustituida por otro
texto de su elecci�n o por una redirecci�n a otra URL
(local o externa).</p>
</div>
<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#behavior">Comportamiento</a></li>
<li><img alt="" src="/images/down.gif" /> <a href="#custom">Mesajes de error personalizados y redirecciones</a></li>
</ul></div>
<div class="section">
<h2><a name="behavior" id="behavior">Comportamiento</a></h2>
<h3>Comportamiento anterior</h3>
<p>NCSA httpd 1.3 devolv�a mensajes antiguos del error o
problema encontrado que con frecuencia no ten�an
significado alguno para el usuario, y que no inclu�an en
los logs informaci�n que diera pistas sobre las causas de
lo sucedido.</p>
<h3>Comportamiento actual</h3>
<p>Se puede hacer que el servidor siga uno de los siguientes
comportamientos:</p>
<ol>
<li>Desplegar un texto diferente, en lugar de los mensajes de
la NCSA, o</li>
<li>redireccionar la petici�n a una URL local, o</li>
<li>redireccionar la petici�n a una URL externa.</li>
</ol>
<p>Redireccionar a otra URL puede resultar de utilidad, pero
solo si con ello se puede tambi�n pasar alguna
informaci�n que pueda explicar el error o problema y/o
registrarlo en el log correspondiente m�s claramente.</p>
<p>Para conseguir esto, Apache define ahora variables de entorno
similares a las de los CGI:</p>
<div class="example"><p><code>
REDIRECT_QUERY_STRING=<br />
REDIRECT_REMOTE_ADDR=121.345.78.123<br />
REDIRECT_REMOTE_HOST=ooh.ahhh.com<br />
REDIRECT_SERVER_NAME=crash.bang.edu<br />
REDIRECT_SERVER_PORT=80<br />
</code></p></div>
<p>Tenga en cuenta el prefijo <code>REDIRECT_</code>.</p>
<p>Al menos <code>REDIRECT_URL</code> y
<code>REDIRECT_QUERY_STRING</code> se pasar�n a la nueva
URL (asumiendo que es un cgi-script o un cgi-include). Las otras
variables existir�n solo si exist�an antes de aparecer
el error o problema. <strong>Ninguna</strong> de estas variables
se crear� si en la directiva <code class="directive"><a href="/mod/core.html#errordocument">ErrorDocument</a></code> ha especificado una
redirecci�n <em>externa</em> (cualquier cosa que empiece
por un nombre de esquema del tipo <code>http:</code>, incluso si
se refiere al mismo servidor).</p>
<div class="section">
<h2><a name="configuration" id="configuration">Configuraci�n</a></h2>
<p>El uso de <code class="directive"><a href="/mod/core.html#errordocument">ErrorDocument</a></code>
est� activado para los ficheros .htaccess cuando <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code> tiene el valor
adecuado.</p>
<p>Aqu� hay algunos ejemplos m�s...</p>
<div class="example"><p><code>
ErrorDocument 500 "Sorry, our script crashed. Oh dear" <br />
ErrorDocument 500 http://xxx/ <br />
ErrorDocument 401 /Subscription/how_to_subscribe.html
</code></p></div>
<p>La sintaxis es,</p>
<div class="example"><p><code>
ErrorDocument <3-digit-code> <action>
</code></p></div>
<p>donde action puede ser,</p>
<ol>
<li>Texto a mostrar. Ponga antes del texto que quiere que se
muestre unas comillas ("). Lo que sea que siga a las comillas se
mostrar�. <em>Nota: las comillas (") no se
muestran.</em></li>
<li>Una URL local a la que se redireccionar� la
petici�n.</li>
<li>Una URL externa a la que se redireccionar� la
petici�n.</li>
</ol>
<div class="section">
<h2><a name="custom" id="custom">Mesajes de error personalizados y redirecciones</a></h2>
<p>El comportamiento de Apache en cuanto a las redirecciones ha
cambiado para que puedan usarse m�s variables de entorno con
<h3>Antiguo comportamiento</h3>
<p>Las variables CGI est�ndar estaban disponibles para el
script al que se hac�a la redirecci�n. No se inclu�a
ninguna indicaci�n sobre la precedencia de la
redirecci�n.</p>
<h3>Nuevo comportamiento</h3>
<p>Un nuevo grupo de variables de entorno se inicializa para que
las use el script al que ha sido redireccionado. Cada
nueva variable tendr� el prefijo <code>REDIRECT_</code>.
Las variables de entorno <code>REDIRECT_</code> se crean a
partir de de las variables de entorno CGI que existen antes de
la redirecci�n, se les cambia el nombre
a�adi�ndoles el prefijo <code>REDIRECT_</code>, por
ejemplo, <code>HTTP_USER_AGENT</code> pasa a ser
<code>REDIRECT_HTTP_USER_AGENT</code>. Adem�s, para esas
nuevas variables, Apache definir� <code>REDIRECT_URL</code>
y <code>REDIRECT_STATUS</code> para ayudar al script a seguir su
origen. Tanto la URL original como la URL a la que es redirigida
la petici�n pueden almacenarse en los logs de acceso.</p>
<p>Si ErrorDocument especifica una redirecci�n local a un
script CGI, el script debe incluir una campo de cabeceraa
"<code>Status:</code>" en el resultado final para asegurar que
es posible hacer llegar al cliente de vuelta la condici�n
de error que lo provoc�. Por ejemplo, un script en Perl
para usar con ErrorDocument podr�a incluir lo
siguiente:</p>
<div class="example"><p><code>
... <br />
printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; <br />
...
</code></p></div>
<p>Si el script tiene como fin tratar una determinada
condici�n de error, por ejemplo
<code>404 Not Found</code>, se pueden usar los
c�digos de error y textos espec�ficos en su lugar.</p>
<p>Tenga en cuenta que el script <em>debe</em> incluir un campo
de cabecera <code>Status:</code> apropiado (como
<code>302 Found</code>), si la respuesta contiene un campo de
cabecera <code>Location:</code> (para poder enviar una
redirecci�n que se interprete en el cliente). De otra
manera, la cabecera
<code>Location:</code> puede que no tenga efecto.</p>
</div></div>
<div class="bottomlang">
<p><span>Idiomas disponibles: </span><a href="/en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> |
</div><div id="footer">
<p class="apache">Copyright 2011 The Apache Software Foundation.<br />Licencia bajo los t�rminos de la <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="/faq/">Preguntas Frecuentes</a> | <a href="/glossary.html">Glosario</a> | <a href="/sitemap.html">Mapa de este sitio web</a></p></div>
</body></html>