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