Respuestas de error personalizadas

Comportamiento

Comportamiento anterior

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.

Comportamiento actual

Se puede hacer que el servidor siga uno de los siguientes comportamientos:

1. Desplegar un texto diferente, en lugar de los mensajes de la NCSA, o
2. redireccionar la petici�n a una URL local, o
3. redireccionar la petici�n a una URL externa.

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.

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

Tenga en cuenta el prefijo REDIRECT_.

Al menos REDIRECT_URL y REDIRECT_QUERY_STRING 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. Ninguna de estas variables se crear� si en la directiva ErrorDocument ha especificado una redirecci�n externa (cualquier cosa que empiece por un nombre de esquema del tipo http:, incluso si se refiere al mismo servidor).

Configuraci�n

El uso de ErrorDocument est� activado para los ficheros .htaccess cuando AllowOverride tiene el valor adecuado.

Aqu� hay algunos ejemplos m�s...

La sintaxis es,

donde action puede ser,

1. Texto a mostrar. Ponga antes del texto que quiere que se muestre unas comillas ("). Lo que sea que siga a las comillas se mostrar�. Nota: las comillas (") no se muestran.
2. Una URL local a la que se redireccionar� la petici�n.
3. Una URL externa a la que se redireccionar� la petici�n.

Mesajes de error personalizados y redirecciones

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.

Antiguo comportamiento

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.

Nuevo comportamiento

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 REDIRECT_. Las variables de entorno REDIRECT_ 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 REDIRECT_, por ejemplo, HTTP_USER_AGENT pasa a ser REDIRECT_HTTP_USER_AGENT. Adem�s, para esas nuevas variables, Apache definir� REDIRECT_URL y REDIRECT_STATUS 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.

Si ErrorDocument especifica una redirecci�n local a un script CGI, el script debe incluir una campo de cabeceraa "Status:" 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:

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

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