UPD: теперь весь этот мусор ниже можно не читать, а просто скачать модуль и заняться действительно полезным делом ;)

UPD: и ещё он доступен в Marketplace: http://marketplace.1c-bitrix.ru/solutions/refreshlab.err404/

UPD: модуль обновился до версии 1.1.0. Теперь он поддерживает многосайтовость!

UPD: Я больше не занимаюсь Битриксом, модуль не развиваю и, вообще, статья устарела ((

404ая ошибка — это когда сервер не может найти запрошенную страницу. Такое может случиться из-за того, что пользователь неправильно набрал адрес в адресной строке браузера или нужную страницу удалили или куда-то переместили. Так или иначе, нужную страницу сервер показать не может, и об этом он должен сказать пользователю в понятной форме.

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

Дефолтный вариант

Самый простой вариант — это использовать то, что нам прямо из коробки предлагает битрикс. А предлагает он встраивать сообщение об ошибке прямо в шаблон страницы, которая по идее должна была загрузиться.

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

<?php
include_once($_SERVER['DOCUMENT_ROOT'].'/bitrix/modules/main/include/urlrewrite.php');

CHTTP::SetStatus('404 Not Found');
@define('ERROR_404', 'Y');

require($_SERVER['DOCUMENT_ROOT'].'/bitrix/header.php');

$APPLICATION->SetTitle('404 Not Found');

$APPLICATION->IncludeComponent(
  'bitrix:main.map',
  '.default',
  Array(
    'LEVEL' => '3',
    'COL_NUM' => '2',
    'SHOW_DESCRIPTION' => 'Y',
    'SET_TITLE' => 'Y',
    'CACHE_TIME' => '3600'
  )
);

require($_SERVER['DOCUMENT_ROOT'].'/bitrix/footer.php');
?>

Это код файла 404.php, размещённого в корне сайта. Он подключается тогда, когда возникла ошибка. В него можно написать все, что угодно. Нельзя только изменить окружающий дизайн, а именно этого мы и хотим. Едем дальше.

Переадресация

Впервые с проблемой отдельного шаблона для 404ой ошибки я столкнулся тогда, когда на сайте использовалось несколько шаблонов, и не в каждый из них можно было просто так вставить содержимое указанного выше файла. На мой вопрос «как задать отдельный шаблон для 404ой» техподдержка ответила буквально следующее:

1. В настройках сайта задайте для страницы /404.php свой шаблон сайта.
2. Внесите изменения в файл /404.php

   <?php
   include_once($_SERVER['DOCUMENT_ROOT'].'/bitrix/modules/main/include/urlrewrite.php');
   
   CHTTP::SetStatus('404 Not Found');
   @define('ERROR_404', 'Y');
   
   require($_SERVER['DOCUMENT_ROOT'].'/bitrix/header.php');
   
   if($APPLICATION->GetCurPage() != '/404.php')
     LocalRedirect('/404.php');
   
   $APPLICATION->SetTitle('404 Not Found');
   
   $APPLICATION->IncludeComponent(
     'bitrix:main.map',
     '.default',
     Array(
       'LEVEL' => '3',
       'COL_NUM' => '2',
       'SHOW_DESCRIPTION' => 'Y',
       'SET_TITLE' => 'Y',
       'CACHE_TIME' => '3600'
     )
   );
   
   require($_SERVER['DOCUMENT_ROOT'].'/bitrix/footer.php');
   ?>
   

То есть получается, что при возникновении ошибки пользователь редиректится на нужную нам страницу, для которой мы предварительно задали нужный шаблон. Способ волшебным образом решает нашу проблему, но создаёт новую: в адресной строке пользователь больше не видит адрес ошибочной страницы, теперь у него всегда отображается http://my_domain.ru/404.php. Некоторое время для меня это неудобство не было критичным и сейчас есть несколько сайтов, где эта ошибка так и выводится, например тут: http://www.boomcard.ru/takoi_stranicy_net (UPD: теперь на новой версии сайта тоже работает мой модуль). Однако прогресс не стоит на месте и нам пора двигаться дальше.

Страница без шаблона

Этот способ первым пришёл не в мою голову, а в голову Wet’а. Заключается он в том, мы вообще не станем подключать шаблон для нашей страницы. Это делается так. Вместо обычного подключения пролога

require($_SERVER['DOCUMENT_ROOT'].'/bitrix/header.php');

и эпилога

require($_SERVER['DOCUMENT_ROOT'].'/bitrix/footer.php');

мы подключим только их служебные части:

require($_SERVER['DOCUMENT_ROOT'].'/bitrix/modules/main/include/prolog_before.php');
require($_SERVER['DOCUMENT_ROOT'].'/bitrix/modules/main/include/epilog_after.php');

Таким образом, шаблон не подключится совсем. Побочный эффект этого метода — не работают отложенные функции, которые выводят данные в визуальную часть пролога, а это значит, что скрипты, стили и мета-теги нам придётся подключать вручную, зато в теле страницы по-прежнему можно вызывать компоненты и творить прочие безобразия. Таков принцип демонстрирует вот эта страница: http://ex-primo.com/takoi_stranicy_net. Вот теперь мы вплотную приблизились к моему любимому способу.

Отдельный шаблон

Помнишь, дорогой читатель, как мы во втором способе сделали для страницы ошибки отдельный шаблон? Тогда мы привязали его к странице с определённым адресом. Но что мешает привязать его по какому-нибудь другому параметру? Если присмотреться к коду страницы 404.php, то можно увидеть, что там определяется константа ERROR_404. Давайте к ней и привяжем шаблон! Для этого в настройках сайта укажем, что наш шаблон будет использоваться при выполнении такого условия PHP:

defined('ERROR_404') && ERROR_404 == 'Y'

Ву а ля! Теперь по любому адресу будет выводиться страница ошибки в её уникальном шаблоне. И шаблон, и саму страницу можно редактировать как обычно, использовать обычным образом компоненты и подключать скрипты. Именно так работает страница 404ой ошибки на сайте, работу над которым я недавно закончил:

.

Вот и сказке конец, а кто слушал — огурец :)

UPD. Шаблон для несуществующих секций и элементов.

В комментах было верно подмечено, что в некоторых случаях битрикс не может вывести нужный нам шаблон 404ой ошибки. Это случается, когда такую ошибку возвращает компонент, находящийся на странице. И действительно, код компонента срабатывает уже после выбора шаблона страницы, поэтому всё, что ему остаётся, это вывести сообщение об ошибке прямо в область контента. В итоге мы видим неказистую страницу с надписью «Элемент не найден» или «Раздел не найден».

Как убрать эту надпись, а заодно и весь окружающий дизайн, заменив его нашим красивым шаблоном? Нам поможет событие OnEpilog, которое возникает в самом конце выполнения страницы. В его обработчике мы очистим буфер, который был так старательно сгенерирован всеми компонентами, расположенными на странице, и заменим его страницей ошибки. Обработчик будет выглядеть так:

function handler404(){

  if(defined('ERROR_404') && ERROR_404 == 'Y'){

    $template = 'er404';

    global $APPLICATION;
    $APPLICATION->RestartBuffer();

    include $_SERVER['DOCUMENT_ROOT'].'/bitrix/templates/'.$template.'/header.php';
    include $_SERVER['DOCUMENT_ROOT'].'/404.php';
    include $_SERVER['DOCUMENT_ROOT'].'/bitrix/templates/'.$template.'/footer.php';

  }

}

Здесь мы сначала сбрасываем буфер, а потом вручную подключаем header нашего шаблона, файл ошибки и, наконец, footer шаблона.

Замечу, что этот способ будет работать для любых ошибок, при генерации которых устанавливается константа ERROR_404 в значение Y. Так что, если вы решили воспользоваться этим способом, то использовать предыдущий для обычных страниц уже нет необходимости.