docs/manual/custom-error.html.es - httpd - Git at Google

 <?xml version="1.0" encoding="ISO-8859-1"?>
 <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
 <html xmlns="http://www.w3.org/1999/xhtml" lang="es" xml:lang="es"><head><!--
         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
               This file is generated from xml source: DO NOT EDIT
         XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
       -->
 <title>Respuestas de error personalizadas - Servidor HTTP Apache</title>
 <link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
 <link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
 <link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
 <link href="./images/favicon.ico" rel="shortcut icon" /></head>
 <body id="manual-page"><div id="page-header">
 <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>
 <p class="apache">Versión 2.3 del Servidor HTTP Apache</p>
 <img alt="" src="./images/feather.gif" /></div>
 <div class="up"><a href="./"><img title="&lt;-" alt="&lt;-" src="./images/left.gif" /></a></div>
 <div id="path">
 <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>
 <div class="toplang">
 <p><span>Idiomas disponibles: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 <a href="./es/custom-error.html" title="Español">&nbsp;es&nbsp;</a> |
 <a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 <a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
 </div>
 <div class="outofdate">Esta traducción podría estar
             obsoleta. Consulte la versión en inglés de la
             documentación para comprobar si se han producido cambios
             recientemente.</div>

     <p>Apache ofrece la posibilidad de que los webmasters puedan
     configurar las respuestas que muestra el servidor Apache cuando se
     producen algunos errores o problemas.</p>

     <p>Las respuestas personalizadas pueden definirse para activarse
     en caso de que el servidor detecte un error o problema.</p>

     <p>Si un script termina de forma anormal y se produce una respuesta
     "500 Server Error", esta respuesta puede ser sustituida por otro
     texto de su elección o por una redirección a otra URL
     (local o externa).</p>
   </div>
 <div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#behavior">Comportamiento</a></li>
 <li><img alt="" src="./images/down.gif" /> <a href="#configuration">Configuración</a></li>
 <li><img alt="" src="./images/down.gif" /> <a href="#custom">Mesajes de error personalizados y redirecciones</a></li>
 </ul></div>
 <div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 <div class="section">
 <h2><a name="behavior" id="behavior">Comportamiento</a></h2>


     <h3>Comportamiento anterior</h3>


       <p>NCSA httpd 1.3 devolvía mensajes antiguos del error o
       problema encontrado que con frecuencia no tenían
       significado alguno para el usuario, y que no incluían en
       los logs información que diera pistas sobre las causas de
       lo sucedido.</p>


     <h3>Comportamiento actual</h3>


       <p>Se puede hacer que el servidor siga uno de los siguientes
       comportamientos:</p>

       <ol>
         <li>Desplegar un texto diferente, en lugar de los mensajes de
         la NCSA, o</li>

         <li>redireccionar la petición a una URL local, o</li>

         <li>redireccionar la petición a una URL externa.</li>
       </ol>

       <p>Redireccionar a otra URL puede resultar de utilidad, pero
       solo si con ello se puede también pasar alguna
       información que pueda explicar el error o problema y/o
       registrarlo en el log correspondiente más claramente.</p>

       <p>Para conseguir esto, Apache define ahora variables de entorno
       similares a las de los CGI:</p>

       <div class="example"><p><code>
         REDIRECT_HTTP_ACCEPT=*/*, image/gif, image/x-xbitmap,
             image/jpeg<br />
         REDIRECT_HTTP_USER_AGENT=Mozilla/1.1b2 (X11; I; HP-UX A.09.05
             9000/712)<br />
         REDIRECT_PATH=.:/bin:/usr/local/bin:/etc<br />
         REDIRECT_QUERY_STRING=<br />
         REDIRECT_REMOTE_ADDR=121.345.78.123<br />
         REDIRECT_REMOTE_HOST=ooh.ahhh.com<br />
         REDIRECT_SERVER_NAME=crash.bang.edu<br />
         REDIRECT_SERVER_PORT=80<br />
         REDIRECT_SERVER_SOFTWARE=Apache/0.8.15<br />
         REDIRECT_URL=/cgi-bin/buggy.pl
       </code></p></div>

       <p>Tenga en cuenta el prefijo <code>REDIRECT_</code>.</p>

       <p>Al menos <code>REDIRECT_URL</code> y
       <code>REDIRECT_QUERY_STRING</code> se pasarán a la nueva
       URL (asumiendo que es un cgi-script o un cgi-include). Las otras
       variables existirán solo si existían antes de aparecer
       el error o problema. <strong>Ninguna</strong> de estas variables
       se creará si en la directiva <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> ha especificado una
       redirección <em>externa</em> (cualquier cosa que empiece
       por un nombre de esquema del tipo <code>http:</code>, incluso si
       se refiere al mismo servidor).</p>

   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 <div class="section">
 <h2><a name="configuration" id="configuration">Configuración</a></h2>


     <p>El uso de <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>
     está activado para los ficheros .htaccess cuando <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> tiene el valor
     adecuado.</p>

     <p>Aquí hay algunos ejemplos más...</p>

     <div class="example"><p><code>
       ErrorDocument 500 /cgi-bin/crash-recover <br />
       ErrorDocument 500 "Sorry, our script crashed. Oh dear" <br />
       ErrorDocument 500 http://xxx/ <br />
       ErrorDocument 404 /Lame_excuses/not_found.html <br />
       ErrorDocument 401 /Subscription/how_to_subscribe.html
     </code></p></div>

     <p>La sintaxis es,</p>

     <div class="example"><p><code>
       ErrorDocument &lt;3-digit-code&gt; &lt;action&gt;
     </code></p></div>

     <p>donde action puede ser,</p>

     <ol>
       <li>Texto a mostrar. Ponga antes del texto que quiere que se
       muestre unas comillas ("). Lo que sea que siga a las comillas se
       mostrará. <em>Nota: las comillas (") no se
       muestran.</em></li>

       <li>Una URL local a la que se redireccionará la
       petición.</li>

       <li>Una URL externa a la que se redireccionará la
       petición.</li>
     </ol>
   </div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
 <div class="section">
 <h2><a name="custom" id="custom">Mesajes de error personalizados y redirecciones</a></h2>


     <p>El comportamiento de Apache en cuanto a las redirecciones ha
     cambiado para que puedan usarse más variables de entorno con
     los script/server-include.</p>

     <h3>Antiguo comportamiento</h3>


       <p>Las variables CGI estándar estaban disponibles para el
       script al que se hacía la redirección. No se incluía
       ninguna indicación sobre la precedencia de la
       redirección.</p>


     <h3>Nuevo comportamiento</h3>


       <p>Un nuevo grupo de variables de entorno se inicializa para que
       las use el script al que ha sido redireccionado. Cada
       nueva variable tendrá el prefijo <code>REDIRECT_</code>.
       Las variables de entorno <code>REDIRECT_</code> se crean a
       partir de de las variables de entorno CGI que existen antes de
       la redirección, se les cambia el nombre
       añadiéndoles el prefijo <code>REDIRECT_</code>, por
       ejemplo, <code>HTTP_USER_AGENT</code> pasa a ser
       <code>REDIRECT_HTTP_USER_AGENT</code>. Además, para esas
       nuevas variables, Apache definirá <code>REDIRECT_URL</code>
       y <code>REDIRECT_STATUS</code> para ayudar al script a seguir su
       origen. Tanto la URL original como la URL a la que es redirigida
       la petición pueden almacenarse en los logs de acceso.</p>

       <p>Si ErrorDocument especifica una redirección local a un
       script CGI, el script debe incluir una campo de cabeceraa
       "<code>Status:</code>" en el resultado final para asegurar que
       es posible hacer llegar al cliente de vuelta la condición
       de error que lo provocó. Por ejemplo, un script en Perl
       para usar con ErrorDocument podría incluir lo
       siguiente:</p>

       <div class="example"><p><code>
         ... <br />
         print  "Content-type: text/html\n"; <br />
         printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; <br />
         ...
       </code></p></div>

       <p>Si el script tiene como fin tratar una determinada
       condición de error, por ejemplo
       <code>404 Not Found</code>, se pueden usar los
       códigos de error y textos específicos en su lugar.</p>

       <p>Tenga en cuenta que el script <em>debe</em> incluir un campo
       de cabecera <code>Status:</code> apropiado (como
       <code>302 Found</code>), si la respuesta contiene un campo de
       cabecera <code>Location:</code> (para poder enviar una
       redirección que se interprete en el cliente). De otra
       manera, la cabecera
       <code>Location:</code> puede que no tenga efecto.</p>

   </div></div>
 <div class="bottomlang">
 <p><span>Idiomas disponibles: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English">&nbsp;en&nbsp;</a> |
 <a href="./es/custom-error.html" title="Español">&nbsp;es&nbsp;</a> |
 <a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese">&nbsp;ja&nbsp;</a> |
 <a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean">&nbsp;ko&nbsp;</a> |
 <a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe">&nbsp;tr&nbsp;</a></p>
 </div><div id="footer">
 <p class="apache">Copyright 2008 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>
 <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>
 </body></html>
	<?xml version="1.0" encoding="ISO-8859-1"?>
	<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Strict//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-strict.dtd">
	<html xmlns="http://www.w3.org/1999/xhtml" lang="es" xml:lang="es"><head><!--
	XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
	This file is generated from xml source: DO NOT EDIT
	XXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXXX
	-->
	<title>Respuestas de error personalizadas - Servidor HTTP Apache</title>
	<link href="./style/css/manual.css" rel="stylesheet" media="all" type="text/css" title="Main stylesheet" />
	<link href="./style/css/manual-loose-100pc.css" rel="alternate stylesheet" media="all" type="text/css" title="No Sidebar - Default font size" />
	<link href="./style/css/manual-print.css" rel="stylesheet" media="print" type="text/css" />
	<link href="./images/favicon.ico" rel="shortcut icon" /></head>
	<body id="manual-page"><div id="page-header">
	<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>
	<p class="apache">Versión 2.3 del Servidor HTTP Apache</p>
	<img alt="" src="./images/feather.gif" /></div>
	<div class="up"><a href="./"><img title="<-" alt="<-" src="./images/left.gif" /></a></div>
	<div id="path">
	<a href="http://www.apache.org/">Apache</a> > <a href="http://httpd.apache.org/">Servidor HTTP</a> > <a href="http://httpd.apache.org/docs/">Documentación</a> > <a href="./">Versión 2.3</a></div><div id="page-content"><div id="preamble"><h1>Respuestas de error personalizadas</h1>
	<div class="toplang">
	<p><span>Idiomas disponibles: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> \|
	<a href="./es/custom-error.html" title="Español"> es </a> \|
	<a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> \|
	<a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> \|
	<a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
	</div>
	<div class="outofdate">Esta traducción podría estar
	obsoleta. Consulte la versión en inglés de la
	documentación para comprobar si se han producido cambios
	recientemente.</div>

	<p>Apache ofrece la posibilidad de que los webmasters puedan
	configurar las respuestas que muestra el servidor Apache cuando se
	producen algunos errores o problemas.</p>

	<p>Las respuestas personalizadas pueden definirse para activarse
	en caso de que el servidor detecte un error o problema.</p>

	<p>Si un script termina de forma anormal y se produce una respuesta
	"500 Server Error", esta respuesta puede ser sustituida por otro
	texto de su elección o por una redirección a otra URL
	(local o externa).</p>
	</div>
	<div id="quickview"><ul id="toc"><li><img alt="" src="./images/down.gif" /> <a href="#behavior">Comportamiento</a></li>
	<li><img alt="" src="./images/down.gif" /> <a href="#configuration">Configuración</a></li>
	<li><img alt="" src="./images/down.gif" /> <a href="#custom">Mesajes de error personalizados y redirecciones</a></li>
	</ul></div>
	<div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
	<div class="section">
	<h2><a name="behavior" id="behavior">Comportamiento</a></h2>


	<h3>Comportamiento anterior</h3>


	<p>NCSA httpd 1.3 devolvía mensajes antiguos del error o
	problema encontrado que con frecuencia no tenían
	significado alguno para el usuario, y que no incluían en
	los logs información que diera pistas sobre las causas de
	lo sucedido.</p>


	<h3>Comportamiento actual</h3>


	<p>Se puede hacer que el servidor siga uno de los siguientes
	comportamientos:</p>

	<ol>
	<li>Desplegar un texto diferente, en lugar de los mensajes de
	la NCSA, o</li>

	<li>redireccionar la petición a una URL local, o</li>

	<li>redireccionar la petición a una URL externa.</li>
	</ol>

	<p>Redireccionar a otra URL puede resultar de utilidad, pero
	solo si con ello se puede también pasar alguna
	información que pueda explicar el error o problema y/o
	registrarlo en el log correspondiente más claramente.</p>

	<p>Para conseguir esto, Apache define ahora variables de entorno
	similares a las de los CGI:</p>

	<div class="example"><p><code>
	REDIRECT_HTTP_ACCEPT=/, image/gif, image/x-xbitmap,
	image/jpeg<br />
	REDIRECT_HTTP_USER_AGENT=Mozilla/1.1b2 (X11; I; HP-UX A.09.05
	9000/712)<br />
	REDIRECT_PATH=.:/bin:/usr/local/bin:/etc<br />
	REDIRECT_QUERY_STRING=<br />
	REDIRECT_REMOTE_ADDR=121.345.78.123<br />
	REDIRECT_REMOTE_HOST=ooh.ahhh.com<br />
	REDIRECT_SERVER_NAME=crash.bang.edu<br />
	REDIRECT_SERVER_PORT=80<br />
	REDIRECT_SERVER_SOFTWARE=Apache/0.8.15<br />
	REDIRECT_URL=/cgi-bin/buggy.pl
	</code></p></div>

	<p>Tenga en cuenta el prefijo <code>REDIRECT_</code>.</p>

	<p>Al menos <code>REDIRECT_URL</code> y
	<code>REDIRECT_QUERY_STRING</code> se pasarán a la nueva
	URL (asumiendo que es un cgi-script o un cgi-include). Las otras
	variables existirán solo si existían antes de aparecer
	el error o problema. <strong>Ninguna</strong> de estas variables
	se creará si en la directiva <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code> ha especificado una
	redirección <em>externa</em> (cualquier cosa que empiece
	por un nombre de esquema del tipo <code>http:</code>, incluso si
	se refiere al mismo servidor).</p>

	</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
	<div class="section">
	<h2><a name="configuration" id="configuration">Configuración</a></h2>


	<p>El uso de <code class="directive"><a href="./mod/core.html#errordocument">ErrorDocument</a></code>
	está activado para los ficheros .htaccess cuando <code class="directive"><a href="./mod/core.html#allowoverride">AllowOverride</a></code> tiene el valor
	adecuado.</p>

	<p>Aquí hay algunos ejemplos más...</p>

	<div class="example"><p><code>
	ErrorDocument 500 /cgi-bin/crash-recover <br />
	ErrorDocument 500 "Sorry, our script crashed. Oh dear" <br />
	ErrorDocument 500 http://xxx/ <br />
	ErrorDocument 404 /Lame_excuses/not_found.html <br />
	ErrorDocument 401 /Subscription/how_to_subscribe.html
	</code></p></div>

	<p>La sintaxis es,</p>

	<div class="example"><p><code>
	ErrorDocument <3-digit-code> <action>
	</code></p></div>

	<p>donde action puede ser,</p>

	<ol>
	<li>Texto a mostrar. Ponga antes del texto que quiere que se
	muestre unas comillas ("). Lo que sea que siga a las comillas se
	mostrará. <em>Nota: las comillas (") no se
	muestran.</em></li>

	<li>Una URL local a la que se redireccionará la
	petición.</li>

	<li>Una URL externa a la que se redireccionará la
	petición.</li>
	</ol>
	</div><div class="top"><a href="#page-header"><img alt="top" src="./images/up.gif" /></a></div>
	<div class="section">
	<h2><a name="custom" id="custom">Mesajes de error personalizados y redirecciones</a></h2>


	<p>El comportamiento de Apache en cuanto a las redirecciones ha
	cambiado para que puedan usarse más variables de entorno con
	los script/server-include.</p>

	<h3>Antiguo comportamiento</h3>


	<p>Las variables CGI estándar estaban disponibles para el
	script al que se hacía la redirección. No se incluía
	ninguna indicación sobre la precedencia de la
	redirección.</p>


	<h3>Nuevo comportamiento</h3>


	<p>Un nuevo grupo de variables de entorno se inicializa para que
	las use el script al que ha sido redireccionado. Cada
	nueva variable tendrá el prefijo <code>REDIRECT_</code>.
	Las variables de entorno <code>REDIRECT_</code> se crean a
	partir de de las variables de entorno CGI que existen antes de
	la redirección, se les cambia el nombre
	añadiéndoles el prefijo <code>REDIRECT_</code>, por
	ejemplo, <code>HTTP_USER_AGENT</code> pasa a ser
	<code>REDIRECT_HTTP_USER_AGENT</code>. Además, para esas
	nuevas variables, Apache definirá <code>REDIRECT_URL</code>
	y <code>REDIRECT_STATUS</code> para ayudar al script a seguir su
	origen. Tanto la URL original como la URL a la que es redirigida
	la petición pueden almacenarse en los logs de acceso.</p>

	<p>Si ErrorDocument especifica una redirección local a un
	script CGI, el script debe incluir una campo de cabeceraa
	"<code>Status:</code>" en el resultado final para asegurar que
	es posible hacer llegar al cliente de vuelta la condición
	de error que lo provocó. Por ejemplo, un script en Perl
	para usar con ErrorDocument podría incluir lo
	siguiente:</p>

	<div class="example"><p><code>
	... <br />
	print "Content-type: text/html\n"; <br />
	printf "Status: %s Condition Intercepted\n", $ENV{"REDIRECT_STATUS"}; <br />
	...
	</code></p></div>

	<p>Si el script tiene como fin tratar una determinada
	condición de error, por ejemplo
	<code>404 Not Found</code>, se pueden usar los
	códigos de error y textos específicos en su lugar.</p>

	<p>Tenga en cuenta que el script <em>debe</em> incluir un campo
	de cabecera <code>Status:</code> apropiado (como
	<code>302 Found</code>), si la respuesta contiene un campo de
	cabecera <code>Location:</code> (para poder enviar una
	redirección que se interprete en el cliente). De otra
	manera, la cabecera
	<code>Location:</code> puede que no tenga efecto.</p>

	</div></div>
	<div class="bottomlang">
	<p><span>Idiomas disponibles: </span><a href="./en/custom-error.html" hreflang="en" rel="alternate" title="English"> en </a> \|
	<a href="./es/custom-error.html" title="Español"> es </a> \|
	<a href="./ja/custom-error.html" hreflang="ja" rel="alternate" title="Japanese"> ja </a> \|
	<a href="./ko/custom-error.html" hreflang="ko" rel="alternate" title="Korean"> ko </a> \|
	<a href="./tr/custom-error.html" hreflang="tr" rel="alternate" title="Türkçe"> tr </a></p>
	</div><div id="footer">
	<p class="apache">Copyright 2008 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>
	<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>
	</body></html>