- Главная
- Документация
- Обновление
Обновление
Команды обновления как таковой нет. Обновление состоит из 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