mirror of
https://github.com/apache/httpd.git
synced 2025-05-28 13:41:30 +03:00
82d72756e6
git-svn-id: https://svn.apache.org/repos/asf/httpd/httpd/trunk@558862 13f79535-47bb-0310-9956-ffa450edef68
223 lines
11 KiB
JavaScript
223 lines
11 KiB
JavaScript
<?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><!--
|
|
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" />
|
|
<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
|
|
<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="./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>
|
|
<img alt="" src="./images/feather.gif" /></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.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> |
|
|
<a href="./es/custom-error.html" title="Español"> es </a> |
|
|
<a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
|
|
<a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
|
|
</div>
|
|
<div class="outofdate">Esta traducción podría estar
|
|
obsoleta. Consulte la versión en inglés de la
|
|
documentación para comprobar si se han producido cambios
|
|
recientemente.</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="#configuration">Configuración</a></li>
|
|
<li><img alt="" src="./images/down.gif" /> <a href="#custom">Mesajes de error personalizados y redirecciones</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="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_HTTP_ACCEPT=*/*, image/gif, image/x-xbitmap,
|
|
image/jpeg<br />
|
|
REDIRECT_HTTP_USER_AGENT=Mozilla/1.1b2 (X11; I; HP-UX A.09.05
|
|
9000/712)<br />
|
|
REDIRECT_PATH=.:/bin:/usr/local/bin:/etc<br />
|
|
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 />
|
|
REDIRECT_SERVER_SOFTWARE=Apache/0.8.15<br />
|
|
REDIRECT_URL=/cgi-bin/buggy.pl
|
|
</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><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
|
|
<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 /cgi-bin/crash-recover <br />
|
|
ErrorDocument 500 "Sorry, our script crashed. Oh dear" <br />
|
|
ErrorDocument 500 http://xxx/ <br />
|
|
ErrorDocument 404 /Lame_excuses/not_found.html <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><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
|
|
<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
|
|
los script/server-include.</p>
|
|
|
|
<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 />
|
|
print "Content-type: text/html\n"; <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> |
|
|
<a href="./es/custom-error.html" title="Español"> es </a> |
|
|
<a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> |
|
|
<a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a></p>
|
|
</div><div id="footer">
|
|
<p class="apache">Copyright 2006 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> |