1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
|
<?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.0 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.0</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="./fr/custom-error.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </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>
<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="./fr/custom-error.html" hreflang="fr" rel="alternate" title="Fran�ais"> fr </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 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>
<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>
|
