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