Распродажа «Чёрная пятница»Скидка до 60%
  • Скидка 60% на первый год годовых планов
  • Скидка 45% на пожизненные лицензии
Заканчивается через
Получить скидку

Исторические данные в MongoDB

По умолчанию каждая таблица хранится в основном подключении вашего приложения (PostgreSQL или MySQL) — эта функция ничего в этом не меняет, пока вы не включите её. Самостоятельно размещаемые хранилища с большим объёмом истории, доступной только для добавления (записи журнала активности, чаты, история CRM-писем), можно перенести на отдельное подключение, включая MongoDB, не затрагивая ничего остального.

Что переносится

  • Журнал активности — activity_log таблица (каждая запись аудита о создании, обновлении, удалении и входе)
  • Сообщения чатов — таблица модуля Messaging msg_messages таблица
  • История CRM-писем — crm_email_messages и crm_email_events таблицы

Всё остальное — заказы, товары, клиенты, бухгалтерия — всегда остаётся в основном подключении. Это точечный перенос только для таблиц истории большого объёма, к которым редко выполняются JOIN-запросы.

Вариант A: другое SQL-подключение

Направьте историю на любое подключение, уже определённое в config/database.php (например, на вторую базу данных Postgres, выделенную для журналов):

HISTORICAL_DB_CONNECTION=pgsql_history

Это работает сразу, без дополнительных пакетов — это обычный Eloquent на обычном SQL-подключении.

Вариант B: MongoDB

Шаблон mongodb подключения поставляется в config/database.php уже, но остаётся неактивным, пока вы не включите его:

HISTORICAL_DB_CONNECTION=mongodb
MONGODB_URI=mongodb://user:password@host:27017
MONGODB_DATABASE=storeconsole_history

Для поддержки MongoDB нужны два компонента, которые эта платформа не устанавливает по умолчанию:

  • Расширение mongodb PHP на вашем сервере
  • composer require mongodb/laravel-mongodb (перечислено в suggest в корневом каталоге composer.json)

Без установленного расширения и пакета параметр HISTORICAL_DB_CONNECTION=mongodb безопасно игнорируется — каждая модель использует подключение по умолчанию, а приложение запускается и работает точно как прежде.

Полная поддержка моделей MongoDB

После установки mongodb/laravel-mongodb одно только переключение подключения даёт доступ к коллекции Mongo на уровне query builder. Для полной поддержки Eloquent (BSON-приведения типов, первичных ключей ObjectId, вложенных документов) добавьте также MongoDB\Laravel\Eloquent\DocumentModel trait из пакета к модели вместе с trait для переключения подключений, который эта платформа уже предоставляет для моделей истории:

use StoreConsole\PlatformKit\Traits\UsesHistoricalConnection;
use MongoDB\Laravel\Eloquent\DocumentModel;

class Activity extends SpatieActivity
{
    use UsesHistoricalConnection;
    use DocumentModel;
}

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

Как отменить перенос

Сбросьте HISTORICAL_DB_CONNECTION (или установите пустое значение), и при следующем запросе каждая модель вернётся к подключению по умолчанию — для отключения функции не требуется миграция.

Последнее обновление: 11/19/2026