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