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