Date istorice în MongoDB
În mod implicit, fiecare tabel se află pe conexiunea principală a aplicației (PostgreSQL sau MySQL) — această funcție nu schimbă nimic în acest sens, cu excepția cazurilor în care activați opțiunea. Stocurile self-hosted cu un volum mare de istoric append-only (intrări în jurnalul de activitate, transcrieri de chat, istoric de e-mailuri CRM) pot muta doar acele tabele pe o conexiune separată, inclusiv MongoDB, fără să afecteze nimic altceva.
Ce se mută
- Jurnal de activitate — tabelul
activity_log(fiecare intrare de audit pentru create/update/delete/login) - Mesaje de chat — tabelul modulului Messaging
msg_messagestabel - Istoric de e-mailuri CRM — tabelul
crm_email_messagesșicrm_email_eventstabelele
Tot restul — comenzi, produse, clienți, contabilitate — rămâne permanent pe conexiunea principală. Aceasta este o mutare direcționată, exclusiv pentru tabelele de istoric cu volum mare și rareori asociate.
Opțiunea A: O altă conexiune SQL
Îndreptați istoricul către orice conexiune deja definită în config/database.php (de exemplu, o a doua bază de date Postgres dedicată jurnalelor):
HISTORICAL_DB_CONNECTION=pgsql_history
Funcționează imediat, fără pachete suplimentare — este Eloquent obișnuit pe o conexiune SQL obișnuită.
Opțiunea B: MongoDB
Un mongodb șablon de conexiune este inclus în config/database.php deja, dar este inactiv până când activați opțiunea:
HISTORICAL_DB_CONNECTION=mongodb
MONGODB_URI=mongodb://user:password@host:27017
MONGODB_DATABASE=storeconsole_history
Suportul pentru MongoDB necesită două elemente pe care această platformă nu le instalează implicit:
- Extensia
mongodbPHP de pe serverul dvs. composer require mongodb/laravel-mongodb(listată însuggestdin rădăcinăcomposer.json)
Fără extensia și pachetul instalate, configurația HISTORICAL_DB_CONNECTION=mongodb este ignorată în siguranță — fiecare model revine la conexiunea implicită, iar aplicația pornește și rulează exact ca înainte.
Suport complet pentru modelele MongoDB
Odată ce mongodb/laravel-mongodb este instalat, simpla schimbare a conexiunii vă oferă acces la colecția MongoDB la nivel de query builder. Pentru suport Eloquent complet (casturi BSON, chei primare ObjectId, documente încorporate), adăugați și trait-ul pachetului MongoDB\Laravel\Eloquent\DocumentModel la model, alături de trait-ul pentru schimbarea conexiunii pe care această platformă îl include deja pentru modelele de istoric:
use StoreConsole\PlatformKit\Traits\UsesHistoricalConnection;
use MongoDB\Laravel\Eloquent\DocumentModel;
class Activity extends SpatieActivity
{
use UsesHistoricalConnection;
use DocumentModel;
}
Deoarece Store Console este livrat cu sursa completă pentru fiecare licență, această adăugare pe o singură linie reprezintă o personalizare normală a propriei copii — nu un patch furnizat de vendor.
Cum să reveniți la configurația inițială
Anulați setarea HISTORICAL_DB_CONNECTION (sau setați-o din nou la valoarea goală), iar fiecare model revine la conexiunea implicită la următoarea cerere — nu este necesară nicio migrare pentru dezactivarea funcției.

