- Головна
- Документація
- Оновлення
Оновлення
Команди оновлення не існує. Оновлення — це 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/, по одному на кожен етап. Ніде не фіксується, які з них уже були застосовані до бази, а повторне виконання скрипту нічого не змінює. Тому після оновлення виконайте всі скрипти починаючи зі stage10.sql у порядку зростання:
mariadb -u site -p site < private/energine/sql/cut/stage10.sql
— потім stage11.sql, stage12.sql і так далі до останнього, вказавши користувача та ім'я вашої бази даних. Пропустіть stage11-demo.sql: він призначений для демонстраційного вмісту. stage1.sql–stage7.sql переносять базу даних повного Energine, яка існувала на момент виділення Simple, до 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