Historische gegevens in MongoDB
Standaard bevindt elke tabel zich op de hoofdverbinding van je app (PostgreSQL of MySQL) — deze functie verandert daar niets aan tenzij je er expliciet voor kiest. Zelf gehoste stores met veel uitsluitend aanvullende historie (activiteitenlogboek, chattranscripten, CRM-e-mailgeschiedenis) kunnen alleen die tabellen naar een aparte verbinding verplaatsen, inclusief MongoDB, zonder al het andere te raken.
Wat wordt verplaatst
- Activiteitenlogboek — de
activity_logtabel (elk audititem voor aanmaken/bijwerken/verwijderen/inloggen) - Chatberichten — de tabel van de Messaging-module
msg_messagestabel - CRM-e-mailgeschiedenis — de
crm_email_messagesencrm_email_eventstabellen
Alles else — orders, producten, klanten, boekhouding — blijft altijd op je primaire verbinding. Dit is uitsluitend een gerichte verplaatsing voor historietabellen met een hoog volume die zelden worden samengevoegd.
Optie A: Een andere SQL-verbinding
Richt history naar een willekeurige verbinding die al gedefinieerd is in config/database.php (bijvoorbeeld een tweede Postgres-database specifiek voor logs):
HISTORICAL_DB_CONNECTION=pgsql_history
Dit werkt direct zonder extra packages — het is gewone Eloquent op een gewone SQL-verbinding.
Optie B: MongoDB
Een mongodb verbindingssjabloon wordt al meegeleverd in config/database.php maar het is inactief totdat je er expliciet voor kiest:
HISTORICAL_DB_CONNECTION=mongodb
MONGODB_URI=mongodb://user:password@host:27017
MONGODB_DATABASE=storeconsole_history
MongoDB-ondersteuning vereist twee dingen die dit platform standaard niet installeert:
- De
mongodbPHP-extensie op je server composer require mongodb/laravel-mongodb(vermeld ondersuggestin de rootcomposer.json)
Zonder de extensie en package geïnstalleerd, wordt het instellen van HISTORICAL_DB_CONNECTION=mongodb veilig genegeerd — elk model valt terug op de standaardverbinding en de app start en werkt precies zoals voorheen.
Volledige MongoDB-modelondersteuning
Zodra mongodb/laravel-mongodb is geïnstalleerd, geeft alleen het wisselen van verbinding je al query-builder-niveau toegang tot de Mongo-collectie. Voor volledige Eloquent-ondersteuning (BSON-casts, ObjectId-primary keys, ingebedde documenten) voeg je ook de trait van de package toe aan het model, naast de trait voor het wisselen van verbindingen die dit platform al meelevert voor history-modellen: MongoDB\Laravel\Eloquent\DocumentModel trait aan het model toe, naast de trait voor het wisselen van verbindingen die dit platform al meelevert voor history-modellen:
use StoreConsole\PlatformKit\Traits\UsesHistoricalConnection;
use MongoDB\Laravel\Eloquent\DocumentModel;
class Activity extends SpatieActivity
{
use UsesHistoricalConnection;
use DocumentModel;
}
Omdat Store Console per licentie als volledige broncode wordt geleverd, is deze toevoeging van één regel een normale aanpassing van je eigen kopie — geen patch van de leverancier.
Terugdraaien
Wis HISTORICAL_DB_CONNECTION (of stel deze terug op leeg) en elk model keert bij het volgende verzoek terug naar de standaardverbinding — er is geen migratie nodig om de functie uit te schakelen.

