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