Миграция Joomla 3 на 4 и 5: ошибки и решения

Миграция с Joomla 3 на 4 и 5 — это не обычное обновление пакета. Сайт может потерять шаблон, меню, формы и данные расширений, если начать с неподдерживаемой версии PHP или нажать «Обновить» до проверки совместимости. Безопасный маршрут обычно выглядит так: Joomla 3.10, затем Joomla 4.4 и только после этого Joomla 5. На тестовой копии небольшой сайт можно перенести за несколько часов, но подготовка расширений и проверка магазина часто занимают несколько дней.

Сначала выберите маршрут миграции

Joomla 3 и Joomla 4 отличаются не только интерфейсом администратора. В Joomla 4 изменились требования к PHP, шаблонам, структуре расширений и части API. Поэтому прямой переход с ранней Joomla 3 на Joomla 5 — плохая отправная точка: вы теряете промежуточные проверки и усложняете поиск причины ошибки.

Для сохранения существующей структуры выбирайте поэтапную миграцию. Новая установка оправдана, если старый сайт уже требует переделки: например, в нём накопились самописные плагины, устаревший шаблон и компоненты без версии для Joomla 4 или 5.

Главная ошибка — считать миграцию обновлением CMS. Сначала обновляют окружение и карту зависимостей, затем саму Joomla, а не наоборот.

Сноска. Миграция — перенос сайта на новую несовместимую версию с адаптацией шаблона, расширений и настроек. Обновление — установка новой версии в пределах совместимой ветки. Для Joomla 3 → 4 это различие принципиально.

Что проверить до первой кнопки

Сделайте копию, которую можно восстановить

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

Тестовую копию лучше закрыть от поисковых роботов и случайных посетителей. Уберите из неё платёжные ключи, почтовые пароли и другие секреты, если переносите сайт на общий компьютер.

Составьте инвентаризацию

В админке Joomla запишите версии ядра, PHP, базы данных, шаблона и каждого установленного расширения. Отдельно отметьте компоненты, модули и плагины, которые отключены: старый отключённый плагин всё равно может мешать обновлению, если его файлы или записи остаются в системе.

• Экспортируйте список расширений и их назначение.
• Отметьте элементы, связанные с авторизацией, формами, поиском, SEO, магазином и оплатой.
• Проверьте страницу разработчика: нужна версия именно для Joomla 4 или 5, а не просто обещание «совместимо с PHP 8».
• Удалите расширения, которые точно не используются, но сначала убедитесь, что они не нужны шаблону или другому компоненту.

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

Проверьте PHP и сервер

Для Joomla 4 минимальная версия PHP зависит от конкретного релиза, но в официальных требованиях ветки 4 указана граница PHP 7.2.5. Joomla 5 требует PHP 8.1 или новее. Точные требования к базе данных, веб-серверу и расширениям PHP сверяйте для выбранного минорного релиза в официальной документации.

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

Рабочий порядок: Joomla 3.10, затем 4.4 и 5

1. Обновите Joomla 3 до последнего доступного релиза ветки 3.10. Обновите и удалите ненужные расширения, затем очистите кэш. Проверка: админка показывает Joomla 3.10, сайт открывается, а в журнале нет новых фатальных ошибок.
2. Подготовьте расширения к Joomla 4. Обновите их до последних версий, которые поддерживают Joomla 3.10 и имеют путь перехода на Joomla 4. Проверьте шаблон отдельно: старый шаблон часто ломается раньше компонентов. Проверка: на тестовой копии нет расширений без владельца и неизвестного назначения.
3. Запустите предварительную проверку обновления. Используйте штатный компонент обновления Joomla и его проверку совместимости, а не загружайте архив Joomla 4 поверх файлов вручную. Проверка: система показывает доступный целевой релиз и список потенциально проблемных расширений.
4. Выполните переход на Joomla 4 на копии. Перед запуском ещё раз сохраните файлы и базу. После обновления проверьте вход в админку, главную страницу, меню, поиск, формы и права пользователей. Проверка: ключевые URL возвращают ожидаемый ответ, а не 500 или пустую страницу.
5. Обновите шаблон и расширения уже в Joomla 4. Не оставляйте старые версии только потому, что сайт пока выглядит нормально. Проверка: страницы с компонентами, формами и авторизацией работают в новом шаблоне, а в логах нет повторяющихся ошибок.
6. Доведите сайт до Joomla 4.4 перед переходом на 5. Это переходная ветка для подготовки к Joomla 5. Проверьте предупреждения компонента обновления и состояние плагина обратной совместимости, если он используется в вашей конфигурации. Проверка: средство обновления не сообщает о блокирующих несовместимых расширениях.
7. Перейдите с Joomla 4.4 на Joomla 5 на тестовой копии. После обновления проверьте не только главную страницу, но и сохранение материалов, загрузку файлов, отправку писем и работу фоновых задач. Проверка: админка показывает Joomla 5, а бизнес-сценарии проходят без ошибок.

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

Типичные ошибки и что с ними делать

Сайт обновили на боевой копии

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

Старый шаблон оставили «на потом»

Шаблон влияет на меню, позиции модулей, переопределения и вывод компонентов. В Joomla 4 или 5 он может частично загрузиться, но сломать отдельные страницы. Сначала поставьте совместимый шаблон на тестовой копии, затем проверьте переопределения и адаптивную верстку. Если шаблон самописный, его перенос — отдельная задача, а не пункт после миграции.

Расширение установилось, но сайт всё равно падает

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

Обновили PHP одновременно с Joomla

Так невозможно понять, что стало причиной сбоя. Зафиксируйте исходную версию PHP, проверьте Joomla 4 и Joomla 5 на отдельных копиях, а смену PHP выполняйте как самостоятельный этап с отдельным тестом.

Проверили только главную страницу

Главная может открываться, даже если не работает отправка формы, вход пользователя или загрузка изображения. Составьте короткий сценарий приёмки: просмотр материала, поиск, вход, регистрация, форма обратной связи, загрузка файла, письма, редактирование записи и проверка мобильной версии.

Когда выбирать поэтапную миграцию, а когда — перенос

Поэтапный путь выбирайте, если важны старые URL, пользователи, категории, данные компонентов и минимальный объём ручного переноса. Его цена — необходимость последовательно проверять совместимость каждого расширения.

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

Что делать после миграции

Не закрывайте задачу в момент появления Joomla 5 в админке. В первые дни смотрите журнал ошибок PHP и Joomla, коды ответа веб-сервера, время загрузки ключевых страниц и ошибки отправки почты. Отдельно проверьте поисковые перенаправления и канонические URL: смена шаблона или структуры меню может оставить контент доступным только по новым адресам.

Следующий практический шаг — составить акт приёмки из конкретных URL и действий пользователя, выполнить его на тестовой копии, а затем повторить после боевого переключения. После этого настройте регулярные резервные копии и календарь обновлений расширений. Инвалидация кэша и оптимизация скорости после миграции — отдельная задача: сначала убедитесь, что сайт стабильно выполняет все основные сценарии.