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" /><link rel="stylesheet" type="text/css" href="./style/css/prettify.css" />
  12 <script src="./style/scripts/prettify.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="./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.5 del Servidor HTTP Apache</p>
  19 <img alt="" src="./images/feather.gif" /></div>
  20 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
  21 <div id="path">
  22 <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>
  23 <div class="toplang">
  24 <p><span>Idiomas disponibles: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
  25 <a href="./es/custom-error.html" title="Español">&nbsp;es&nbsp;</a> |
  26 <a href="./fr/custom-error.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
  27 <a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
  28 <a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
  29 <a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</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></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 &lt;3-digit-code&gt; &lt;action&gt;
 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">&nbsp;en&nbsp;</a> |
 222 <a href="./es/custom-error.html" title="Español">&nbsp;es&nbsp;</a> |
 223 <a href="./fr/custom-error.html" hreflang="fr" rel="alternate" title="Français">&nbsp;fr&nbsp;</a> |
 224 <a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 225 <a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 226 <a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
 227 </div><div id="footer">
 228 <p class="apache">Copyright 2012 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>
 229 <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><script type="text/javascript">
 230     if (typeof(prettyPrint) !== undefined) {
 231         prettyPrint();
 232     }
 233 </script>
 234 </body></html>