Історичні дані в MongoDB
За замовчуванням кожна таблиця використовує основне з'єднання вашого застосунку (PostgreSQL або MySQL) — жодна зміна цієї функції не впливає на це, якщо ви не ввімкнете її вручну. Самостійно розміщені сховища з великим обсягом історії, доступної лише для додавання (записи журналу активності, чати, історія email у CRM), можна перенести лише для цих таблиць на окреме з'єднання, зокрема MongoDB, не змінюючи нічого іншого.
Що переміщується
- Журнал активності —
activity_logтаблиця (кожен запис аудиту create/update/delete/login) - Повідомлення чату — модуля Messaging
msg_messagesтаблиця - Історія email у CRM —
crm_email_messagesтаблиціcrm_email_eventsтаблиці
Усе інше — замовлення, товари, клієнти, бухгалтерія — завжди залишається на вашому основному з'єднанні. Це цілеспрямоване переміщення лише для історичних таблиць із великим обсягом даних, до яких рідко застосовуються JOIN-запити.
Варіант A: інше SQL-з'єднання
Спрямуйте історію на будь-яке з'єднання, вже визначене в config/database.php (наприклад, окремій базі даних Postgres для журналів):
HISTORICAL_DB_CONNECTION=pgsql_history
Це працює одразу без додаткових пакетів — це звичайний Eloquent зі звичайним SQL-з'єднанням.
Варіант B: MongoDB
A 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 лише перемикання з'єднання надає доступ до колекції MongoDB на рівні query builder. Для повної підтримки Eloquent (BSON-приведення типів, основні ключі ObjectId, вбудовані документи) також додайте до моделі пакета MongoDB\Laravel\Eloquent\DocumentModel трейт, а також трейт перемикання з'єднання, який ця платформа вже постачає для історичних моделей:
use StoreConsole\PlatformKit\Traits\UsesHistoricalConnection;
use MongoDB\Laravel\Eloquent\DocumentModel;
class Activity extends SpatieActivity
{
use UsesHistoricalConnection;
use DocumentModel;
}
Оскільки Store Console постачається з повним вихідним кодом за ліцензією, це однорядковий додаток до вашої власної копії, а не патч від постачальника.
Як скасувати зміни
Скасуйте значення HISTORICAL_DB_CONNECTION (або встановіть порожнє значення), і під час наступного запиту кожна модель знову використовуватиме з'єднання за замовчуванням — для вимкнення функції не потрібна міграція.

