Міграція з версії 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() приймає лише текст; другий аргумент ігнорується.