Dati storici su MongoDB
Per impostazione predefinita, ogni tabella si trova sulla connessione principale della tua app (PostgreSQL o MySQL) — questa funzionalità non modifica nulla in tal senso, a meno che non opti esplicitamente. Gli store self-hosted con molta cronologia append-only (voci del registro attività, trascrizioni delle chat, cronologia email del CRM) possono spostare solo le relative tabelle su una connessione separata, inclusa MongoDB, senza toccare tutto il resto.
Che cosa viene spostato
- Registro attività — la
activity_logtabella (ogni voce di audit per creazione/aggiornamento/eliminazione/login) - Messaggi della chat — del modulo Messaging la
msg_messagestabella - Cronologia email del CRM — la
crm_email_messagese lecrm_email_eventstabelle
Tutto il resto — ordini, prodotti, clienti, contabilità — resta sempre sulla connessione principale. Questo è uno spostamento mirato, intended esclusivamente per tabelle di cronologia ad alto volume e raramente coinvolte in join.
Opzione A: Un'altra connessione SQL
Indica la cronologia su una connessione qualsiasi già definita in config/database.php (ad esempio, un secondo database Postgres dedicato ai log):
HISTORICAL_DB_CONNECTION=pgsql_history
Funziona immediatamente senza pacchetti aggiuntivi — è Eloquent puro su una connessione SQL pura.
Opzione B: MongoDB
Un mongodb template di connessione è già incluso in config/database.php ma resta inattivo finché non opti esplicitamente:
HISTORICAL_DB_CONNECTION=mongodb
MONGODB_URI=mongodb://user:password@host:27017
MONGODB_DATABASE=storeconsole_history
Il supporto per MongoDB richiede due elementi che questa piattaforma non installa per impostazione predefinita:
- L'
mongodbestensione PHP sul tuo server composer require mongodb/laravel-mongodb(elencata insuggestnella rootcomposer.json)
Senza l'estensione e il pacchetto installati, l'impostazione HISTORICAL_DB_CONNECTION=mongodb viene ignorata in sicurezza — ogni model ricade sulla connessione predefinita e l'app si avvia ed è operativa esattamente come prima.
Supporto completo per i model MongoDB
Una volta mongodb/laravel-mongodb installato, il solo passaggio a un'altra connessione ti consente di accedere alla raccolta MongoDB tramite il query builder. Per il supporto completo di Eloquent (cast BSON, chiavi primarie ObjectId, documenti incorporati), aggiungi anche il trait del pacchetto MongoDB\Laravel\Eloquent\DocumentModel al model, insieme al trait per il passaggio di connessione che questa piattaforma include già nei model della cronologia:
use StoreConsole\PlatformKit\Traits\UsesHistoricalConnection;
use MongoDB\Laravel\Eloquent\DocumentModel;
class Activity extends SpatieActivity
{
use UsesHistoricalConnection;
use DocumentModel;
}
Poiché Store Console viene distribuito come codice sorgente completo per licenza, questa aggiunta di una riga rappresenta una normale personalizzazione della tua copia — non una patch del fornitore.
Come ripristinare
Rimuovi HISTORICAL_DB_CONNECTION (o impostalo di nuovo su un valore vuoto) e ogni model tornerà alla connessione predefinita alla richiesta successiva — non è necessaria alcuna migration per disattivare la funzionalità.

