Dane historyczne w MongoDB
Domyślnie każda tabela znajduje się na głównym połączeniu aplikacji (PostgreSQL lub MySQL) — ta funkcja niczego w tym zakresie nie zmienia, chyba że wyraźnie ją włączysz. Samodzielnie hostowane magazyny z dużą ilością historii zapisywanej tylko przez dopisywanie (wpisy dziennika aktywności, transkrypty czatu, historia e-maili CRM) mogą przenieść wyłącznie te tabele na osobne połączenie, w tym MongoDB, bez wpływu na pozostałe elementy.
Co jest przenoszone
- Dziennik aktywności — tabela
activity_log(każdy wpis audytowy dotyczący utworzenia, aktualizacji, usunięcia lub logowania) - Wiadomości czatu — tabela modułu Messaging
msg_messagestabela - Historia e-maili CRM — tabela
crm_email_messagesorazcrm_email_eventstabele
Wszystko inne — zamówienia, produkty, klienci, księgowość — zawsze pozostaje na głównym połączeniu. To rozwiązanie służy wyłącznie do przenoszenia tabel z dużą liczbą rekordów historycznych, które rzadko są łączone z innymi tabelami.
Opcja A: inne połączenie SQL
Skieruj historię do dowolnego połączenia zdefiniowanego już w config/database.php (na przykład drugiej bazy danych Postgres przeznaczonej wyłącznie do logów):
HISTORICAL_DB_CONNECTION=pgsql_history
Działa natychmiast, bez dodatkowych pakietów — to zwykły Eloquent na zwykłym połączeniu SQL.
Opcja B: MongoDB
Szablon połączenia mongodb jest już dołączony w config/database.php ale pozostaje nieaktywny, dopóki nie włączysz tej opcji:
HISTORICAL_DB_CONNECTION=mongodb
MONGODB_URI=mongodb://user:password@host:27017
MONGODB_DATABASE=storeconsole_history
Obsługa MongoDB wymaga dwóch elementów, których ta platforma nie instaluje domyślnie:
- Rozszerzenia
mongodbPHP na serwerze composer require mongodb/laravel-mongodb(wymienionego wsuggestw katalogu głównymcomposer.json)
Bez zainstalowania rozszerzenia i pakietu ustawienie HISTORICAL_DB_CONNECTION=mongodb jest bezpiecznie ignorowane — każdy model korzysta z domyślnego połączenia, a aplikacja uruchamia się i działa dokładnie tak jak wcześniej.
Pełna obsługa modeli MongoDB
Po mongodb/laravel-mongodb zainstalowaniu samodzielne przełączanie połączenia zapewnia dostęp do kolekcji Mongo na poziomie query buildera. Aby uzyskać pełną obsługę Eloquent (rzutowania BSON, klucze główne ObjectId, dokumenty osadzone), dodaj również do modelu pakietu MongoDB\Laravel\Eloquent\DocumentModel trait wraz z traitem obsługującym przełączanie połączeń, który ta platforma jest już dostarczona z modelami historii:
use StoreConsole\PlatformKit\Traits\UsesHistoricalConnection;
use MongoDB\Laravel\Eloquent\DocumentModel;
class Activity extends SpatieActivity
{
use UsesHistoricalConnection;
use DocumentModel;
}
Ponieważ Store Console jest dostarczany jako pełne źródło w ramach licencji, to jednowierszowe rozszerzenie jest standardową modyfikacją własnej kopii, a nie poprawką od dostawcy.
Jak wycofać zmianę
Usuń ustawienie HISTORICAL_DB_CONNECTION (lub ustaw je ponownie na pustą wartość), a każdy model wróci do domyślnego połączenia przy najbliższym żądaniu — wyłączenie funkcji nie wymaga migracji.

