granicus.if.org Git - apache/blob - docs/manual/custom-error.html.es

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