Переход на 11.0.0 с 10.x

Важное обновление до версии iEXExchanger 11.0

Обновление до версии iEXExchanger 11.0 является крупным мажорным переходом и включает существенные изменения в архитектуре системы, логике работы модулей и конфигурации проекта.

Версия 11.0 работает исключительно на PHP 8.4 и использует полностью новую систему мерчантов и новую систему настроек, которые не совместимы с предыдущей структурой версии 10.x.

Обратите внимание, что в версии 11.0 временно отсутствуют некоторые мерчанты, включая: WhiteBIT, PayScrow, SuperMoney и Merchant001. Если вы используете указанные мерчанты в рабочем проекте, обновление на данную версию не рекомендуется.

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

Изменения в 11.0

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

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

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

Резервное копирование файлов сайта (FastPanel)

1. Войдите в панель управления FastPanel.

2. Перейдите в раздел «Файловый менеджер».

3. Выделите папку с файлами сайта и создайте архив (ZIP).

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

Резервное копирование базы данных (FastPanel)

1. В панели FastPanel откройте раздел «Базы данных».

2. Выберите используемую базу данных проекта.

3. Выполните экспорт (резервное копирование) базы данных.

4. Сохраните полученный файл SQL на локальном компьютере.

Если возникают сложности

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

Как создать Backup?

---

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

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

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

Важно:

На этом этапе необходимо подключиться к серверу через SSH под пользователем root, так как именно root имеет полный доступ к системе и может выполнять все необходимые команды. Это критично для корректной установки и настройки компонентов, обеспечивающих стабильную и быструю работу обменника.

1

Проверьте, что FastPanel PHP 8.4 установлен

В FastPanel должен быть установлен PHP 8.4 и доступен путь: /opt/php84/bin/php

Проверка: /opt/php84/bin/php -v

Если команда не найдена — сначала установите PHP 8.4 в FastPanel.

2

Сделать PHP 8.4 (FastPanel) основным для CLI

В FastPanel PHP 8.4 находится по пути: /opt/php84/bin/php

Сделаем так, чтобы команда php в терминале использовала именно PHP 8.4.

Команды

if [ ! -x /opt/php84/bin/php ]; then
  echo "Ошибка: не найден /opt/php84/bin/php. Установите PHP 8.4 в FastPanel."
  exit 1
fi

sudo update-alternatives --install /usr/bin/php php /opt/php84/bin/php 84 >/dev/null 2>&1 || true
sudo update-alternatives --set php /opt/php84/bin/php >/dev/null 2>&1 || true

php -v | head -n 1

3

Установка ionCube Loader 15

• Loader подключаем первым через файл: /opt/php84/conf.d/00-ioncube.ini

• Скачивание: IPv4 + fallback ZIP, если tar.gz не скачался.

Команды

sudo mkdir -p /usr/local/src
cd /usr/local/src
sudo rm -rf ioncube >/dev/null 2>&1 || true
sudo rm -f ioncube_loaders_lin_x86-64.tar.gz ioncube_loaders_lin_x86-64.zip >/dev/null 2>&1 || true

IONCUBE_TAR_URL="https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz"
IONCUBE_ZIP_URL="https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.zip"
IONCUBE_DST_DIR="/usr/local/ioncube"
IONCUBE_SO="$IONCUBE_DST_DIR/ioncube_loader_lin_8.4.so"
IONCUBE_INI="/opt/php84/conf.d/00-ioncube.ini"

download_ok=0
curl -4 -fSL "$IONCUBE_TAR_URL" --connect-timeout 10 --max-time 600 --retry 5 --retry-delay 2 \
  -o ioncube_loaders_lin_x86-64.tar.gz && download_ok=1 || download_ok=0

if [ "$download_ok" -eq 1 ] && [ -s ioncube_loaders_lin_x86-64.tar.gz ]; then
  sudo tar -xzf ioncube_loaders_lin_x86-64.tar.gz
else
  curl -4 -fSL "$IONCUBE_ZIP_URL" --connect-timeout 10 --max-time 600 --retry 5 --retry-delay 2 \
    -o ioncube_loaders_lin_x86-64.zip

  if [ ! -s ioncube_loaders_lin_x86-64.zip ]; then
    echo "Ошибка: ionCube zip не скачался или пустой."
    exit 1
  fi

  sudo unzip -o ioncube_loaders_lin_x86-64.zip -d /usr/local/src >/dev/null
fi

if [ ! -f "/usr/local/src/ioncube/ioncube_loader_lin_8.4.so" ]; then
  echo "Ошибка: не найден /usr/local/src/ioncube/ioncube_loader_lin_8.4.so"
  exit 1
fi

sudo mkdir -p "$IONCUBE_DST_DIR"
sudo cp -f "/usr/local/src/ioncube/ioncube_loader_lin_8.4.so" "$IONCUBE_SO"

echo "zend_extension=$IONCUBE_SO" | sudo tee "$IONCUBE_INI" >/dev/null

# Если в php-cli.ini было старое подключение — комментируем
if [ -f /opt/php84/etc/php-cli.ini ]; then
  sudo sed -i 's/^\s*zend_extension\s*=.*ioncube.*$/; &/i' /opt/php84/etc/php-cli.ini || true
  sudo sed -i 's/^\s*zend_extension_ts\s*=.*ioncube.*$/; &/i' /opt/php84/etc/php-cli.ini || true
fi

php -v | grep -i "ionCube" || true

---

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

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

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

• dist

• logs

Важно!

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

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.

Как открыть терминал и подключиться к серверу по SSH?

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

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

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

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

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

php artisan language:export
php artisan product:apply-update
php artisan dynamic-config:migrate-from-json
php artisan language:import

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

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

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

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

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

   Это предотвратит случайное повторное применение устаревших файлов.

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

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

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

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

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

Ссылка: Инструкция по переустановке PM2

---

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

Где расположена корневая директория вашего сайта?Как открыть терминал и подключиться к серверу по SSH?Переустановка PM2