Black Friday saleдо 60% знижки
  • Знижка 60% на перший рік річної підписки
  • Знижка 45% на довічні ліцензії
Завершиться через
Отримати пропозицію

Історичні дані в 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 потребує двох компонентів, які ця платформа не встановлює за замовчуванням:

  • Розширення mongodb PHP на вашому сервері
  • 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 (або встановіть порожнє значення), і під час наступного запиту кожна модель знову використовуватиме з'єднання за замовчуванням — для вимкнення функції не потрібна міграція.

Останнє оновлення: 11/19/2026