В случае проблемы или ошибки Apache httpd можно настроить для выполнения одного из четырех действий:

1. вывести простое жестко закодированное сообщение об ошибке
2. вывести настроенное сообщение
3. внутреннее перенаправление на локальный URL-адрес для обработки проблемы/ошибки
4. перенаправить на внешний URL-адрес для обработки проблемы/ошибки

Первый параметр используется по умолчанию, а параметры 2–4 настраиваются с помощью директивы ErrorDocument , за которой следует код ответа HTTP и URL-адрес или сообщение. Apache httpd иногда предлагает дополнительную информацию о проблеме/ошибке.

Начиная с версии 2.4.13, внутри директивы можно использовать синтаксис выражения для создания динамических строк и URL-адресов.

URL-адреса могут начинаться с косой черты (/) для локальных веб-путей (относительно DocumentRoot ) или представлять собой полный URL-адрес, который может разрешить клиент. В качестве альтернативы может быть предоставлено сообщение для отображения в браузере. Обратите внимание, что решение о том, является ли параметр URL-адресом, путем или сообщением, выполняется до анализа любого выражения. Примеры:

ErrorDocument 500 http://example.com/cgi-bin/server-error.cgi
ErrorDocument 404 /errors/bad_urls.php
ErrorDocument 401 /subscription_info.html
ErrorDocument 403 "Sorry, can't allow you access today"
ErrorDocument 403 Forbidden!
ErrorDocument 403 /errors/forbidden.py?referrer=%{escape:%{HTTP_REFERER}}

Кроме того, это специальное значение default можно использовать для указания простого жестко заданного сообщения Apache httpd. Хотя в обычных обстоятельствах это не требуется, default он восстановит простое жестко закодированное сообщение Apache httpd для конфигураций, которые в противном случае унаследовали бы существующий файл ErrorDocument .

ErrorDocument 404 /cgi-bin/bad_urls.pl
<Directory "/web/docs">
 ErrorDocument 404 default
</Directory>

Обратите внимание, что когда вы указываете , ErrorDocument который указывает на удаленный URL-адрес (т. е. что-либо с методом, например, http перед ним), HTTP-сервер Apache отправит клиенту перенаправление, чтобы сообщить ему, где найти документ, даже если документ оказывается на одном сервере. Это имеет несколько последствий, наиболее важным из которых является то, что клиент не получит исходный код состояния ошибки, а вместо этого получит код состояния перенаправления. Это, в свою очередь, может сбить с толку веб-роботов и других клиентов, которые пытаются определить, действителен ли URL-адрес, используя код состояния. Кроме того, если вы используете удаленный URL-адрес в файле ErrorDocument 401 , клиент не будет знать, нужно ли запрашивать у пользователя пароль, поскольку он не получит код состояния 401. Следовательно, если вы используете ErrorDocument 401 директиву, то она должна ссылаться на локальный документ.

Microsoft Internet Explorer (MSIE) по умолчанию игнорирует сгенерированные сервером сообщения об ошибках, если они «слишком малы», и заменяет свои собственные «дружественные» сообщения об ошибках. Пороговое значение размера варьируется в зависимости от типа ошибки, но в целом, если вы сделаете документ с ошибкой больше 512 байт, MSIE покажет сгенерированную сервером ошибку, а не маскирует ее. Дополнительная информация доступна в статье Q294807 базы знаний Майкрософт.

Хотя большинство сообщений об ошибках можно переопределить, существуют определенные обстоятельства, при которых внутренние сообщения используются независимо от настройки ErrorDocument . В частности, если обнаружен искаженный запрос, нормальная обработка запроса будет немедленно остановлена и возвращено внутреннее сообщение об ошибке. Это необходимо для защиты от проблем безопасности, вызванных неправильными запросами.

Если вы используете mod_proxy, вы можете включить его ProxyErrorOverride , чтобы вы могли предоставлять настраиваемые сообщения об ошибках от имени ваших серверов Origin. Если вы не включите ProxyErrorOverride, Apache httpd не будет создавать пользовательские документы об ошибках для прокси-контента.

Смотрите также

• документация настраиваемых ответов