Black Friday salehanggang 60% off
  • 60% off sa unang taon mo sa annual plan
  • 45% off sa mga pangmatagalang lisensya
Magtatapos sa
Kunin ang deal

Historical Data sa MongoDB

Sa default, nasa pangunahing koneksyon ng app mo (PostgreSQL o MySQL) ang bawat table — walang binabago ang feature na ito maliban kung pipiliin mong gamitin. Ang mga self-hosted store na may malaking dami ng append-only history (mga entry sa activity log, transcript ng chat, kasaysayan ng email ng CRM) ay maaaring ilipat ang mga table na iyon lamang sa hiwalay na koneksyon, kasama ang MongoDB, nang hindi binabago ang iba pa.

Ano ang Nailipat

  • Activity log — ang activity_log table (bawat audit entry sa create/update/delete/login)
  • Mga mensahe sa chat — ang table ng msg_messages Messaging module
  • Kasaysayan ng email ng CRM — ang crm_email_messages at crm_email_events na table

Lahat ng iba pa — orders, products, customers, accounting — ay laging nasa pangunahing koneksyon mo. Target lamang ang move na ito para sa mga history table na may malaking volume at bihagang tinutuldan.

Pagpipilian A: Ibang SQL Connection

Ituro ang history sa kahit anong koneksyong nadefine na sa config/database.php (halimbawa, pangalawang database ng Postgres na espesyal para sa logs):

HISTORICAL_DB_CONNECTION=pgsql_history

Gumagana ito agad nang walang karagdagang package — plain Eloquent ito sa plain SQL connection.

Pagpipilian B: MongoDB

May mongodb kasamang connection template sa config/database.php na, ngunit hindi ito aktibo hangga’t hindi mo ito pinipili:

HISTORICAL_DB_CONNECTION=mongodb
MONGODB_URI=mongodb://user:password@host:27017
MONGODB_DATABASE=storeconsole_history

Ang suporta sa MongoDB ay nangangailangan ng dalawang bagay na hindi ini-install ng platform na ito sa default:

  • Ang mongodb PHP extension sa server mo
  • composer require mongodb/laravel-mongodb (nakalista sa ilalim ng suggest sa root composer.json)

Kapag hindi naka-install ang extension at package, HISTORICAL_DB_CONNECTION=mongodb ay ligtas na ini-ignore ang setting — bawat model ay bumabalik sa default connection at ang app ay nagsi-boot at tumatakbo gaya dati.

Buong Suporta sa MongoDB Model

Kapag naka-install na ang mongodb/laravel-mongodb mayroon ka nang access sa Mongo collection sa antas ng query builder sa pamamagitan lamang ng pagpapalit ng koneksyon. Para sa buong suporta sa Eloquent (BSON casts, ObjectId primary keys, embedded documents), idagdag din ang MongoDB\Laravel\Eloquent\DocumentModel trait ng package sa model, kasama ang connection-switching trait na kasama na sa mga history model ng platform na ito:

use StoreConsole\PlatformKit\Traits\UsesHistoricalConnection;
use MongoDB\Laravel\Eloquent\DocumentModel;

class Activity extends SpatieActivity
{
    use UsesHistoricalConnection;
    use DocumentModel;
}

Dahil ang Store Console ay ship bilang full source kada license, ang dagdag na isang linya na ito ay karaniwang customization sa sarili mong kopya — hindi ito vendor patch.

Paano I-revert

Alisin ang HISTORICAL_DB_CONNECTION (o itakda itong pustahan muli) at bawat model ay babalik sa default connection sa susunod na request — walang migration na kailangan para i-off ang feature.

Huling na-update: 11/19/2026