Black Friday saleتا 60% تخفیف
  • 60% تخفیف سال اول برای طرح‌های سالانه
  • 45% تخفیف لایسنس‌های مادام‌العمر
پایان در
دریافت پیشنهاد

داده‌های تاریخی روی 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 به دو مورد نیاز دارد که این پلتفرم آن‌ها را به‌طور پیش‌فرض نصب نمی‌کند:

  • اکسپنشن mongodb PHP روی سرور شما
  • 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 نیست.

آخرین به‌روزرسانی: 11/19/2026