Миграция с Joomla 3 на 4 и 5: какой путь выбрать

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

Главное ограничение: Joomla 3 нельзя просто обновить до Joomla 5

Официальный сценарий строится по цепочке Joomla 3.10 → Joomla 4 → Joomla 5. Joomla 3.10 служит переходной версией: в ней появились инструменты проверки совместимости и обновления до Joomla 4. Затем сайт переводят на поддерживаемую ветку Joomla 4 и только после этого рассматривают обновление до Joomla 5.

Это важно не только из-за номера версии. Между ветками меняются требования к PHP, интерфейс администратора, шаблоны, API расширений и отдельные системные настройки. Расширение, которое без проблем работало в Joomla 3, может не установиться в Joomla 4 или загрузиться, но сломать страницу в Joomla 5.

Joomla 3.10, Joomla 4 и Joomla 5 — это разные этапы проекта, а не три названия одной процедуры обновления.

Три маршрута миграции

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

Когда выбирать поэтапное обновление

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

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

Когда лучше чистая установка Joomla 5

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

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

Когда остановиться на Joomla 4

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

Не стоит выбирать Joomla 4 только потому, что обновление туда кажется проще. Проверьте цикл поддержки конкретной ветки и требования проекта на официальном сайте Joomla. Длительная жизнь на промежуточной версии без плана создаёт тот же долг, из-за которого сайт оказался на Joomla 3.

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

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

• Создайте полную резервную копию файлов и базы данных. Проверьте восстановление на отдельном стенде, а не только наличие архива.
• Зафиксируйте текущую версию Joomla 3, PHP, базы данных, веб-сервера и подключённых внешних сервисов.
• Составьте список компонентов, модулей, плагинов, шаблона и переопределений. Удалите неиспользуемые расширения до миграции.
• Проверьте совместимость каждой критичной функции с Joomla 4 и Joomla 5 на сайте разработчика расширения.
• Соберите список URL, которые нельзя потерять: страницы входа, карточки товаров, статьи из поиска, рекламные посадочные страницы.
• Подготовьте тестовый домен или локальную копию. Миграцию боевого сайта без обратимого плана отката проводить не стоит.

Отдельно проверьте PHP. Joomla 3, Joomla 4 и Joomla 5 предъявляют разные требования к версии PHP, а точные минимальные и рекомендуемые значения зависят от целевой версии и расширений. Перед переключением сверяйте их с официальной документацией Joomla и ограничениями хостинга.

Как выглядит рабочий процесс

Формально обновление запускается из панели администратора. Но безопасная миграция состоит не из нажатия кнопки, а из повторяемых этапов.

1. Клонируйте сайт. Разверните копию на отдельном домене или сервере, отключите отправку писем и закройте её от индексации. Проверка: копия открывается, администратор входит, материалы и медиа на месте.
2. Приведите Joomla 3 к последней доступной версии ветки 3.10. Перед этим обновите совместимые расширения и удалите ненужные. Проверка: панель не показывает незавершённых обновлений и ошибок базы.
3. Запустите проверку совместимости. В отчёте отдельно разберите шаблон, плагины, компоненты и переопределения. Проверка: для каждого критичного расширения есть подтверждённый план — обновить, заменить или удалить.
4. Обновите копию до Joomla 4. Не меняйте одновременно хостинг, PHP, шаблон и набор расширений без фиксации каждого шага. Проверка: открываются главная страница, несколько материалов, поиск, форма входа и административная панель.
5. Исправьте проблемы после перехода. Проверьте меню, права доступа, мультиязычность, изображения, формы, RSS, карту сайта и интеграции. Проверка: ключевые сценарии проходят с чистого браузера и под обычной учётной записью.
6. Подготовьте переход Joomla 4 → 5. Обновите расширения до совместимых версий, проверьте требования PHP и сделайте новый снимок. Проверка: на стенде есть точка возврата именно перед обновлением до Joomla 5.
7. Повторите функциональные тесты после установки Joomla 5. Сравните не только внешний вид, но и ответы URL, метаданные, права, письма и фоновые задачи. Проверка: журнал ошибок не растёт после нескольких обычных пользовательских сценариев.
8. Переключите боевой сайт. Введите короткое окно заморозки контента, повторите резервное копирование и заранее подготовьте откат. Проверка: домен ведёт на новую версию, HTTPS работает, важные URL возвращают ожидаемые ответы.

Что чаще всего ломается

Шаблон и переопределения

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

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

Расширения с зависимостью от старого API

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

URL, права и мультиязычность

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

Самый дорогой дефект миграции — не белый экран, а незаметная потеря поискового трафика, заявок или прав доступа.

Когда что выбирать

• Поэтапное обновление — если расширения подтверждённо совместимы, сайт велик, а URL и существующая структура критичны.
• Чистая Joomla 5 — если проект перегружен неиспользуемыми расширениями, шаблон устарел, а структуру можно пересобрать и проверить вручную.
• Временная Joomla 4 — если есть конкретный блокер для Joomla 5 и вы зафиксировали срок повторной проверки, а не просто отложили решение.

Ключевой критерий — не размер базы и не число страниц. Смотрите на количество критичных расширений, объём ручных изменений в шаблоне, требования интеграций и цену простоя. Десять тысяч простых материалов могут перенестись легче, чем один магазин с нестандартным оформлением заказа.

Где подход ломается

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

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

Оба подхода требуют отдельного плана отката. Резервная копия должна быть не формальным архивом, а проверенным способом вернуть сайт в рабочее состояние. Миграция базы, перенос медиа и настройка DNS — разные операции, и их нельзя считать одной кнопкой отмены.

Что сделать дальше

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

После запуска в продакшене первые дни отслеживайте журнал ошибок, ответы важных URL, отправку форм, вход пользователей, скорость страниц и появление 404. Инвалидация кеша, настройка CDN и SEO-аудит — отдельные задачи; в этой миграции важно сначала доказать, что сайт корректно работает на новой версии.

Термин: переопределение шаблона — копия файла расширения или шаблона, изменённая внутри Joomla без правки исходного файла. Такие изменения позволяют сохранять дизайн при обновлениях, но могут устареть и конфликтовать с новой версией.