Исторические данные в 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 нужны два компонента, которые эта платформа не устанавливает по умолчанию:
- Расширение
mongodbPHP на вашем сервере 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 (или установите пустое значение), и при следующем запросе каждая модель вернётся к подключению по умолчанию — для отключения функции не требуется миграция.

