دادههای تاریخی روی MongoDB
بهطور پیشفرض، هر جدول روی اتصال اصلی اپلیکیشن شما (PostgreSQL یا MySQL) قرار دارد — این قابلیت تا زمانی که آن را فعال نکنید، هیچیک از این موارد را تغییر نمیدهد. فروشگاههای self-hosted با حجم زیادی از دادههای تاریخی append-only (ورودیهای گزارش فعالیت، متن گفتگوها، تاریخچه ایمیل CRM) میتوانند فقط همان جداول را به اتصالی جداگانه، از جمله MongoDB، منتقل کنند، بدون تغییر در سایر بخشها.
آنچه منتقل میشود
- گزارش فعالیت — جدول
activity_log(هر ورودی حسابرسی مربوط به create/update/delete/login) - پیامهای چت — ماژول Messaging
msg_messagesجدول - تاریخچه ایمیل CRM — جدول
crm_email_messagesوcrm_email_eventsجداول
همه موارد دیگر — سفارشها، محصولات، مشتریان و امور مالی — همیشه روی اتصال اصلی شما باقی میمانند. این قابلیت فقط برای انتقال هدفمند جداول تاریخی با حجم بالا که بهندرت در join استفاده میشوند در نظر گرفته شده است.
گزینه A: اتصال SQL دیگر
تاریخچه را به هر اتصال از پیش تعریفشده در config/database.php (برای مثال، یک پایگاهداده دوم Postgres مخصوص logها) متصل کنید:
HISTORICAL_DB_CONNECTION=pgsql_history
این روش بلافاصله و بدون نصب بسته اضافی کار میکند — Eloquent معمولی روی یک اتصال SQL معمولی است.
گزینه B: MongoDB
یک mongodb قالب اتصال در config/database.php ارائه شده است، اما تا زمانی که آن را فعال نکنید، غیرفعال باقی میماند:
HISTORICAL_DB_CONNECTION=mongodb
MONGODB_URI=mongodb://user:password@host:27017
MONGODB_DATABASE=storeconsole_history
پشتیبانی MongoDB به دو مورد نیاز دارد که این پلتفرم آنها را بهطور پیشفرض نصب نمیکند:
- اکسپنشن
mongodbPHP روی سرور شما composer require mongodb/laravel-mongodb(که درsuggestدر ریشهcomposer.json) فهرست شده است)
بدون نصب اکسپنشن و بسته، تنظیم HISTORICAL_DB_CONNECTION=mongodb بهطور ایمن نادیده گرفته میشود — همه مدلها به اتصال پیشفرض بازمیگردند و اپلیکیشن دقیقاً مانند قبل اجرا میشود.
پشتیبانی کامل مدل MongoDB
پس از نصب mongodb/laravel-mongodb ، صرفاً تعویض اتصال، دسترسی در سطح query builder به collection مربوط به MongoDB را فراهم میکند. برای پشتیبانی کامل Eloquent (BSON casts، کلیدهای اصلی ObjectId و اسناد جاسازیشده)، trait بسته را نیز به مدل اضافه کنید؛ در کنار trait تعویض اتصالی که این پلتفرم از قبل برای مدلهای تاریخی ارائه میکند: MongoDB\Laravel\Eloquent\DocumentModel از آنجا که Store Console بر اساس هر لایسنس بهصورت کد منبع کامل ارائه میشود، این افزودن تکخطی یک شخصیسازی عادی روی نسخه خودتان محسوب میشود — نه patch ارائهشده توسط vendor.
use StoreConsole\PlatformKit\Traits\UsesHistoricalConnection;
use MongoDB\Laravel\Eloquent\DocumentModel;
class Activity extends SpatieActivity
{
use UsesHistoricalConnection;
use DocumentModel;
}
چون Store Console بر اساس هر لایسنس بهصورت کد منبع کامل ارائه میشود، این افزودن تکخطی یک شخصیسازی عادی روی نسخه خودتان است — نه patch ارائهشده توسط vendor.
نحوه بازگشت به حالت قبل
مقدار را پاک کنید HISTORICAL_DB_CONNECTION (یا دوباره خالی تنظیم کنید) تا همه مدلها در درخواست بعدی به اتصال پیشفرض بازگردند — برای غیرفعالکردن این قابلیت نیازی به migration نیست.

