Миграция с версии 2.12

Energine 2.13 — это кодовая база 2.12, переведённая на PHP 8.4+ и MariaDB 10.11. Выпуск не содержит скрипта обновления: он протестирован только на чистых установках. На этой странице перечислено, что необходимо изменить на сайте, работающем на 2.12; выполняйте переход на копии сайта и его базы данных.

Платформа

  • PHP 8.4 или новее с расширениями ctype и fileinfo, а также MariaDB 10.11 или новее; MySQL не поддерживается.
  • Файл composer.json проекта: symfony/console ^7.4 вместо 2.6, пакет google/recaptcha удалён. Приведите его в соответствие с шаблонным проектом и выполните composer install --no-dev.

Файлы из стартового проекта 2.13

  • setup/: установка запускается только из консоли — php index.php setup … в htdocs/ — тогда как в 2.12 она выполнялась в браузере по адресу /setup/.
  • htdocs/bootstrap.php, htdocs/auth.php и htdocs/resizer/timthumb.php; примеры конфигурации веб-сервера в jambalaya/.
  • site/modules/main/templates/content/news_categories_editor.content.xml: указанный в нём класс изменился.

Конфигурация

  • $energine_release = 'PATH TO CORE'; теперь располагается перед return array(, добавлен ключ 'setup_dir' => ROOT_DIR . '/setup'.
  • modules: добавьте mail, ads, blog и shop — базовый макет теперь включает компонент модуля ads.
  • site.action_log включён в шаблоне; требует столбца share_action_log.al_action, который добавляется файлом modules.structure.sql.
  • Добавлен ключ mail.subscriptions; ключ recaptcha и закомментированный блок auth удалены.

Полное описание всех ключей см. в разделе Конфигурация.

База данных

  • Базовая схема, starter.structure.sql и starter.routines.sql, не изменилась с версии 2.12.
  • starter.structure.fixes.sql добавляет то, что требует код 2.13 и чего не было в дампе 2016 года; modules.structure.sql добавляет таблицы модулей mail, ads, blog и shop, не затрагивая существующие таблицы. Оба файла написаны с расчётом на повторный запуск (IF NOT EXISTS, INSERT IGNORE), однако в рамках данного выпуска они не проверялись на базе 2.12: сначала импортируйте их в копию.
  • modules.data.sql добавляет строки модулей, почтовые шаблоны, справочники магазина и соответствующие страницы — /subscribe/, /subscriptions/, /banners/, /blogs/, /catalog/, /search/, /cart/, /wishlist/, /my-orders/ и страницы административного раздела; адреса, уже существующие на сайте, остаются без изменений. Просмотрите новые страницы. starter.data.sitemap.sql добавляет /google-sitemap/.
  • starter.data.admin.sql и starter.data.demo.fixes.sql не предназначены для существующей базы данных.
  • Пароли продолжают работать: обе версии используют password_hash.

Ваши XSLT и шаблоны

  • main.xslt подключает ядро через ../../../../core/… — четыре уровня, в 2.12 их было пять — и include.xslt четырёх новых модулей; та же глубина применяется в include.xslt и error_page.xslt.
  • energine.xslt размещает pageAds, topBanner, Branding и ErrorComponent; без последнего новая страница 404 не будет содержать текста.
  • Компонент, которому передан параметр noCaptcha или use_captcha, теперь прерывает загрузку страницы с сообщением «Компоненту передан неизвестный параметр.»: удалите их из шаблонов и из XML, который страницы и виджеты хранят в базе данных. SocialLoginForm удалён.

Удалено

  • Вход через Facebook, VK, Google, OK и Instagram. Аккаунты, созданные таким способом, имеют сгенерированные пароли, а некоторые — адреса вида …@vk.com: задайте реальный адрес и пароль в разделе «Пользователи»; см. Пользователи.
  • reCAPTCHA и поведение MoveToFooter формы входа. HTMLCap устарел: используйте HTML-вставки страницы.

Что меняется на сайте

  • Несуществующий адрес отображает полноценную страницу 404.
  • Загрузка скриптовых файлов — PHP, CGI, Perl, Python, shell — а также .htaccess и .htpasswd запрещена.
  • Анонимные комментарии могут редактировать и удалять только администраторы.
  • Журнал действий записывается при сохранении в административном разделе.
  • Форматы дат, написанные для strftime() с использованием %a, %A, %b или %B, выводят названия дней и месяцев на английском языке там, где 2.12 использовал локаль сервера; собственные форматы ядра сохраняют переведённые названия.

Ваш PHP-код

  • Код должен работать на PHP 8.4: функции each() и create_function() больше не существуют, а strftime() объявлена устаревшей.
  • Ядро преобразует предупреждения PHP в исключения, поэтому предупреждение — например, обращение к несуществующему ключу массива — прерывает загрузку страницы; устаревшие конструкции только записываются в журнал.
  • Классы, расширяющие классы ядра, должны соответствовать сигнатурам методов версии 2.13: добавлены возвращаемые типы, такие как rewind(): void и current(): mixed.
  • Mail::setText() принимает только текст; второй аргумент игнорируется.