Как настроить Apache на использование пользовательских страниц ошибок

Узнайте, как настроить пользовательские страницы ошибок в Apache. Веб-сервер Apache предоставляет стандартный набор типовых страниц ошибок 404, 500 и других распространенных ошибок Apache.

Однако создание пользовательских страниц ошибок позволяет вам:

Продолжить свой брендинг на этих страницах
интегрировать их дизайн в оформление и стиль вашего сайта
направлять заблудившихся посетителей по назначению
Предоставлять страницы ошибок на языках, отличных от английского

Содержание

Требования
Создание пользовательской страницы ошибок
Настройка Apache на использование пользовательской страницы ошибок
Другие коды ошибок HTTP

Требования

Облачный сервер под управлением Linux (CentOS 7 или Ubuntu 14.04)
Установленный и запущенный Apache

Создание пользовательской страницы ошибок

Сначала вам нужно будет создать пользовательскую страницу ошибок. В целях тестирования мы создадим пример страницы ошибки для обработки 404 ошибки.

Используйте SSH для подключения к вашему серверу и перейдите в корень документа вашего сайта. Создайте новую страницу с именем my-404.html с помощью команды:

sudo nano my-404.html

Поместите в этот файл следующее:

<html>
<head>
<title>My Custom 404 Error Page</title>
</head>

<body>
<p>Whoops, page not found! Sorry about that.</p>

</body>
</html>

Сохраните и выйдите из файла.

Вы можете просмотреть файл, перейдя по ссылке «http://example.com/my-404.html», чтобы убедиться, что он отображается правильно.

Настройка Apache на использование пользовательской страницы ошибок

Чтобы указать Apache использовать пользовательскую страницу ошибок, вам нужно добавить директиву ErrorDocument. Синтаксис этой директивы следующий:

ErrorDocument 404 [path to file]

В данном примере, поскольку файл my-404.html находится в корне документа сайта, мы добавим директиву:

ErrorDocument 404 /my-404.html

Эта директива должна находиться внутри командного блока VirtualHost в главном конфигурационном файле Apache сайта.

По общему соглашению, этот файл конфигурации Apache обычно находится:

CentOS 7/etc/httpd/conf.d/example.com.conf
Ubuntu 14.04/etc/apache2/sites-available/example.com.conf

Примечание

Расположение и имя файла конфигурации Apache для сайта может отличаться в зависимости от того, как вы или администратор вашего сервера настроили хостинг.

Отредактируйте этот файл в выбранном вами редакторе, например, с помощью команды:

CentOS 7sudo nano /etc/httpd/conf.d/example.com.conf
Ubuntu 14.04sudo nano /etc/apache2/sites-available/example.com.conf

Прокрутите файл, пока не найдете командный блок VirtualHost, который будет выглядеть следующим образом:

<VirtualHost *:80>
ServerName example.com
    <Directory "/var/www/example.com/html">
    AllowOverride All
    </Directory>
</VirtualHost>

Добавьте ErrorDocument в командный блок VirtualHost, но не забудьте поместить его за пределами любых командных блоков Directory. Например:

<VirtualHost *:80>
ServerName example.com
ErrorDocument 404 /my-404.html
    <Directory "/var/www/example.com/html">
    AllowOverride All
    </Directory>
</VirtualHost>

Сохраните и выйдите из файла, затем перезапустите Apache, чтобы изменения вступили в силу:

CentOS 7sudo systemctl restart httpd
Ubuntu 14.04sudo services apache2 restart

Наконец, проверьте документ об ошибках, перейдя на недопустимый URL вашего сайта. Вместо этого вы будете перенаправлены на новую пользовательскую страницу 404.

Другие коды ошибок HTTP

Наиболее распространенной пользовательской страницей ошибки является страница 404. Однако вы можете захотеть создать пользовательские страницы ошибок и для других ошибок Apache.

Эти страницы могут быть настроены для любого кода ошибки 4xx или 5xx. Полный список этих кодов ошибок HTTP можно найти в Википедии.