1<?xml version="1.0" encoding="ISO-8859-1"?> 2<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd"> 3<html xmlns="http://www.w3.org/1999/xhtml" lang="es" xml:lang="es"><head><!-- 4 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 5 This file is generated from xml source: DO NOT EDIT 6 XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX 7 --> 8<title>Respuestas de error personalizadas - Servidor HTTP Apache</title> 9<link href="/style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" /> 10<link href="/style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" /> 11<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" /> 12<script src="/style/scripts/prettify.js" type="text/javascript"> 13</script> 14 15<link href="/images/favicon.ico" rel="shortcut icon" /></head> 16<body id="manual-page"><div id="page-header"> 17<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 de este sitio web</a></p> 18<p class="apache">Versi�n 2.2 del Servidor HTTP Apache</p> 19<img alt="" src="/images/feather.gif" /></div> 20<div class="up"><a href="./"><img title="<-" alt="<-" src="/images/left.gif" /></a></div> 21<div id="path"> 22<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.2</a></div><div id="page-content"><div id="preamble"><h1>Respuestas de error personalizadas</h1> 23<div class="toplang"> 24<p><span>Idiomas disponibles: </span><a href="/en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> | 25<a href="/es/custom-error.html" title="Espa�ol"> es </a> | 26<a href="/ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 27<a href="/ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | 28<a href="/tr/custom-error.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p> 29</div> 30<div class="outofdate">Esta traducci�n podr�a estar 31 obsoleta. Consulte la versi�n en ingl�s de la 32 documentaci�n para comprobar si se han producido cambios 33 recientemente.</div> 34 35 <p>Apache ofrece la posibilidad de que los webmasters puedan 36 configurar las respuestas que muestra el servidor Apache cuando se 37 producen algunos errores o problemas.</p> 38 39 <p>Las respuestas personalizadas pueden definirse para activarse 40 en caso de que el servidor detecte un error o problema.</p> 41 42 <p>Si un script termina de forma anormal y se produce una respuesta 43 "500 Server Error", esta respuesta puede ser sustituida por otro 44 texto de su elecci�n o por una redirecci�n a otra URL 45 (local o externa).</p> 46 </div> 47<div id="quickview"><ul id="toc"><li><img alt="" src="/images/down.gif" /> <a href="#behavior">Comportamiento</a></li> 48<li><img alt="" src="/images/down.gif" /> <a href="#configuration">Configuraci�n</a></li> 49<li><img alt="" src="/images/down.gif" /> <a href="#custom">Mesajes de error personalizados y redirecciones</a></li> 50</ul><ul class="seealso"><li><a href="#comments_section">Comentarios</a></li></ul></div> 51<div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 52<div class="section"> 53<h2><a name="behavior" id="behavior">Comportamiento</a></h2> 54 55 56 <h3>Comportamiento anterior</h3> 57 58 59 <p>NCSA httpd 1.3 devolv�a mensajes antiguos del error o 60 problema encontrado que con frecuencia no ten�an 61 significado alguno para el usuario, y que no inclu�an en 62 los logs informaci�n que diera pistas sobre las causas de 63 lo sucedido.</p> 64 65 66 <h3>Comportamiento actual</h3> 67 68 69 <p>Se puede hacer que el servidor siga uno de los siguientes 70 comportamientos:</p> 71 72 <ol> 73 <li>Desplegar un texto diferente, en lugar de los mensajes de 74 la NCSA, o</li> 75 76 <li>redireccionar la petici�n a una URL local, o</li> 77 78 <li>redireccionar la petici�n a una URL externa.</li> 79 </ol> 80 81 <p>Redireccionar a otra URL puede resultar de utilidad, pero 82 solo si con ello se puede tambi�n pasar alguna 83 informaci�n que pueda explicar el error o problema y/o 84 registrarlo en el log correspondiente m�s claramente.</p> 85 86 <p>Para conseguir esto, Apache define ahora variables de entorno 87 similares a las de los CGI:</p> 88 89 <div class="example"><p><code> 90 REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/x-xbitmap, 91 image/jpeg<br /> 92 REDIRECT_HTTP_USER_AGENT=Mozilla/1.1b2 (X11; I; HP-UX A.09.05 93 9000/712)<br /> 94 REDIRECT_PATH=.:/bin:/usr/local/bin:/etc<br /> 95 REDIRECT_QUERY_STRING=<br /> 96 REDIRECT_REMOTE_ADDR=121.345.78.123<br /> 97 REDIRECT_REMOTE_HOST=ooh.ahhh.com<br /> 98 REDIRECT_SERVER_NAME=crash.bang.edu<br /> 99 REDIRECT_SERVER_PORT=80<br /> 100 REDIRECT_SERVER_SOFTWARE=Apache/0.8.15<br /> 101 REDIRECT_URL=/cgi-bin/buggy.pl 102 </code></p></div> 103 104 <p>Tenga en cuenta el prefijo <code>REDIRECT_</code>.</p> 105 106 <p>Al menos <code>REDIRECT_URL</code> y 107 <code>REDIRECT_QUERY_STRING</code> se pasar�n a la nueva 108 URL (asumiendo que es un cgi-script o un cgi-include). Las otras 109 variables existir�n solo si exist�an antes de aparecer 110 el error o problema. <strong>Ninguna</strong> de estas variables 111 se crear� si en la directiva <code class="directive"><a href="/mod/core.html#errordocument">ErrorDocument</a></code> ha especificado una 112 redirecci�n <em>externa</em> (cualquier cosa que empiece 113 por un nombre de esquema del tipo <code>http:</code>, incluso si 114 se refiere al mismo servidor).</p> 115 116 </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 117<div class="section"> 118<h2><a name="configuration" id="configuration">Configuraci�n</a></h2> 119 120 121 <p>El uso de <code class="directive"><a href="/mod/core.html#errordocument">ErrorDocument</a></code> 122 est� activado para los ficheros .htaccess cuando <code class="directive"><a href="/mod/core.html#allowoverride">AllowOverride</a></code> tiene el valor 123 adecuado.</p> 124 125 <p>Aqu� hay algunos ejemplos m�s...</p> 126 127 <div class="example"><p><code> 128 ErrorDocument 500 /cgi-bin/crash-recover <br /> 129 ErrorDocument 500 "Sorry, our script crashed. Oh dear" <br /> 130 ErrorDocument 500 http://xxx/ <br /> 131 ErrorDocument 404 /Lame_excuses/not_found.html <br /> 132 ErrorDocument 401 /Subscription/how_to_subscribe.html 133 </code></p></div> 134 135 <p>La sintaxis es,</p> 136 137 <div class="example"><p><code> 138 ErrorDocument <3-digit-code> <action> 139 </code></p></div> 140 141 <p>donde action puede ser,</p> 142 143 <ol> 144 <li>Texto a mostrar. Ponga antes del texto que quiere que se 145 muestre unas comillas ("). Lo que sea que siga a las comillas se 146 mostrar�. <em>Nota: las comillas (") no se 147 muestran.</em></li> 148 149 <li>Una URL local a la que se redireccionar� la 150 petici�n.</li> 151 152 <li>Una URL externa a la que se redireccionar� la 153 petici�n.</li> 154 </ol> 155 </div><div class="top"><a href="#page-header"><img alt="top" src="/images/up.gif" /></a></div> 156<div class="section"> 157<h2><a name="custom" id="custom">Mesajes de error personalizados y redirecciones</a></h2> 158 159 160 <p>El comportamiento de Apache en cuanto a las redirecciones ha 161 cambiado para que puedan usarse m�s variables de entorno con 162 los script/server-include.</p> 163 164 <h3>Antiguo comportamiento</h3> 165 166 167 <p>Las variables CGI est�ndar estaban disponibles para el 168 script al que se hac�a la redirecci�n. No se inclu�a 169 ninguna indicaci�n sobre la precedencia de la 170 redirecci�n.</p> 171 172 173 <h3>Nuevo comportamiento</h3> 174 175 176 <p>Un nuevo grupo de variables de entorno se inicializa para que 177 las use el script al que ha sido redireccionado. Cada 178 nueva variable tendr� el prefijo <code>REDIRECT_</code>. 179 Las variables de entorno <code>REDIRECT_</code> se crean a 180 partir de de las variables de entorno CGI que existen antes de 181 la redirecci�n, se les cambia el nombre 182 a�adi�ndoles el prefijo <code>REDIRECT_</code>, por 183 ejemplo, <code>HTTP_USER_AGENT</code> pasa a ser 184 <code>REDIRECT_HTTP_USER_AGENT</code>. Adem�s, para esas 185 nuevas variables, Apache definir� <code>REDIRECT_URL</code> 186 y <code>REDIRECT_STATUS</code> para ayudar al script a seguir su 187 origen. Tanto la URL original como la URL a la que es redirigida 188 la petici�n pueden almacenarse en los logs de acceso.</p> 189 190 <p>Si ErrorDocument especifica una redirecci�n local a un 191 script CGI, el script debe incluir una campo de cabeceraa 192 "<code>Status:</code>" en el resultado final para asegurar que 193 es posible hacer llegar al cliente de vuelta la condici�n 194 de error que lo provoc�. Por ejemplo, un script en Perl 195 para usar con ErrorDocument podr�a incluir lo 196 siguiente:</p> 197 198 <div class="example"><p><code> 199 ... <br /> 200 print "Content-type: text/html\n"; <br /> 201 printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; <br /> 202 ... 203 </code></p></div> 204 205 <p>Si el script tiene como fin tratar una determinada 206 condici�n de error, por ejemplo 207 <code>404 Not Found</code>, se pueden usar los 208 c�digos de error y textos espec�ficos en su lugar.</p> 209 210 <p>Tenga en cuenta que el script <em>debe</em> incluir un campo 211 de cabecera <code>Status:</code> apropiado (como 212 <code>302 Found</code>), si la respuesta contiene un campo de 213 cabecera <code>Location:</code> (para poder enviar una 214 redirecci�n que se interprete en el cliente). De otra 215 manera, la cabecera 216 <code>Location:</code> puede que no tenga efecto.</p> 217 218 </div></div> 219<div class="bottomlang"> 220<p><span>Idiomas disponibles: </span><a href="/en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> | 221<a href="/es/custom-error.html" title="Espa�ol"> es </a> | 222<a href="/ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> | 223<a href="/ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> | 224<a href="/tr/custom-error.html" hreflang="tr" rel="alternate" title="T�rk�e"> tr </a></p> 225</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> 226<script type="text/javascript"><!--//--><![CDATA[//><!-- 227var comments_shortname = 'httpd'; 228var comments_identifier = 'http://httpd.apache.org/docs/2.2/custom-error.html'; 229(function(w, d) { 230 if (w.location.hostname.toLowerCase() == "httpd.apache.org") { 231 d.write('<div id="comments_thread"><\/div>'); 232 var s = d.createElement('script'); 233 s.type = 'text/javascript'; 234 s.async = true; 235 s.src = 'https://comments.apache.org/show_comments.lua?site=' + comments_shortname + '&page=' + comments_identifier; 236 (d.getElementsByTagName('head')[0] || d.getElementsByTagName('body')[0]).appendChild(s); 237 } 238 else { 239 d.write('<div id="comments_thread">Comments are disabled for this page at the moment.<\/div>'); 240 } 241})(window, document); 242//--><!]]></script></div><div id="footer"> 243<p class="apache">Copyright 2013 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> 244<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 de este sitio web</a></p></div><script type="text/javascript"><!--//--><![CDATA[//><!-- 245if (typeof(prettyPrint) !== 'undefined') { 246 prettyPrint(); 247} 248//--><!]]></script> 249</body></html>