Обновление

Команды обновления как таковой нет. Обновление состоит из git pull и нескольких ручных шагов. Приведённые ниже команды выполняются из каталога сайта — того, где находятся web/ и private/, — от имени пользователя сайта.

Перед началом работы

Создайте резервную копию того, что существует только на этом сайте:

  • базы данных;
  • конфигурации: private/energine/configs/system.config.<host>.php;
  • каталога web/uploads/;
  • ваших изменений в private/energine/site/ — они являются частью репозитория, поэтому зафиксируйте их коммитом или скопируйте;
  • private/energine/tests/local.php, если вы используете тесты репозитория.

Символические ссылки в web/, каталог vendor/ и кэш ресайзера могут быть созданы заново и не требуют резервного копирования.

Не выполняйте git clean -fdx или git stash --all в репозитории: git игнорирует конфигурацию и tests/local.php, и эти команды удалят или скроют их.

1. Код

git -C private/energine pull

Файлы в web/images, web/scripts, web/stylesheets и web/templates являются ссылками на репозиторий, поэтому новые версии в них отображаются сразу же.

2. Входные файлы и ссылки

cp private/energine/htdocs/index.php private/energine/htdocs/bootstrap.php private/energine/htdocs/auth.php web/
cp private/energine/htdocs/resizer/timthumb.php web/resizer/
rm -f web/resizer/timthumb-config.php
cd web && php index.php setup linker && cd ..

Это необходимо, если обновление затронуло файлы в htdocs/ либо добавило, удалило или переименовало статические файлы; выполнять эти действия при каждом обновлении совершенно безопасно. Файл timthumb-config.php относится к старому ресайзеру: новый сохраняет имя timthumb.php ради правил nginx и не читает этот конфигурационный файл. Скопированные файлы должны принадлежать пользователю сайта. Новый скрипт попадает в карту импорта страниц только после выполнения setup linker.

Если в обновлении из ядра был удалён модуль, предварительно удалите строку с ним из секции modules в конфигурации: если модуль отсутствует, setup linker остановится, укажет его имя и оставит статические файлы без изменений.

3. База данных

Изменения базы данных поставляются в виде скриптов в каталоге private/energine/sql/cut/, по одному на каждый этап (stage). Нигде не фиксируется, какие из них уже применялись к базе, а повторный запуск скрипта ничего не меняет. Поэтому после обновления выполните по порядку все скрипты, начиная с stage10.sql:

mariadb -u site -p site < private/energine/sql/cut/stage10.sql

— затем stage11.sql, stage12.sql и так далее до последнего, подставив имя пользователя и название вашей базы данных. Пропустите stage11-demo.sql: он предназначен для демонстрационного контента. Скрипты stage1.sql–stage7.sql переводят на Simple базу данных полной версии Energine в том виде, в каком она была на момент отделения Simple; для сайта на Simple они никогда не требуются.

4. Строки интерфейса

Новые строки ядра добавляются описанными выше скриптами. Новые строки модуля сайта находятся в site/modules/main/translations.php; загрузите их:

cd web && php index.php setup translations && cd ..

Команда setup translations добавляет только отсутствующие строки и сохраняет все переводы, отредактированные в панели управления.

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

Конфигурация сайта не изменяется никакими автоматическими командами. Когда в шаблоне configs/system.config.default.php появляется новый параметр — например, блок mail.smtp, — скопируйте его в свою конфигурацию вручную. Чтобы посмотреть, что изменилось в шаблоне:

git -C private/energine diff ORIG_HEAD HEAD -- configs/system.config.default.php

Параметры, удалённые из шаблона, игнорируются, поэтому прежняя конфигурация продолжит работать.

6. Проверка

cd web && php index.php setup check