Установка и настройка
Чистые URL Switch Pages на Apache
Проверка mod_rewrite, корня домена и запретов доступа к служебным каталогам. Как отличить ошибку маршрутизации от отсутствующей публикации.
На этой странице
Проверьте правильный корень
Правила .htaccess рассчитаны на установку в корень домена и Apache 2.4. Веб-сервер должен разрешать применяемые директивы, включая перезапись запросов. Если файлы открываются, а адрес раздела возвращает ошибку Apache, сначала проверьте корневой каталог и AllowOverride.
Адрес /examples/first-example должен передаваться CMS, а не искаться как физическая папка с таким именем. При этом существующие безопасные статические ресурсы должны отдаваться как CSS, JavaScript и изображения, а не превращаться в HTML главной.
Проверьте два разных ограничения
Перезапись маршрутов и запрет чтения исходников решают разные задачи. Папки inc, pages, templates, modules, tools, .local и SQL-файлы нельзя публиковать напрямую. Для uploads отдельно запрещается исполнение PHP и подобных файлов; доступ к защищённым медиа проходит через CMS.
Пример минимальной проверки: откройте опубликованный объект, случайный несуществующий URL и прямой путь к конфигурации. Первый должен работать, второй давать настоящий 404, третий — отказ. Статус 200 с пустым телом не доказывает корректную отдачу стилей.
Не исправляйте всё одним редиректом
Перенаправление любого неизвестного адреса на главную скрывает ошибки и создаёт нежелательные страницы для поисковых систем. Лучше различать отсутствие объекта, выключенный раздел и неверные серверные правила.
После изменения .htaccess проверяйте как публичные страницы, так и админку, загружаемые изображения и установщик новой копии. Держите прежнюю конфигурацию вне публичного доступа, чтобы при ошибке можно было восстановить именно правила сервера, не трогая содержимое базы.
Продолжить работу
Проверьте последовательность на отдельной копии сайта. Сопоставьте задачу с возможностями ядра. Другой материал этого раздела: Как обновлять ядро Switch Pages без потери данных.