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