Обновление с 2.x до 3.0

Этот документ подробно описывает изменения между 2.x и 3.0, которые могут повлиять на обновления. Это не полный список всех изменений (см. changelog), а справочник (критических) изменений, которые могут затронуть дополнения и сайты.

Список совместимых дополнений можно найти на SiteDash.

Обновление до 3.0¶

Установщик принимает обновление только с MODX 2.6.0 и новее. Если используется MODX 2.5 или более ранняя версия, сначала обновитесь до 2.6. Если текущая версия ниже 2.6.0, setup останавливается с ошибкой.

Когда вы уже на 2.6+, следуйте стандартному процессу обновления. Если можете, поработайте на последнем 2.8 перед 3.0. 2.8 пишет в журнал MODX вызовы устаревшего API, и вы успеете поправить дополнения и свой код.

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

• ⚠️ Важно: прямое обновление до MODX 3 с версий ниже 2.6.0 не поддерживается
• ⚠️ Важно: каталог core теперь всегда должен находиться в корне проекта и больше не может быть переименован
• ⚠️ Важно: MODX 3.0 требовал PHP 7.2, текущие 3.x (3.2+) требуют PHP 8.1+
• ⚠️ Важно: поддержка sqlsrv удалена
• Список критических изменений, в частности многие классы ядра перенесены и переименованы
• Обновление дополнений для 3.0
• xPDO 3, Composer и миграция кастомных моделей
• Язык менеджера теперь динамический
• Различные системные настройки удалены или изменены
• $modx->getService() устарел. Вместо него DI-контейнер ($modx->services). Метод всё ещё работает и не удалён в 3.1. См. modX.getService.
• Заметные изменения интерфейса менеджера в 3.0
• Пользовательские типы ресурсов, которые расширяют процессоры Resource: Процессоры и пользовательские классы ресурсов

Другие заметные изменения и улучшения¶

Менеджер и интерфейс¶

• Новый выбор шаблона упрощает создание ресурсов #15535
• Переработан установщик #14507 и вход в менеджер #13773.
• Менеджер переработан. Улучшена работа на мобильных #14700, #14735. Изменены стили ресурсов в дереве #14832
• Язык можно переключать на лету #14046
• Все разрешения менеджера автоматически доступны в MODx.perm #13924, #14425. См. Объект MODx.
• Перевод Google отключён в менеджере #14414
• Более последовательное дублирование ресурсов и элементов #14411

Пакеты¶

• Markdown теперь разбирается в атрибутах пакета (changelog, readme, license) #13853. См. Создание скрипта сборки.

Файлы и медиа¶

• Медиаисточники теперь используют Flysystem #13709. См. Файловая система и S3.
• Каталоги ядра защищены от переименования и удаления из менеджера #14374. См. источник File System.

Ресурсы и шаблоны¶

• Ресурсы могут получить иконку по типу контента #14383. См. Типы содержимого.
• Новые модификаторы вывода для файлов: dirname, basename, filename, extension #14198. См. Фильтры/модификаторы вывода.

Безопасность и почта¶

• Письмо «забыли пароль» использует ссылку сброса (modhash), а не пароль в письме #13786. См. forgot_login_email.

Парсер и REST¶

• Литеральные одинарные [ / ] внутри значений тегов поддерживаются #13904. См. Синтаксис тегов.
• Значения-массивы в свойствах получают стабильную serialize-подпись тега #14689. См. Синтаксис тегов.
• Пустые XML-элементы во входящем теле modRestService становятся '' #14305. См. RESTful API.