Обновление до 11.0.5

Изменении в версии 10.0.5

Резервное копирование перед обновлением

Перед тем как приступать к обновлению системы, настоятельно рекомендуем выполнить резервное копирование (backup) файлов вашего сайта и базы данных. Это обязательный этап, который поможет избежать потери данных и обеспечить возможность восстановления сайта в случае любых непредвиденных обстоятельств во время обновления.

Как создать резервную копию с помощью FastPanel

1. Создание резервной копии файлов сайта:

   • Войдите в панель управления FastPanel.
   • Перейдите в раздел «Файловый менеджер».
   • Выделите папку с файлами вашего сайта и создайте архив (zip).
   • Скачайте созданный архив на свой компьютер.
2. Создание резервной копии базы данных:

   • В панели FastPanel перейдите в раздел «Базы данных».
   • Выберите нужную базу данных.
   • Нажмите на опцию экспорта (резервного копирования), чтобы получить файл SQL.
   • Сохраните скачанный файл SQL на ваш компьютер.

Что делать, если возникают сложности

Если вы не уверены, как правильно выполнить резервное копирование через панель FastPanel или столкнулись с трудностями, рекомендуем обратиться в службу технической поддержки вашего хостинга. Специалисты помогут вам разобраться и дадут необходимые рекомендации по процедуре создания резервных копий именно на вашем сервере.

space

---

Подготовка к обновлению

Перед началом обновления зайдите в панель управления и временно отключите обменный пункт. Это нужно для того, чтобы клиенты не могли создавать заявки во время процесса обновления.

Перед обновлением системы до версии 11.0.5 рекомендуется удалить стандартный набор папок из директории поддомена вашего приложения (например, app.ваш_домен).

1

Frontend (основной домен, например, ваш_домен):

Обязательно убедитесь, что вы находитесь в папке основного сайта, чтобы случайно не удалить файлы поддомена.

Удалите следующие папки из директории основного домена:

• dist
• logs

Важно!

В панели управления FastPanel убедитесь, что вы находитесь именно в папке основного домена (test.ru), чтобы не затронуть другие сайты или поддомены.

2

Backend (поддомен, например, app.ваш_домен):

Обязательно убедитесь, что вы находитесь в папке поддомена, чтобы случайно не удалить файлы основной версии сайта.

Стандартный список папок, которые необходимо удалить:

• app
• bootstrap
• config
• database
• packages
• resources
• routes
• vendor

Важно!

Не удаляйте папки public и storage — в них хранятся важные пользовательские данные, медиафайлы, логи и пользовательские загрузки. Удаление этих папок может привести к потере данных, необходимых для работы приложения.

Для регулярных обновлений используйте пакеты обновлений.

---

Загрузка и распаковка архивов обновления

Следуйте этой инструкции, чтобы правильно загрузить архивы с обновлениями и избежать путаницы.

1

Авторизация на сервере

• Если вы используете FastPanel, выполните вход через панель управления.
• Загружайте файлы только от имени пользователя, созданного специально для вашего сайта.
• Не используйте пользователя root — это важно для безопасности и сохранности данных.

2

Куда загружать архивы

Архивы обновления уже имеют понятные названия:

• iexexchanger_backend_update — для папки поддомена вашего сайта (например, app.ваш_домен)
• iexexchanger_frontend_update — для корневой папки основного сайта (например, ваш_домен)

Архив обновления	Куда загружать?	Пример пути
backend	Папка поддомена	www/app.test.com
frontend	Корневая папка основного сайта	www/test.com

Внимание! Проверьте, что находитесь именно в нужной папке, чтобы не затронуть лишние данные на сервере.

3

Как загрузить архивы

Выберите удобный для вас способ:

• Файловый менеджер в панели управления хостингом (например, FastPanel)
• FTP-клиент (например, FileZilla)

Загрузите соответствующий архив в нужную папку — как указано выше.

4

Распаковка архивов

• Найдите загруженный архив в выбранной папке.
• Распакуйте архив прямо в эту папку.
• Если система спросит, нужно ли заменить существующие файлы — подтверждайте замену.

Это нормально: обновление заменяет устаревшие файлы на новые.

5

Проверка после обновления

• Проверьте, что новые файлы появились на сервере.
• Откройте сайт в браузере и убедитесь, что он работает корректно.
• При необходимости очистите кэш сайта и браузера.

Важные рекомендации

• Никогда не удаляйте папки public и storage!

  В них хранятся все пользовательские данные, медиафайлы, документы.

  Удаление этих папок приведёт к потере важной информации!
• Работайте только в папке нужного домена или поддомена.

  Не перепутайте основной сайт и поддомен, чтобы не нарушить работу сайта.

---

Завершение обновления системы

После того как вы успешно загрузили файлы обновления на сервер, выполните указанные ниже шаги для применения всех изменений:

Шаг 1. Подключитесь к серверу через терминал (SSH)

Если вы не знаете, как это сделать, воспользуйтесь подсказкой:

Важно: подключайтесь от имени обычного пользователя, а не root.

Шаг 2. Перейдите в папку поддомена на сервере

Введите команду (замените путь на актуальный путь до вашего сайта и поддомена):

cd www/app.ваш_домен

Шаг 3. Выполните команду для применения обновления

Выполните следующую команду:

php artisan product:apply-update

Важно: если при выполнении этой команды вы увидели любые предупреждения, ошибки или сообщения об отказе доступа (например, проблемы с правами на файлы или ошибки зависимостей), выполните команду повторно. Повторный запуск поможет устранить временные конфликты или неполные изменения, которые могли возникнуть при первом запуске. Если после повторного запуска ошибки сохраняются, обратитесь за технической поддержкой.

Эта команда применит все необходимые изменения и завершит установку обновления.

ВАЖНОЕ ДЕЙСТВИЕ ПОСЛЕ ОБНОВЛЕНИЯ

После завершения обновления:

1. Удалите из корневой папки сайта все ранее загруженные ZIP-архивы обновлений.

   Это предотвратит случайное повторное применение устаревших файлов.
2. Перезагрузите сервер, чтобы изменения полностью вступили в силу

Обновление успешно завершено!

Что делать, если сайт не запускается после перезагрузки

Если после перезагрузки вы пытаетесь открыть сайт, но страница вообще не загружается, значит, основной сайт не запустился.

Чаще всего это происходит потому, что после перезагрузки сервера автоматически не запустился PM2 — программа, которая поддерживает работу сайта.

В этом случае:

1. Перейдите по ссылке ниже.
2. Следуйте шагам, чтобы вручную запустить сайт.

Ссылка: [Переустановке PM2]

---

Рекомендуемые ссылки