Khuyến mãi Black Fridaygiảm đến 60%
  • Giảm 60% năm đầu với gói thường niên
  • Giảm 45% giấy phép trọn đời
Kết thúc sau
Nhận ưu đãi

Dữ liệu lịch sử trên MongoDB

Theo mặc định, mọi bảng đều nằm trên kết nối chính của ứng dụng (PostgreSQL hoặc MySQL) — tính năng này không thay đổi điều đó trừ khi bạn chủ động bật. Các cửa hàng tự lưu trữ có lượng lịch sử chỉ ghi thêm lớn (mục nhật ký hoạt động, bản ghi trò chuyện, lịch sử email CRM) có thể chuyển riêng những bảng đó sang một kết nối khác, bao gồm MongoDB, mà không ảnh hưởng đến bất kỳ thành phần nào khác.

Nội dung được chuyển

  • Nhật ký hoạt động — bảng activity_log (mọi mục kiểm toán create/update/delete/login)
  • Tin nhắn trò chuyện — bảng của module Messaging msg_messages tin nhắn
  • Lịch sử email CRM — bảng crm_email_messages và crm_email_events các bảng

Mọi nội dung khác — đơn hàng, sản phẩm, khách hàng, kế toán — luôn nằm trên kết nối chính. Đây chỉ là giải pháp chuyển dữ liệu có mục đích dành riêng cho các bảng lịch sử khối lượng lớn, hiếm khi cần join.

Tùy chọn A: Kết nối SQL khác

Trỏ dữ liệu lịch sử đến bất kỳ kết nối nào đã được định nghĩa trong config/database.php (ví dụ: cơ sở dữ liệu Postgres thứ hai dành riêng cho log):

HISTORICAL_DB_CONNECTION=pgsql_history

Tính năng này hoạt động ngay lập tức mà không cần cài thêm package — Eloquent thuần trên một kết nối SQL thuần.

Tùy chọn B: MongoDB

Một mongodb mẫu kết nối đã được cung cấp sẵn trong config/database.php nhưng sẽ không hoạt động cho đến khi bạn chủ động bật:

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

Hỗ trợ MongoDB yêu cầu hai thứ mà nền tảng này không cài đặt theo mặc định:

  • PHP extension mongodb trên máy chủ của bạn
  • composer require mongodb/laravel-mongodb (được liệt kê trong suggest ở thư mục gốc composer.json)

Nếu chưa cài extension và package, thiết lập HISTORICAL_DB_CONNECTION=mongodb sẽ được bỏ qua một cách an toàn — mọi model sẽ dùng lại kết nối mặc định và ứng dụng khởi động, vận hành y hệt như trước.

Hỗ trợ Model MongoDB đầy đủ

Sau khi mongodb/laravel-mongodb được cài đặt, chỉ riêng việc chuyển kết nối đã cho phép truy cập collection Mongo ở mức query builder. Để có hỗ trợ Eloquent đầy đủ (BSON casts, khóa chính ObjectId, tài liệu nhúng), bạn cũng cần thêm MongoDB\Laravel\Eloquent\DocumentModel trait của package vào model, cùng với trait chuyển kết nối mà nền tảng này đã cung cấp cho các model lịch sử:

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

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

Vì Store Console được cung cấp đầy đủ mã nguồn theo từng giấy phép, thay đổi một dòng này là tùy biến thông thường trên bản sao của bạn — không phải bản vá từ nhà cung cấp.

Cách hoàn tác

Bỏ đặt HISTORICAL_DB_CONNECTION (hoặc đặt lại thành rỗng) và mọi model sẽ trở về kết nối mặc định ở request tiếp theo — không cần migration để tắt tính năng.

Cập nhật lần cuối: 11/19/2026