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