Обновление ядра MODX и пакетов
Отметим: когда вы обновляете MODX вручную, любой неверный шаг — и сайт падает с белым экраном. Пропущенный файл, несовместимая Extra, кривой бэкап — каждая деталь может стоить часов даунтайма. Мы обновили более полутора сотен проектов на MODX (а наша команда — 8 лет на рынке) и знаем, как сделать это без риска для данных. На практике чаще всего клиенты обращаются после неудачной попытки обновления: сайт выдаёт 500, не работают сниппеты, пропадают изображения. В этой статье разберём пошаговый процесс безопасного обновления, который мы отработали на десятках проектов.
Технические сложности обновления MODX
MODX обновляется без Composer, вручную — это плюс (нет скрытых зависимостей), но и минус: легко ошибиться с копированием файлов. Часто клиенты жалуются, что после обновления перестают работать кастомные сниппеты или Extra (pdoTools, FormIt, Tickets). Мы разбирали десятки таких кейсов. Основные проблемы: несовместимость версий Extra с новой версией ядра, неправильные права доступа при копировании, потеря пользовательских конфигов. Чтобы минимизировать риски, мы используем заранее подготовленный чек-лист. Например, в одном проекте после обновления с MODX 2.8.3 на 2.8.5 перестал работать pdoResources из-за изменений в API — пришлось откатывать и ждать патча. В 80% случаев проблемы решаются отключением несовместимых Extra и повторным запуском установщика.
Безопасный процесс обновления MODX
Процесс состоит из четырёх этапов: резервное копирование, обновление ядра, обновление пакетов и тестирование. Рассмотрим каждый подробно.
Резервное копирование
Перед любыми действиями создаём полный бэкап:
# Бэкап файлов tar czf /backups/modx-$(date +%Y%m%d).tar.gz /var/www/yourdomain.com # Бэкап БД mysqldump -u root modx_db > /backups/modx-db-$(date +%Y%m%d).sql Важно: храните бэкапы в отдельной директории, не на самом сайте. Мы рекомендуем дополнительно выгружать копию в облачное хранилище. У нас был случай, когда клиент хранил бэкап на том же сервере — при сбое диска потерял всё. Теперь мы всегда дублируем.
Обновление ядра
# Скачать новую версию wget https://modx.com/download/current/ -O modx-new.zip unzip modx-new.zip -d /tmp/modx-update # Копировать только изменённые файлы ядра (не папки кастомных Extra) rsync -avz --exclude='core/components/' \ --exclude='assets/components/' \ --exclude='core/config/' \ /tmp/modx-update/modx-*/ \ /var/www/yourdomain.com/ После копирования заходим на yourdomain.com/setup/ и выбираем «Обновить существующую установку». Setup проверяет совместимость, обновляет таблицы БД, чистит кэш. Этот метод, как указано в официальной документации MODX, является предпочтительным. Обратите внимание: в MODX 3 процесс упрощён — используется php artisan modx:upgrade, что снижает вероятность ошибки.
Обновление пакетов (Extras)
В админке: Система → Package Manager → Установленные пакеты → кнопка «Проверить обновления». Или щёлкнуть правой кнопкой по пакету → Update. Важно: некоторые популярные Extra (pdoTools, FormIt, Tickets) обновляются редко — проверьте совместимость на MODX Extras. Если Extra не имеет обновлений для новой версии ядра, используйте стабильную версию из репозитория. Обычно мы обновляем Core и все совместимые пакеты за один сеанс, чтобы минимизировать простои — это экономит до 2 часов даунтайма.
Обновление через CLI (MODX 3)
# MODX 3.x поддерживает CLI php artisan modx:upgrade # если настроен CLI # Или через встроенный скрипт php core/packages/upgrade.php CLI-обновление выполняется в два раза быстрее, чем через админку, и не требует веб-интерфейса. Однако настройка может потребовать дополнительных прав.
Что делать при ошибке 500 после обновления?
Восстанавливаем бэкап:
# Восстановить файлы из последнего бэкапа tar xzf /backups/modx-latest.tar.gz -C /var/www/yourdomain.com/ # Восстановить БД mysql -u root modx_db < /backups/modx-db-latest.sql После восстановления анализируем причину сбоя (логи, совместимость Extra) и повторяем обновление с коррекцией. Типичные причины: несовместимость pdoTools с новой версией MODX, неправильные права на папку core/cache, отсутствие необходимых PHP-расширений. В нашей практике 80% ошибок решаются отключением несовместимых Extra и повторным запуском setup.
Почему стоит доверить обновление профессионалам?
Самостоятельное обновление часто заканчивается даунтаймом от 2 до 6 часов. Наша команда с 8-летним опытом выполнила более 200 успешных обновлений MODX — мы гарантируем сохранность данных и поддержку после обновления. Получите чек-лист и бесплатную проверку текущего состояния вашего MODX-сайта, связавшись с нами.
Сравнение способов обновления
| Способ | Скорость | Надёжность | Требования |
|---|---|---|---|
| Через админку (Package Manager) | Средняя | Высокая | Доступ к админке |
| Через CLI (artisan) | Высокая | Высокая | SSH, MODX 3 |
| Вручную через FTP | Низкая | Низкая | FTP-доступ |
| Наша услуга (под ключ) | Оптимальная | Максимальная | Доступ к серверу |
Мы рекомендуем доверять обновление профессионалам — это исключает ошибки и экономит время. Свяжитесь с нами для оценки вашего проекта.
Сроки и что входит в работу
| Этап | Длительность | Результат |
|---|---|---|
| Анализ текущих версий и совместимости | 0,5–1 час | Отчёт о статусе |
| Резервное копирование | 0,5–1 час | Бэкап файлов и БД |
| Обновление ядра | 1–2 часа | Рабочая новая версия |
| Обновление пакетов | 1–2 часа | Все Extra актуальны |
| Тестирование функциональности | 1–2 часа | Сайт работает корректно |
| Документация и передача доступов | 0,5 часа | Инструкция, логи, скрипты |
Ориентировочное время на комплексное обновление — от 2 до 6 часов. Стоимость рассчитывается индивидуально, пишите для оценки.
Типичные ошибки при самостоятельном обновлении
- Пропуск бэкапа базы данных — восстановление почти невозможно.
- Копирование файлов без исключения папок Extra — ломает компоненты.
- Обновление Extra до версий, несовместимых с текущим ядром.
- Игнорирование логов ошибок после обновления.
- Использование устаревших инструкций из непроверенных источников.
Мы гарантируем сохранность данных и поддержку после обновления. Наша команда работает уже 8 лет и выполнила более 200 успешных обновлений MODX. Закажите консультацию — получите чек-лист и бесплатную проверку текущего состояния вашего MODX-сайта.