ข้อมูลย้อนหลังบน MongoDB
โดยค่าเริ่มต้น ทุกตารางจะอยู่บน connection หลักของแอป (PostgreSQL หรือ MySQL) — ฟีเจอร์นี้จะไม่เปลี่ยนแปลงนั้น เว้นแต่คุณจะเปิดใช้งาน ร้านที่ self-hosted และมีข้อมูลย้อนหลังแบบ append-only จำนวนมาก (รายการ activity log, บทสนทนา, ประวัติอีเมล CRM) สามารถย้ายเฉพาะตารางเหล่านั้นไปยัง connection แยก รวมถึง MongoDB โดยไม่ต้องแตะต้องส่วนอื่น
สิ่งที่ถูกย้าย
- Activity log — ตาราง
activity_logของ (ทุกรายการ audit การสร้าง/อัปเดต/ลบ/เข้าสู่ระบบ) - ข้อความแชท — ตารางของโมดูล Messaging
msg_messagesตาราง - ประวัติอีเมล CRM — ตาราง
crm_email_messagesและcrm_email_eventsตาราง
ทุกสิ่งอื่น — order, product, customer, งานบัญชี — จะยังคงอยู่บน connection หลักเสมอ นี่เป็นการย้ายเฉพาะตารางประวัติที่มีข้อมูลปริมาณมากและไม่ค่อยถูก join เท่านั้น
ตัวเลือก A: SQL Connection อีกรายการ
กำหนดประวัติให้ใช้ connection ใดก็ได้ที่กำหนดไว้แล้วใน config/database.php (ตัวอย่างเช่น PostgreSQL database ฐานที่สองสำหรับเก็บ log):
HISTORICAL_DB_CONNECTION=pgsql_history
ใช้งานได้ทันทีโดยไม่ต้องติดตั้ง package เพิ่มเติม — เป็น Eloquent บน SQL connection ปกติ
ตัวเลือก B: MongoDB
มี mongodb connection template สำเร็จรูปติดตั้งมาพร้อมใน config/database.php อยู่แล้ว แต่จะไม่มีผลจนกว่าคุณจะเปิดใช้งาน:
HISTORICAL_DB_CONNECTION=mongodb
MONGODB_URI=mongodb://user:password@host:27017
MONGODB_DATABASE=storeconsole_history
การรองรับ MongoDB ต้องมีสองสิ่งที่ platform ไม่ได้ติดตั้งไว้โดยค่าเริ่มต้น:
- PHP extension บน
mongodbserver ของคุณ composer require mongodb/laravel-mongodb(อยู่ในรายการsuggestใน rootcomposer.json)
หากไม่ได้ติดตั้ง extension และ package การตั้งค่า HISTORICAL_DB_CONNECTION=mongodb จะถูกข้ามอย่างปลอดภัย — ทุกโมเดลจะกลับไปใช้ connection เริ่มต้น และแอปจะบูตและทำงานเหมือนเดิมทุกประการ
การรองรับโมเดล MongoDB แบบเต็มรูปแบบ
เมื่อติดตั้งแล้ว mongodb/laravel-mongodb การสลับ connection เพียงอย่างเดียวจะทำให้คุณเข้าถึง Mongo collection ได้ในระดับ query builder หากต้องการการรองรับ Eloquent แบบเต็มรูปแบบ (BSON casts, ObjectId primary keys, embedded documents) ให้เพิ่ม trait ของ package ลงในโมเดล ควบคู่กับ trait สำหรับสลับ connection ที่ platform ติดตั้งมาให้กับโมเดลประวัติอยู่แล้ว: MongoDB\Laravel\Eloquent\DocumentModel trait ลงในโมเดล ควบคู่กับ trait สำหรับสลับ connection ที่ platform ติดตั้งมาให้กับโมเดลประวัติอยู่แล้ว:
use StoreConsole\PlatformKit\Traits\UsesHistoricalConnection;
use MongoDB\Laravel\Eloquent\DocumentModel;
class Activity extends SpatieActivity
{
use UsesHistoricalConnection;
use DocumentModel;
}
เนื่องจาก Store Console มาพร้อม source code เต็มรูปแบบในแต่ละ license การเพิ่มโค้ดหนึ่งบรรทัดนี้จึงถือเป็นการปรับแต่งโค้ดของคุณเองตามปกติ ไม่ใช่ vendor patch
วิธีย้อนกลับ
ยกเลิกการตั้งค่า HISTORICAL_DB_CONNECTION (หรือตั้งกลับเป็นค่าว่าง) แล้วทุกโมเดลจะกลับไปใช้ connection เริ่มต้นใน request ถัดไป — ไม่ต้องใช้ migration เพื่อปิดฟีเจอร์นี้

