Meilisearch là công cụ tìm kiếm mã nguồn mở viết bằng ngôn ngữ Rust, nổi tiếng với tốc độ phản hồi dưới 50ms, khả năng chịu lỗi chính tả, hiểu tiếng Việt không dấu ngay từ mặc định và đặc biệt nhẹ tài nguyên hơn rất nhiều so với Elasticsearch. Nếu bạn đang vận hành website WordPress hoặc WooCommerce trên Linux VPS và muốn trải nghiệm tìm kiếm ngang ngửa các sàn thương mại điện tử lớn — từ trang khách, AJAX Live Search cho tới tận bên trong trang quản trị WP-Admin — mà không phải trả phí thuê bao hàng tháng đắt đỏ như Algolia, Meilisearch là lựa chọn đáng triển khai nhất năm 2026.
Lưu ý điều kiện bắt buộc trước khi đọc: Bài hướng dẫn này chỉ dành cho website chạy trên VPS hoặc Máy chủ riêng (Dedicated Server) có tài khoản
root/ quyềnsudo. Nếu bạn đang sử dụng Shared Hosting thì không thể triển khai cách này, vì Shared Hosting không cho phép truy cập quyềnrootđể cài đặt dịch vụ hệ thống, chạy tiến trình nền (systemd) hay chạy container Podman.
1. Meilisearch là gì? 6 lợi ích “ăn tiền” cho WordPress & WooCommerce
Thay vì bắt MariaDB/MySQL quét tuần tự từng dòng dữ liệu nặng nề bằng câu lệnh LIKE '%tu-khoa%' như tìm kiếm mặc định của WordPress, Meilisearch hoạt động như một máy chủ chỉ mục (Search Engine) độc lập nằm ngay trên VPS của bạn. Mỗi khi bạn đăng, sửa hoặc xóa bài viết/sản phẩm, dữ liệu sẽ được đồng bộ tức thì sang Meilisearch để phục vụ truy vấn tìm kiếm gần như không có độ trễ.
- Tốc độ phản hồi dưới 50ms: Nhờ kiến trúc tối ưu viết bằng Rust và lưu trữ chỉ mục qua LMDB, truy vấn tìm kiếm trả kết quả chỉ trong vài mili-giây mà không bắt MariaDB/MySQL phải quét toàn bảng
wp_posts. - Meilisearch là phần mềm nguồn mở: Meilisearch trên GitHub. Nghe nguồn mở là thấy tuyệt vời rồi (dự án mà giá trị dù bên đó không phát triển nữa thì sẽ có người khác fork phát triển tiếp — một sự vững tin về độ bền vững, đồng thời miễn phí và mã nguồn rất minh bạch, có cái gì thì cộng đồng đều biết rõ).
- Hỗ trợ tiếng Việt không dấu & chịu lỗi chính tả cực mượt: Bộ tách từ Charabia tích hợp sẵn trong Meilisearch chuẩn hóa rất tốt dấu thanh tiếng Việt và tự động sửa lỗi gõ nhầm. Khách gõ “dien thoai iphon 17” hay “toi uu toc do web” vẫn trả về chính xác “Điện thoại iPhone 17” và “Tối ưu tốc độ website” mà không cần cấu hình phức tạp.
- Giảm tải CPU/Database triệt để: Loại bỏ hoàn toàn tình trạng nghẽn MySQL khi nhiều người cùng tìm kiếm, khi khách gõ liên tục vào ô Live Search AJAX, khi nhân viên tìm bài/sản phẩm trong
wp-adminhoặc khi bot spam xả truy vấn?s=vào website. - Tăng tốc cả tìm kiếm trong WP-Admin Dashboard: Không chỉ khách hàng ngoài web được hưởng lợi, đội ngũ quản trị và bán hàng khi tìm bài viết hoặc tìm sản phẩm WooCommerce theo Tên, SKU cha, SKU biến thể hay ID ngay trong trang quản trị (
edit.php) cũng mượt mà tức thì kể cả khi gõ không dấu. - Sẵn sàng cho tìm kiếm AI (Hybrid Search): Các phiên bản Meilisearch hiện đại hỗ trợ sẵn Tìm kiếm lai (Hybrid Search) — kết hợp tìm kiếm từ khóa truyền thống với tìm kiếm ngữ nghĩa Vector AI khi bạn muốn mở rộng về sau.
2. So sánh: Meilisearch vs WordPress mặc định vs Elasticsearch vs Algolia
| Tiêu chí | WordPress mặc định | Meilisearch (Self-host) | Elasticsearch (Self-host) | Algolia Search (Cloud SaaS) |
|---|---|---|---|---|
| Tốc độ phản hồi | Chậm (300ms – vài giây khi nhiều bài) | Siêu nhanh (dưới 50ms) | Nhanh (50ms – 150ms) | Siêu nhanh (dưới 50ms toàn cầu) |
| Tiếng Việt không dấu & Lỗi chính tả | Rất kém (phải khớp đúng từng chữ) | Rất tốt ngay từ mặc định | Phải cài thêm plugin phân tích tiếng Việt & tự tinh chỉnh | Xuất sắc |
| Tài nguyên VPS yêu cầu | Gây quá tải CPU/MySQL khi traffic cao | Nhẹ (chạy tốt từ 512MB – 1GB RAM trống) | Rất nặng (chạy JVM, tối thiểu 2GB – 4GB RAM riêng) | Không tốn RAM VPS (chạy trên Cloud của hãng) |
| Độ khó cài đặt & vận hành | Có sẵn | Đơn giản (10 phút cấu hình xong) | Phức tạp (cấu hình cluster, heap JVM, mapping dài dòng) | Dễ (chỉ cần nhập API Key) |
| Chi phí dài hạn | Miễn phí | Miễn phí 100% (tận dụng ngay VPS sẵn có) | Miễn phí phần mềm nhưng tốn tiền nâng cấp VPS | Đắt khi traffic lớn (tính phí theo số bản ghi & lượt tìm kiếm) |
| Hỗ trợ WooCommerce (SKU, Biến thể & Admin) | Tìm SKU chậm, không chịu lỗi gõ sai | Rất tốt (cả Frontend, AJAX lẫn WP-Admin) | Rất mạnh (phù hợp dữ liệu hàng triệu dòng) | Tốt (mạnh ở Frontend) |
| Phù hợp nhất cho | Blog nhỏ dưới 100 bài viết | Blog lớn, Web tin tức, Shop WooCommerce từ 500 – 100.000+ sản phẩm trên VPS | Tập đoàn lớn, hệ thống Big Data / Log Analytics | Doanh nghiệp ngân sách tốt, cần tìm kiếm đa quốc gia không muốn tự quản trị server |
Tóm gọn: Với phần lớn website WordPress và WooCommerce chạy trên VPS Linux hiện nay, Meilisearch là điểm cân bằng hoàn hảo nhất — mang lại trải nghiệm tiệm cận Algolia nhưng miễn phí như Elasticsearch, đồng thời nhẹ RAM và dễ triển khai hơn Elasticsearch gấp nhiều lần.
3. Điều kiện bắt buộc & Yêu cầu hệ thống trên Linux
- Quyền truy cập máy chủ (Bắt buộc): Phải có VPS hoặc Máy chủ riêng chạy Linux kèm tài khoản
root(hoặc user có quyềnsudo) và truy cập được qua SSH. Người dùng Shared Hosting không thể tự cài đặt dịch vụ Meilisearch lên máy chủ — nếu dùng Shared Hosting, bạn chỉ có thể thuê dịch vụ Meilisearch Cloud / Algolia hoặc dùng các plugin tìm kiếm nội bộ như FiboSearch/Relevanssi. - Tài nguyên khuyên dùng: Tối thiểu 512MB RAM trống cho website dưới 10.000 bài/sản phẩm; từ 1GB – 2GB RAM trống cho shop lớn 20.000 – 100.000 sản phẩm.
- Hệ điều hành chạy trực tiếp file Binary (có sẵn GLIBC từ 2.35 trở lên): Ubuntu 22.04 / 24.04 / 26.04, Debian 12+, AlmaLinux 10 / Rocky Linux 10.
- Hệ điều hành AlmaLinux 8 / 9 & Rocky Linux 8 / 9: Các bản này chỉ dùng
GLIBC 2.28 / 2.34nên tải file binary dựng sẵn sẽ báo lỗiGLIBC_2.35 not found. Hãy dùng Cách 4B (cài bằng Podman) ngay bên dưới — tuyệt đối không tự nâng cấp GLIBC hệ thống vì sẽ làm hỏng VPS. - Mô hình kết nối nội bộ (
127.0.0.1:7700): WordPress (PHP) gọi trực tiếp sang Meilisearch qua loopback nội bộ trên cùng một VPS. Độ trễ dưới 1ms, không mở cổng tường lửa ra Internet, không cần Reverse Proxy và tuyệt đối không lo lộ API Key.
4. Cài đặt Meilisearch từ A đến Z trên Linux VPS
Đăng nhập SSH vào VPS bằng quyền root (hoặc chạy sudo -i), chạy lệnh ldd --version | head -n 1 để kiểm tra phiên bản GLIBC của hệ điều hành và chọn đúng 1 trong 2 cách cài đặt dưới đây:
Cách 4A: Cài trực tiếp Binary (Ubuntu 22.04/24.04/26.04, Debian 12+, AlmaLinux 10)
Bước 1: Tải file binary Meilisearch mới nhất và tạo tài khoản hệ thống riêng (không chạy tiến trình Meilisearch bằng quyền root):
# Đảm bảo đã có curl
# Trên Ubuntu/Debian: apt update && apt install -y curl
# Trên AlmaLinux 10: dnf install -y curl
cd /tmp
curl -L https://install.meilisearch.com | sh
mv /tmp/meilisearch /usr/local/bin/meilisearch
chmod 755 /usr/local/bin/meilisearch
# Kiểm tra phiên bản vừa cài
meilisearch --version
# Tạo user hệ thống riêng và thư mục lưu dữ liệu
useradd --system --no-create-home --shell /usr/sbin/nologin meilisearch
mkdir -p /var/lib/meilisearch/data.ms /var/lib/meilisearch/dumps /var/lib/meilisearch/snapshots
chown -R meilisearch:meilisearch /var/lib/meilisearch
chmod 750 /var/lib/meilisearchBước 2: Sinh Master Key bảo mật và tạo tệp cấu hình /etc/meilisearch.toml:
MASTER_KEY=$(openssl rand -hex 32)
echo "Luu lai Master Key cua ban: ${MASTER_KEY}"
cat <<EOF > /etc/meilisearch.toml
env = "production"
master_key = "${MASTER_KEY}"
http_addr = "127.0.0.1:7700"
db_path = "/var/lib/meilisearch/data.ms"
dump_dir = "/var/lib/meilisearch/dumps"
snapshot_dir = "/var/lib/meilisearch/snapshots"
no_analytics = true
log_level = "WARN"
# Giới hạn tài nguyên khi lập chỉ mục để không làm treo VPS / PHP / MariaDB
max_indexing_memory = "512 MiB"
max_indexing_threads = 2
EOF
chown meilisearch:meilisearch /etc/meilisearch.toml
chmod 600 /etc/meilisearch.tomlBước 3: Tạo dịch vụ Systemd tự khởi động cùng VPS:
cat <<'EOF' > /etc/systemd/system/meilisearch.service
[Unit]
Description=Meilisearch Search Engine
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
User=meilisearch
Group=meilisearch
WorkingDirectory=/var/lib/meilisearch
ExecStart=/usr/local/bin/meilisearch --config-file-path /etc/meilisearch.toml
Restart=on-failure
RestartSec=5
NoNewPrivileges=true
PrivateTmp=true
ProtectSystem=full
[Install]
WantedBy=multi-user.target
EOF
systemctl daemon-reload
systemctl enable --now meilisearch
sleep 2
systemctl status meilisearch --no-pagerCách 4B: Cài bằng Podman cho AlmaLinux 8 / 9 & Rocky Linux 8 / 9 (Chuẩn cả KVM & LXC)
Trên AlmaLinux 8/9 / Rocky 8/9, chúng ta dùng Podman (tích hợp sẵn trong kho chính thức, không chạy daemon nền tốn RAM như Docker) kết hợp chế độ --network=host và MEILI_HTTP_ADDR=127.0.0.1:7700 (chỉ lắng nghe nội bộ, không mở port ra ngoài Internet). Đoạn lệnh dưới đây đã tích hợp sẵn bản vá lỗi open /proc/sys/net/ipv4/ping_group_range: Permission denied (rất hay gặp khi chạy Podman trên VPS dạng LXC Container) và tự động nhận diện SELinux:
# 1. Cài đặt Podman và kéo sẵn image Meilisearch chính chủ
dnf install -y podman
podman pull docker.io/getmeili/meilisearch:latest
# 2. Tắt default_sysctls mặc định để fix lỗi "ping_group_range: Permission denied" trên LXC
# (Hoàn toàn an toàn khi áp dụng cho cả VPS KVM thông thường)
mkdir -p /etc/containers/containers.conf.d
cat <<'EOF' > /etc/containers/containers.conf.d/99-lxc.conf
[containers]
default_sysctls = []
EOF
# 3. Sinh Master Key mạnh và tạo file cấu hình môi trường (chỉ lắng nghe 127.0.0.1:7700)
MASTER_KEY=$(openssl rand -hex 32)
echo "Luu lai Master Key cua ban: ${MASTER_KEY}"
mkdir -p /var/lib/meilisearch
cat <<EOF > /etc/meilisearch.env
MEILI_ENV=production
MEILI_MASTER_KEY=${MASTER_KEY}
MEILI_HTTP_ADDR=127.0.0.1:7700
MEILI_NO_ANALYTICS=true
MEILI_LOG_LEVEL=WARN
MEILI_MAX_INDEXING_MEMORY=512MiB
MEILI_MAX_INDEXING_THREADS=2
EOF
chmod 600 /etc/meilisearch.env
# 4. Tự động kiểm tra SELinux để gắn nhãn volume :Z phù hợp
VOL_OPT=""
command -v getenforce >/dev/null && [ "$(getenforce)" = "Enforcing" ] && VOL_OPT=":Z"
# 5. Tạo dịch vụ Systemd tự khởi động cùng VPS
cat <<EOF > /etc/systemd/system/meilisearch.service
[Unit]
Description=Meilisearch Search Engine (Podman)
After=network-online.target
Wants=network-online.target
[Service]
Type=simple
Restart=on-failure
RestartSec=5
ExecStartPre=-/usr/bin/podman rm -f meilisearch
ExecStart=/usr/bin/podman run --rm --name meilisearch \\
--network=host \\
--env-file /etc/meilisearch.env \\
--volume /var/lib/meilisearch:/meili_data${VOL_OPT} \\
docker.io/getmeili/meilisearch:latest
ExecStop=/usr/bin/podman stop -t 15 meilisearch
[Install]
WantedBy=multi-user.target
EOF
# 6. Khởi chạy và kiểm tra trạng thái
systemctl daemon-reload
systemctl enable --now meilisearch
sleep 3
systemctl status meilisearch --no-pagerKiểm tra máy chủ Meilisearch & tạo API Key giới hạn riêng cho từng website (Chuẩn bảo mật Multi-Site)
# Kiểm tra trạng thái sống của Meilisearch
curl -s http://127.0.0.1:7700/health; echoKết quả trả về chính xác {"status":"available"} là máy chủ tìm kiếm đã hoạt động hoàn hảo. Tiếp theo, thay vì dùng chung Default Admin API Key cho nhiều website trên cùng VPS (dễ rủi ro lộ chéo nếu 1 website bị hack), chuẩn bảo mật Enterprise là tạo một API Key riêng chỉ có quyền thao tác trên đúng Index của website đó:
# Thay YOUR_MASTER_KEY bằng Master Key vừa sinh ở trên
# Nếu VPS có nhiều web, đổi "giatuandz" thành tiền tố riêng cho từng web (ví dụ: "wptangtoc_posts", "shopabc_posts" - KHÔNG dùng dấu chấm ".")
curl -s -X POST "http://127.0.0.1:7700/keys" \
-H "Authorization: Bearer YOUR_MASTER_KEY" \
-H "Content-Type: application/json" \
--data-binary '{
"name": "WordPress Key - giatuandz",
"description": "Key gioi han quyen rieng cho index giatuandz",
"actions": ["search", "indexes.create", "documents.*", "settings.*", "stats.get", "tasks.get"],
"indexes": ["giatuandz"],
"expiresAt": null
}'; echoCopy chuỗi nằm trong trường "key" vừa trả về để khai báo vào wp-config.php ở Bước 5. (Nếu VPS có thêm website thứ 2, chạy lại lệnh trên với tên index mới như shopabc_posts để cấp key riêng biệt hoàn toàn.)
5. Tích hợp Meilisearch vào WordPress bằng MU-Plugin (Blog, WooCommerce, AJAX & WP-Admin)
Thay vì cài thêm các plugin tìm kiếm cồng kềnh dễ tạo bảng rác trong database hoặc phải sửa thẳng vào file gốc của theme (dễ mất code mỗi khi cập nhật theme), giải pháp sạch, nhẹ và bền vững nhất ổn định cho tình huống trình kết nối search cho VPS là dùng một tệp MU-Plugin (Must-Use Plugin) thuần PHP đặt tại wp-content/mu-plugins/wptt-meilisearch.php.
Đoạn code dưới đây được thiết kế an toàn cho mọi loại website WordPress — dù bạn chỉ làm blog thuần, web tin tức hay shop WooCommerce lớn:
- Tự động nhận diện môi trường Blog vs WooCommerce (và hỗ trợ mở rộng Page/CPT): Mặc định hệ thống chỉ lập chỉ mục
post(và tự bật thêmproductnếu có WooCommerce) để giữ kết quả tìm kiếm sạch, không bị lẫn các trang Giỏ hàng/Thanh toán/Liên hệ. Nếu bạn muốn tìm cảpagehoặc Custom Post Type khác, chỉ cần khai báo thêm 1 dòngWPTT_MEILI_POST_TYPEStrongwp-config.php. - Tìm kiếm siêu mượt ngay trong WP-Admin Dashboard (
edit.php): Hỗ trợ tìm bài viết và sản phẩm WooCommerce (theo tên, SKU cha, SKU biến thể, ID) ngay trên mọi tab quản trị (Tất cả, Đã xuất bản, Bản nháp, Chờ duyệt, Riêng tư, Thùng rác), chặn sạch truy vấn SQL nặng mặc định của WooCommerce nhưng vẫn giữ nguyên bộ lọc Danh mục, Ngày tháng, Tác giả và sắp xếp theo cột. - Tách biệt bảo mật tuyệt đối (
public = true): Mọi truy vấn ngoài trang khách và AJAX Live Search luôn tự động gắn bộ lọcpublic = true— đảm bảo không bao giờ lọt bản nháp, bài riêng tư, thùng rác, bài có mật khẩu hay sản phẩm ẩn khỏi tìm kiếm ra ngoài trang công khai. - Cầu dao bảo vệ (Circuit Breaker) & Chống nghẽn khi Import: Nếu Meilisearch gặp lỗi hoặc đang khởi động lại, hệ thống tự động ngắt kết nối tạm trong 60 giây và chuyển thẳng về tìm kiếm mặc định của WordPress ở mức 0ms; đồng thời tự động tạm ngưng đồng bộ lẻ khi WordPress đang chạy tiến trình Import hàng loạt (
WP_IMPORTING). - Kiểm tra an toàn cho AJAX Live Search: Tự động bắt các truy vấn AJAX nằm trong danh sách cho phép (Flatsome, WoodMart…) mà không cần sửa file theme, và hỗ trợ cờ
'wptt_meili' => truecho các truy vấnWP_Querytự viết. - Đồng bộ theo lô ở hook
shutdown& Bảo mật Header chẩn đoán: Gom toàn bộ thay đổi vào cuối request để WooCommerce/ACF luôn lưu xong meta trước khi đẩy sang Meilisearch; headerX-WPTT-Searchchỉ hiển thị cho Admin đang đăng nhập.
Bước 1: Khai báo thông số kết nối & Quy tắc đặt tiền tố WPTT_MEILI_INDEX trong wp-config.php
Mở tệp wp-config.php ở thư mục gốc website và dán 3 dòng sau vào phía trên dòng /* That's all, stop editing! Happy publishing. */ (bắt buộc phải nằm phía trên dòng require_once ABSPATH . 'wp-settings.php';):
define( 'WPTT_MEILI_HOST', 'http://127.0.0.1:7700' );
define( 'WPTT_MEILI_ADMIN_KEY', 'DAN_SCOPED_API_KEY_RIENG_CUA_WEB_VAO_DAY' );
define( 'WPTT_MEILI_INDEX', 'giatuandz' );
// Tùy chọn 1: nếu bạn muốn tìm kiếm cả Trang (page) hoặc Custom Post Type khác (mặc định chỉ lấy post và product để tránh lẫn trang Giỏ hàng/Thanh toán), bỏ dấu // ở dòng dưới và chạy lại sync --reset:
// define( 'WPTT_MEILI_POST_TYPES', 'post,page,product' );
// Tùy chọn 2: nếu chỉ muốn dùng Meilisearch ngoài trang khách, KHÔNG dùng trong WP-Admin Dashboard, bỏ dấu // ở dòng dưới:
// define( 'WPTT_MEILI_ADMIN', false );
// Tùy chọn 3: nếu website không dùng AJAX Live Search và muốn tắt hẳn tính năng bắt AJAX, bỏ dấu // ở dòng dưới:
// define( 'WPTT_MEILI_AJAX', false );
// Tùy chọn 4: chỉ bật tạm dòng dưới nếu bạn muốn test header X-WPTT-Search bằng lệnh curl không đăng nhập (test xong nhớ xóa đi):
// define( 'WPTT_MEILI_DEBUG_HEADER', true );Hướng dẫn chi tiết về tiền tố
WPTT_MEILI_INDEX(Cực kỳ quan trọng nếu VPS chạy nhiều website):WPTT_MEILI_INDEXđóng vai trò như tiền tố bảng database (wp_) để tách biệt kho chỉ mục của từng website bên trong Meilisearch:
• VPS chỉ chạy 1 website: Giữ nguyên'giatuandz'là dùng được ngay.
• VPS chạy nhiều website WordPress: Bắt buộc đặt tiền tố riêng cho từng website để dữ liệu không ghi đè lẫn nhau. Ví dụ: websitewptangtoc.comđặt'wptangtoc_posts'; websiteshopabc.vnđặt'shopabc_posts'.
• Quy tắc đặt tên hợp lệ: Chỉ dùng chữ cái không dấu (a-z,A-Z), chữ số (0-9), gạch ngang (-) và gạch dưới (_). Tuyệt đối không dùng dấu chấm.(ví dụwptangtoc.com_postssẽ bị Meilisearch báo lỗiinvalid_index_uid).
• Phải khớp 100% ở 2 nơi: Tên điền vàoWPTT_MEILI_INDEXtrongwp-config.phpphải giống hệt từng ký tự với tên trong trường"indexes": ["..."]lúc tạo Scoped API Key ở Mục 4 — nếu lệch tên, Meilisearch sẽ từ chối truy cập và nhảy vềfallback-wp-default.
Bước 2: Tạo tệp MU-Plugin wp-content/mu-plugins/wptt-meilisearch.php
Di chuyển vào thư mục gốc chứa WordPress (ví dụ cd /usr/local/lsws/tenmiencuaban.com/html), tạo thư mục mu-plugins nếu chưa có rồi chạy khối lệnh dưới đây qua SSH:
mkdir -p wp-content/mu-plugins
cat <<'EOF' > wp-content/mu-plugins/wptt-meilisearch.php
<?php
/**
* Plugin Name: WPTangToc Meilisearch by Gia Tuấn
* Description: Tích hợp tìm kiếm Meilisearch chuẩn Enterprise cho WordPress (Blog & WooCommerce, Frontend, AJAX Live Search, WP-Admin Dashboard, Circuit Breaker, Admin-only Header, Shutdown Batch Sync, WP-CLI).
*/
if (
! defined( 'ABSPATH' )
|| ! defined( 'WPTT_MEILI_HOST' )
|| ! defined( 'WPTT_MEILI_ADMIN_KEY' )
|| '' === trim( (string) WPTT_MEILI_HOST )
|| '' === trim( (string) WPTT_MEILI_ADMIN_KEY )
) {
return;
}
if ( ! defined( 'WPTT_MEILI_INDEX' ) || '' === trim( (string) WPTT_MEILI_INDEX ) ) {
define( 'WPTT_MEILI_INDEX', 'wp_posts' );
}
if ( ! defined( 'WPTT_MEILI_AJAX' ) ) {
define( 'WPTT_MEILI_AJAX', true );
}
if ( ! defined( 'WPTT_MEILI_ADMIN' ) ) {
define( 'WPTT_MEILI_ADMIN', true );
}
/**
* Kiểm tra an toàn website hiện tại có đang kích hoạt WooCommerce hay không
*/
function wptt_meili_has_woocommerce() {
return class_exists( 'WooCommerce' ) && post_type_exists( 'product' );
}
/**
* Tạo đường dẫn API theo tên Index đã chuẩn hóa an toàn
*/
function wptt_meili_index_path( $suffix = '' ) {
return '/indexes/' . rawurlencode( WPTT_MEILI_INDEX ) . $suffix;
}
/**
* Bảo mật Header chẩn đoán: chỉ hiển thị X-WPTT-Search cho Admin đang đăng nhập
* (hoặc khi quản trị viên chủ động bật tạm WPTT_MEILI_DEBUG_HEADER trong wp-config.php để test curl)
*/
function wptt_meili_can_show_header() {
if ( defined( 'WPTT_MEILI_DEBUG_HEADER' ) && WPTT_MEILI_DEBUG_HEADER ) {
return true;
}
return function_exists( 'current_user_can' ) && current_user_can( 'manage_options' );
}
/**
* Xuất HTTP Header X-WPTT-Search gọn chuẩn 1 dòng duy nhất (chỉ hiện với Admin)
*/
function wptt_meili_emit_header( $entry, $append = false ) {
static $entries = array();
if ( headers_sent() || ! wptt_meili_can_show_header() ) {
return;
}
if ( $append ) {
$entries[] = $entry;
header( 'X-WPTT-Search: ' . implode( ' | ', $entries ), true );
} else {
header( 'X-WPTT-Search: ' . $entry, true );
}
}
/**
* Tự động xác định danh sách post_type hợp lệ:
* - Mặc định: 'post' (và thêm 'product' nếu có WooCommerce) để tránh lẫn trang Giỏ hàng/Thanh toán
* - Tùy chỉnh nhanh: khai báo WPTT_MEILI_POST_TYPES trong wp-config.php (ví dụ: 'post,page,product')
* hoặc dùng filter 'wptt_meili_post_types'
*/
function wptt_meili_post_types() {
if ( defined( 'WPTT_MEILI_POST_TYPES' ) && '' !== trim( (string) WPTT_MEILI_POST_TYPES ) ) {
$types = array_map( 'trim', explode( ',', (string) WPTT_MEILI_POST_TYPES ) );
} else {
$types = array( 'post' );
if ( wptt_meili_has_woocommerce() ) {
$types[] = 'product';
}
}
$types = apply_filters( 'wptt_meili_post_types', $types );
if ( ! is_array( $types ) ) {
return array();
}
return array_values( array_filter( array_unique( $types ), 'post_type_exists' ) );
}
/**
* Danh sách trạng thái bài viết được đưa vào chỉ mục:
* - Bật WPTT_MEILI_ADMIN: lưu đủ các trạng thái quản trị (nhưng gắn cờ public=false cho bài chưa công khai)
* - Tắt WPTT_MEILI_ADMIN: chỉ lưu bài 'publish' cho gọn nhẹ tối đa
*/
function wptt_meili_indexable_statuses() {
if ( WPTT_MEILI_ADMIN ) {
return array( 'publish', 'draft', 'pending', 'future', 'private', 'trash' );
}
return array( 'publish' );
}
/**
* Danh sách các AJAX action tìm kiếm ngoài trang khách được phép chạy qua Meilisearch
* (Có thể bổ sung thêm action của theme bạn dùng tại đây hoặc qua filter 'wptt_meili_ajax_actions')
*/
function wptt_meili_ajax_actions() {
if ( ! WPTT_MEILI_AJAX ) {
return array();
}
$actions = array(
'flatsome_ajax_search_products', // Flatsome Live Search (Sản phẩm + Bài viết)
'woodmart_ajax_search', // WoodMart Live Search
);
$actions = apply_filters( 'wptt_meili_ajax_actions', $actions );
return is_array( $actions ) ? array_values( array_filter( $actions, 'is_string' ) ) : array();
}
/**
* Gửi yêu cầu HTTP nội bộ sang Meilisearch với timeout kiểm soát chặt
*/
function wptt_meili_request( $endpoint, $method = 'GET', $body = null, $timeout = 1.5 ) {
$args = array(
'method' => $method,
'timeout' => $timeout,
'redirection' => 0,
'headers' => array(
'Authorization' => 'Bearer ' . WPTT_MEILI_ADMIN_KEY,
'Content-Type' => 'application/json',
),
);
if ( null !== $body ) {
$args['body'] = wp_json_encode( $body );
}
$response = wp_remote_request( rtrim( WPTT_MEILI_HOST, '/' ) . $endpoint, $args );
if ( is_wp_error( $response ) ) {
return false;
}
$code = (int) wp_remote_retrieve_response_code( $response );
if ( $code < 200 || $code >= 300 ) {
return false;
}
return json_decode( wp_remote_retrieve_body( $response ), true );
}
/**
* Kiểm tra bài viết / sản phẩm có được phép hiển thị CÔNG KHAI ngoài Frontend & AJAX hay không
*/
function wptt_meili_is_public( $post ) {
if ( ! $post instanceof WP_Post ) {
return false;
}
if ( 'publish' !== $post->post_status ) {
return false;
}
// Bài viết có mật khẩu không hiển thị trên tìm kiếm công khai
if ( ! empty( $post->post_password ) ) {
return false;
}
// Tôn trọng thiết lập "Ẩn khỏi tìm kiếm" (exclude-from-search) của WooCommerce
if ( 'product' === $post->post_type && wptt_meili_has_woocommerce() && taxonomy_exists( 'product_visibility' ) ) {
if ( has_term( 'exclude-from-search', 'product_visibility', $post ) ) {
return false;
}
}
return (bool) apply_filters( 'wptt_meili_is_public', true, $post );
}
/**
* Kiểm tra bài viết / sản phẩm có đủ điều kiện lưu trong chỉ mục Meilisearch hay không
*/
function wptt_meili_is_indexable( $post ) {
if ( ! $post instanceof WP_Post ) {
return false;
}
if ( ! in_array( $post->post_type, wptt_meili_post_types(), true ) ) {
return false;
}
if ( ! in_array( $post->post_status, wptt_meili_indexable_statuses(), true ) ) {
return false;
}
if ( ! WPTT_MEILI_ADMIN && ! wptt_meili_is_public( $post ) ) {
return false;
}
return (bool) apply_filters( 'wptt_meili_is_indexable', true, $post );
}
/**
* Chuẩn hóa tài liệu WordPress (tự động bổ sung SKU cha & SKU biến thể nếu là sản phẩm WooCommerce)
*/
function wptt_meili_build_document( $post ) {
$is_wc_product = ( 'product' === $post->post_type && wptt_meili_has_woocommerce() );
$taxonomies = $is_wc_product
? array( 'product_cat', 'product_tag' )
: array( 'category', 'post_tag' );
$term_names = array();
foreach ( $taxonomies as $tax ) {
if ( taxonomy_exists( $tax ) ) {
$terms = wp_get_post_terms( $post->ID, $tax, array( 'fields' => 'names' ) );
if ( ! is_wp_error( $terms ) && is_array( $terms ) ) {
$term_names = array_merge( $term_names, $terms );
}
}
}
$term_names = array_values( array_unique( $term_names ) );
$clean_content = wp_strip_all_tags( strip_shortcodes( $post->post_content ) );
$clean_content = preg_replace( '/\s+/u', ' ', trim( $clean_content ) );
$timestamp = function_exists( 'get_post_timestamp' )
? (int) get_post_timestamp( $post )
: (int) strtotime( $post->post_date_gmt );
$doc = array(
'id' => (int) $post->ID,
'title' => html_entity_decode( wp_strip_all_tags( $post->post_title ), ENT_QUOTES, 'UTF-8' ),
'terms' => $term_names,
'excerpt' => html_entity_decode( wp_strip_all_tags( $post->post_excerpt ), ENT_QUOTES, 'UTF-8' ),
'content' => wp_trim_words( $clean_content, 400, '' ),
'type' => $post->post_type,
'status' => $post->post_status,
'public' => wptt_meili_is_public( $post ),
'date' => $timestamp,
);
// Chỉ truy vấn SKU & SKU biến thể khi là sản phẩm WooCommerce (blog thuần không tốn truy vấn meta thừa)
if ( $is_wc_product ) {
$skus = array();
$main_sku = trim( (string) get_post_meta( $post->ID, '_sku', true ) );
if ( '' !== $main_sku ) {
$skus[] = $main_sku;
}
if ( function_exists( 'wc_get_product' ) ) {
$product = wc_get_product( $post->ID );
if ( $product && method_exists( $product, 'is_type' ) && $product->is_type( 'variable' ) ) {
foreach ( (array) $product->get_children() as $child_id ) {
$child_sku = trim( (string) get_post_meta( $child_id, '_sku', true ) );
if ( '' !== $child_sku ) {
$skus[] = $child_sku;
}
}
}
}
if ( ! empty( $skus ) ) {
$doc['sku'] = array_values( array_unique( $skus ) );
}
}
return apply_filters( 'wptt_meili_document', $doc, $post );
}
/**
* Hàng đợi gom lô đồng bộ tại hook shutdown (chống trùng lặp, chờ WooCommerce/ACF lưu đủ meta & tự bỏ qua khi đang WP_IMPORTING)
*/
function wptt_meili_queue_sync( $post_id, $action = 'upsert' ) {
// Tránh làm chậm tiến trình Import CSV/XML hàng loạt (sau khi import xong chạy: wp wptt-meili sync --allow-root)
if ( defined( 'WP_IMPORTING' ) && WP_IMPORTING ) {
return;
}
static $queue = array( 'upsert' => array(), 'delete' => array() );
static $registered = false;
$post_id = (int) $post_id;
if ( $post_id <= 0 ) {
return;
}
if ( 'delete' === $action ) {
unset( $queue['upsert'][ $post_id ] );
$queue['delete'][ $post_id ] = true;
} else {
unset( $queue['delete'][ $post_id ] );
$queue['upsert'][ $post_id ] = true;
}
if ( ! $registered ) {
$registered = true;
add_action( 'shutdown', function () use ( &$queue ) {
$docs_to_upsert = array();
$ids_to_delete = array_keys( $queue['delete'] );
foreach ( array_keys( $queue['upsert'] ) as $pid ) {
$post = get_post( $pid );
if ( wptt_meili_is_indexable( $post ) ) {
$docs_to_upsert[] = wptt_meili_build_document( $post );
} else {
$ids_to_delete[] = $pid;
}
}
if ( ! empty( $docs_to_upsert ) ) {
wptt_meili_request(
wptt_meili_index_path( '/documents?primaryKey=id' ),
'POST',
$docs_to_upsert,
3
);
}
if ( ! empty( $ids_to_delete ) ) {
$ids_to_delete = array_values( array_unique( array_map( 'intval', $ids_to_delete ) ) );
wptt_meili_request(
wptt_meili_index_path( '/documents/delete-batch' ),
'POST',
$ids_to_delete,
3
);
}
}, 999 );
}
}
/**
* Bắt sự kiện thay đổi nội dung chuẩn WordPress (đăng, sửa, đưa vào thùng rác, khôi phục, xóa vĩnh viễn)
*/
add_action( 'save_post', function ( $post_id, $post ) {
if ( ( defined( 'DOING_AUTOSAVE' ) && DOING_AUTOSAVE ) || wp_is_post_autosave( $post_id ) || wp_is_post_revision( $post_id ) ) {
return;
}
if ( ! $post instanceof WP_Post || ! in_array( $post->post_type, wptt_meili_post_types(), true ) ) {
return;
}
wptt_meili_queue_sync( $post_id, 'upsert' );
}, 20, 2 );
add_action( 'trashed_post', function ( $post_id ) {
$type = get_post_type( $post_id );
if ( $type && in_array( $type, wptt_meili_post_types(), true ) ) {
wptt_meili_queue_sync( $post_id, 'upsert' );
}
} );
add_action( 'untrashed_post', function ( $post_id ) {
$type = get_post_type( $post_id );
if ( $type && in_array( $type, wptt_meili_post_types(), true ) ) {
wptt_meili_queue_sync( $post_id, 'upsert' );
}
} );
add_action( 'before_delete_post', function ( $post_id ) {
$type = get_post_type( $post_id );
if ( $type && in_array( $type, wptt_meili_post_types(), true ) ) {
wptt_meili_queue_sync( $post_id, 'delete' );
}
} );
/**
* Chỉ đăng ký hook cập nhật sản phẩm & biến thể nếu website thực sự đang chạy WooCommerce
*/
add_action( 'woocommerce_init', function () {
add_action( 'woocommerce_update_product', function ( $product_id ) {
wptt_meili_queue_sync( $product_id, 'upsert' );
}, 20 );
add_action( 'woocommerce_save_product_variation', function ( $variation_id ) {
$parent_id = wp_get_post_parent_id( $variation_id );
if ( $parent_id ) {
wptt_meili_queue_sync( $parent_id, 'upsert' );
}
}, 20 );
} );
/**
* Chặn trước WooCommerce tại filter 'request' (priority 5) trong WP-Admin edit.php?post_type=product
* để WooCommerce không chạy SQL tìm kiếm riêng và không xóa mất biến 's' trước khi pre_get_posts chạy
*/
add_filter( 'request', function ( $query_vars ) {
if ( ! WPTT_MEILI_ADMIN || ! is_admin() ) {
return $query_vars;
}
if ( function_exists( 'wp_doing_ajax' ) && wp_doing_ajax() ) {
return $query_vars;
}
global $pagenow;
if ( 'edit.php' !== $pagenow || empty( $query_vars['post_type'] ) || 'product' !== $query_vars['post_type'] ) {
return $query_vars;
}
if ( get_transient( 'wptt_meili_cb_open' ) ) {
return $query_vars;
}
if ( ! empty( $query_vars['s'] ) ) {
$keyword = trim( (string) $query_vars['s'] );
if ( '' !== $keyword ) {
$query_vars['wptt_meili_admin_s'] = $keyword;
unset( $query_vars['s'] );
}
}
return $query_vars;
}, 5 );
/**
* Đánh chặn truy vấn tìm kiếm: Trang khách + AJAX Live Search + WP-Admin Dashboard (edit.php) + Cờ 'wptt_meili' => true
* Đặt priority 99 để luôn chạy SAU WC_Query::product_query() của WooCommerce (tránh bị ghi đè mất post__in)
*/
add_action( 'pre_get_posts', function ( $query ) {
// Khôi phục từ khóa tìm kiếm sản phẩm trong WP-Admin sau khi đã bỏ qua bộ tìm kiếm SQL của WooCommerce
$saved_admin_s = (string) $query->get( 'wptt_meili_admin_s' );
if ( '' !== $saved_admin_s ) {
$query->set( 's', $saved_admin_s );
$query->is_search = true;
}
$is_explicit = (bool) $query->get( 'wptt_meili' );
$is_main_web = ( ! is_admin() && $query->is_main_query() && $query->is_search() );
$is_ajax_hit = false;
$is_admin_list = false;
$doing_ajax = function_exists( 'wp_doing_ajax' ) && wp_doing_ajax();
// 1. Kiểm tra AJAX Live Search ngoài trang khách
if ( WPTT_MEILI_AJAX && $doing_ajax && ! empty( $_REQUEST['action'] ) ) {
$ajax_actions = wptt_meili_ajax_actions();
if ( ! empty( $ajax_actions ) ) {
$ajax_action = sanitize_key( wp_unslash( $_REQUEST['action'] ) );
if ( in_array( $ajax_action, $ajax_actions, true ) ) {
$is_ajax_hit = true;
}
}
}
// 2. Kiểm tra tìm kiếm bên trong WP-Admin Dashboard (edit.php: Bài viết & Sản phẩm WooCommerce)
if ( WPTT_MEILI_ADMIN && is_admin() && ! $doing_ajax && $query->is_main_query() && $query->is_search() ) {
global $pagenow;
if ( 'edit.php' === $pagenow ) {
$is_admin_list = true;
}
}
if ( ! $is_explicit && ! $is_main_web && ! $is_ajax_hit && ! $is_admin_list ) {
return;
}
// Chỉ can thiệp khi truy vấn thực sự có từ khóa tìm kiếm 's'
$keyword = trim( (string) $query->get( 's' ) );
if ( '' === $keyword ) {
if ( $is_main_web ) {
$query->set( 'wptt_meili_status', 'skip-empty' );
}
return;
}
// Chống truy vấn rác quá dài (tương thích ngay cả khi PHP thiếu extension mbstring)
if ( function_exists( 'mb_strlen' ) && mb_strlen( $keyword, 'UTF-8' ) > 150 ) {
$keyword = mb_substr( $keyword, 0, 150, 'UTF-8' );
} elseif ( strlen( $keyword ) > 150 ) {
$keyword = substr( $keyword, 0, 150 );
}
// Kiểm tra cầu dao bảo vệ (Circuit Breaker): nếu Meilisearch vừa lỗi -> lùi ngay về WP mặc định (0ms)
if ( get_transient( 'wptt_meili_cb_open' ) ) {
$query->set( 'wptt_meili_status', 'fallback-circuit-open' );
if ( $is_ajax_hit || $is_admin_list ) {
wptt_meili_emit_header( 'fallback-circuit-open', $is_ajax_hit );
}
return;
}
$allowed_types = wptt_meili_post_types();
if ( empty( $allowed_types ) ) {
return;
}
$req_type = $query->get( 'post_type' );
$target_types = $allowed_types;
// Xác thực whitelist post_type (tự bỏ qua các trang chưa index như page, shop_order...)
if ( is_string( $req_type ) && '' !== $req_type && 'any' !== $req_type ) {
if ( ! in_array( $req_type, $allowed_types, true ) ) {
$query->set( 'wptt_meili_status', 'skip-unindexed-type' );
return;
}
$target_types = array( $req_type );
} elseif ( is_array( $req_type ) && ! empty( $req_type ) ) {
$valid = array_values( array_intersect( $req_type, $allowed_types ) );
if ( empty( $valid ) ) {
$query->set( 'wptt_meili_status', 'skip-unindexed-type' );
return;
}
$target_types = $valid;
}
$filters = array();
// Lọc loại bài viết
if ( count( $target_types ) < count( $allowed_types ) ) {
if ( 1 === count( $target_types ) ) {
$filters[] = 'type = "' . $target_types[0] . '"';
} else {
$quoted = array_map( function ( $t ) { return '"' . $t . '"'; }, $target_types );
$filters[] = 'type IN [' . implode( ', ', $quoted ) . ']';
}
}
// Bảo mật tách biệt: WP-Admin lọc đúng theo tab trạng thái; Frontend & AJAX khóa cứng public = true
if ( $is_admin_list ) {
$admin_status = $query->get( 'post_status' );
if ( is_string( $admin_status ) ) {
$admin_status = trim( $admin_status );
}
if ( empty( $admin_status ) || 'all' === $admin_status || 'any' === $admin_status ) {
$filters[] = 'status != "trash"';
} elseif ( is_string( $admin_status ) ) {
if ( ! in_array( $admin_status, wptt_meili_indexable_statuses(), true ) ) {
$query->set( 'wptt_meili_status', 'skip-unindexed-status' );
return;
}
$filters[] = 'status = "' . $admin_status . '"';
} elseif ( is_array( $admin_status ) ) {
$valid_statuses = array_values( array_intersect( $admin_status, wptt_meili_indexable_statuses() ) );
if ( empty( $valid_statuses ) ) {
$query->set( 'wptt_meili_status', 'skip-unindexed-status' );
return;
}
$quoted_st = array_map( function ( $st ) { return '"' . $st . '"'; }, $valid_statuses );
$filters[] = 'status IN [' . implode( ', ', $quoted_st ) . ']';
}
} else {
$filters[] = 'public = true';
}
$limit = $is_admin_list ? 1000 : ( $is_main_web ? 500 : 50 );
$payload = array(
'q' => $keyword,
'limit' => $limit,
'attributesToRetrieve' => array( 'id' ),
);
if ( ! empty( $filters ) ) {
$payload['filter'] = implode( ' AND ', $filters );
}
$result = wptt_meili_request( wptt_meili_index_path( '/search' ), 'POST', $payload, 1.5 );
// Nếu gọi Meilisearch thất bại -> bật cầu dao 60 giây & fallback an toàn về tìm kiếm mặc định
if ( false === $result || ! isset( $result['hits'] ) ) {
set_transient( 'wptt_meili_cb_open', 1, 60 );
$query->set( 'wptt_meili_status', 'fallback-wp-default' );
if ( $is_ajax_hit || $is_admin_list ) {
wptt_meili_emit_header( 'fallback-wp-default', $is_ajax_hit );
}
return;
}
$ids = array_map( 'intval', wp_list_pluck( $result['hits'], 'id' ) );
$took_ms = isset( $result['processingTimeMs'] ) ? (int) $result['processingTimeMs'] : 0;
$hit_cnt = count( $ids );
$type_label = implode( '+', $target_types );
$mode = $is_admin_list ? 'admin' : ( $is_main_web ? 'main' : ( $is_ajax_hit ? 'ajax' : 'custom' ) );
$status = sprintf( 'meilisearch-%s[%s] %dms hits=%d', $mode, $type_label, $took_ms, $hit_cnt );
$query->set( 'wptt_meili_handled', true );
$query->set( 'wptt_meili_status', $status );
// Không ghi đè post_type thành mảng trong WP-Admin để tránh lỗi form "post_type=Array" khi tìm kiếm liên tiếp
if ( ! $is_admin_list ) {
$query->set( 'post_type', 1 === count( $target_types ) ? $target_types[0] : $target_types );
}
$query->set( 'post__in', ! empty( $ids ) ? $ids : array( 0 ) );
$query->set( 'ignore_sticky_posts', true );
// Với AJAX / truy vấn phụ dùng get_posts() (mặc định suppress_filters => true): xóa 's' để MySQL không chèn LIKE
// Với Trang chính và WP-Admin edit.php: giữ nguyên 's' để giao diện vẫn hiển thị "Kết quả tìm kiếm cho: ..."
if ( ! $is_main_web && ! $is_admin_list ) {
$query->set( 's', '' );
}
// Xuất header chẩn đoán ngay cho AJAX & WP-Admin edit.php (chỉ hiện với Admin)
if ( $is_ajax_hit || $is_admin_list ) {
wptt_meili_emit_header( $status, $is_ajax_hit );
}
// Chỉ sắp theo độ liên quan của Meilisearch khi người dùng KHÔNG chủ động bấm sắp xếp cột (Giá, Thời gian, Tiêu đề...)
$user_orderby = ( ( $is_main_web || $is_admin_list ) && isset( $_GET['orderby'] ) )
? sanitize_key( wp_unslash( $_GET['orderby'] ) )
: '';
if ( '' === $user_orderby || 'relevance' === $user_orderby ) {
$query->set( 'orderby', 'post__in' );
}
}, 99 );
/**
* Gỡ mệnh đề SQL LIKE mặc định (ưu tiên 999 để dọn sạch cả bộ lọc tìm kiếm SQL phụ của WooCommerce)
*/
add_filter( 'posts_search', function ( $search, $query ) {
if ( $query->get( 'wptt_meili_handled' ) ) {
return '';
}
return $search;
}, 999, 2 );
/**
* Xuất HTTP Header chẩn đoán cho trang tìm kiếm chính (chỉ hiện với Admin đang đăng nhập)
*/
add_action( 'template_redirect', function () {
if ( ! is_search() ) {
return;
}
global $wp_query;
if ( $wp_query instanceof WP_Query ) {
$status = $wp_query->get( 'wptt_meili_status' );
if ( $status ) {
wptt_meili_emit_header( $status, false );
}
}
} );
/**
* Bộ lệnh WP-CLI chuyên nghiệp: wp wptt-meili [sync|stats|test|flush]
*/
if ( defined( 'WP_CLI' ) && WP_CLI ) {
WP_CLI::add_command( 'wptt-meili', new class {
/**
* Tự động cấu hình settings chuẩn và đồng bộ toàn bộ dữ liệu sang Meilisearch.
*
* ## OPTIONS
* [--reset]
* : Xóa toàn bộ dữ liệu cũ trong index trước khi đồng bộ lại từ đầu.
*
* [--batch=<size>]
* : Số lượng bản ghi mỗi lô (mặc định: 200).
*/
public function sync( $args, $assoc_args ) {
$reset = isset( $assoc_args['reset'] );
$batch = isset( $assoc_args['batch'] ) ? max( 50, (int) $assoc_args['batch'] ) : 200;
$types = wptt_meili_post_types();
$statuses = wptt_meili_indexable_statuses();
if ( empty( $types ) ) {
WP_CLI::error( 'Khong tim thay post_type hop le nao de dong bo.' );
}
delete_transient( 'wptt_meili_cb_open' );
if ( $reset ) {
WP_CLI::log( 'Dang xoa toan bo tai lieu cu trong index ' . WPTT_MEILI_INDEX . '...' );
wptt_meili_request( wptt_meili_index_path( '/documents' ), 'DELETE', null, 10 );
sleep( 1 );
}
$searchable = wptt_meili_has_woocommerce()
? array( 'title', 'sku', 'terms', 'excerpt', 'content', 'id' )
: array( 'title', 'terms', 'excerpt', 'content', 'id' );
WP_CLI::log( 'Che do nhan dien: ' . ( wptt_meili_has_woocommerce() ? 'WordPress + WooCommerce' : 'WordPress Blog' ) . ' (' . implode( ', ', $types ) . ')' );
WP_CLI::log( 'WP-Admin Search: ' . ( WPTT_MEILI_ADMIN ? 'ENABLED (statuses: ' . implode( ', ', $statuses ) . ')' : 'DISABLED (publish only)' ) );
WP_CLI::log( 'Dang ap dung cau hinh toi uu cho index ' . WPTT_MEILI_INDEX . '...' );
$set = wptt_meili_request(
wptt_meili_index_path( '/settings' ),
'PATCH',
array(
'searchableAttributes' => $searchable,
'filterableAttributes' => array( 'type', 'status', 'public' ),
'sortableAttributes' => array( 'date' ),
),
10
);
if ( false === $set ) {
WP_CLI::error( 'Khong the ket noi Meilisearch. Kiem tra lai WPTT_MEILI_HOST va WPTT_MEILI_ADMIN_KEY trong wp-config.php!' );
}
$paged = 1;
$total = 0;
do {
$q = new WP_Query( array(
'post_type' => $types,
'post_status' => $statuses,
'posts_per_page' => $batch,
'paged' => $paged,
'no_found_rows' => true,
) );
if ( empty( $q->posts ) ) {
break;
}
$docs = array();
foreach ( $q->posts as $p ) {
if ( wptt_meili_is_indexable( $p ) ) {
$docs[] = wptt_meili_build_document( $p );
}
}
if ( ! empty( $docs ) ) {
$res = wptt_meili_request(
wptt_meili_index_path( '/documents?primaryKey=id' ),
'POST',
$docs,
20
);
if ( false === $res ) {
WP_CLI::error( "Loi gui du lieu o trang {$paged}." );
}
$cnt = count( $docs );
$total += $cnt;
WP_CLI::log( sprintf( 'Lo #%d: da gui %d ban ghi (taskUid: %s)', $paged, $cnt, $res['taskUid'] ?? 'N/A' ) );
}
if ( function_exists( 'wp_cache_flush_runtime' ) ) {
wp_cache_flush_runtime();
}
$paged++;
} while ( true );
sleep( 2 );
$stats = wptt_meili_request( wptt_meili_index_path( '/stats' ), 'GET', null, 5 );
WP_CLI::success( "Hoan tat! Da dong bo {$total} ban ghi. Stats: " . wp_json_encode( $stats ) );
}
/**
* Kiểm tra sức khỏe máy chủ Meilisearch, chế độ nhận diện, số lượng bản ghi và trạng thái cầu dao.
*/
public function stats() {
$health = wptt_meili_request( '/health', 'GET', null, 3 );
$stats = wptt_meili_request( wptt_meili_index_path( '/stats' ), 'GET', null, 3 );
$tasks = wptt_meili_request( '/tasks?limit=3&indexUids=' . rawurlencode( WPTT_MEILI_INDEX ), 'GET', null, 3 );
$cb = get_transient( 'wptt_meili_cb_open' ) ? 'OPEN (dang fallback)' : 'CLOSED (binh thuong)';
WP_CLI::log( 'Environment: ' . ( wptt_meili_has_woocommerce() ? 'WordPress + WooCommerce' : 'WordPress Blog' ) . ' | Types: ' . implode( ', ', wptt_meili_post_types() ) );
WP_CLI::log( 'WP-Admin Search: ' . ( WPTT_MEILI_ADMIN ? 'ENABLED' : 'DISABLED' ) );
WP_CLI::log( 'AJAX Search: ' . ( WPTT_MEILI_AJAX ? 'ENABLED (' . count( wptt_meili_ajax_actions() ) . ' actions)' : 'DISABLED' ) );
WP_CLI::log( 'Health: ' . wp_json_encode( $health ) );
WP_CLI::log( 'Index Stats: ' . wp_json_encode( $stats ) );
WP_CLI::log( 'Circuit Breaker: ' . $cb );
if ( ! empty( $tasks['results'] ) ) {
foreach ( $tasks['results'] as $t ) {
$err = ! empty( $t['error']['message'] ) ? ' | ERR: ' . $t['error']['message'] : '';
WP_CLI::log( sprintf( 'Task #%d [%s]: %s%s', $t['uid'], $t['type'], $t['status'], $err ) );
}
}
}
/**
* Chạy thử một truy vấn tìm kiếm trực tiếp từ dòng lệnh.
*
* ## OPTIONS
* <keyword>
* : Từ khóa cần tìm kiếm thử.
*/
public function test( $args ) {
$kw = implode( ' ', $args );
$res = wptt_meili_request(
wptt_meili_index_path( '/search' ),
'POST',
array( 'q' => $kw, 'limit' => 5, 'attributesToRetrieve' => array( 'id', 'title', 'type', 'status', 'public', 'sku' ) ),
3
);
if ( false === $res ) {
WP_CLI::error( 'Truy van Meilisearch that bai!' );
}
WP_CLI::log( sprintf( 'Tu khoa: "%s" | Thoi gian: %dms | Tong khop uoc tinh: %d', $kw, $res['processingTimeMs'] ?? 0, $res['estimatedTotalHits'] ?? 0 ) );
foreach ( (array) ( $res['hits'] ?? array() ) as $i => $hit ) {
$sku = ! empty( $hit['sku'] ) ? ' [SKU: ' . implode( ',', (array) $hit['sku'] ) . ']' : '';
WP_CLI::log( sprintf( ' %d. #%d [%s|%s] %s%s', $i + 1, $hit['id'], $hit['type'], $hit['status'] ?? 'publish', $hit['title'], $sku ) );
}
}
/**
* Xóa sạch dữ liệu trong index và mở lại cầu dao.
*/
public function flush() {
delete_transient( 'wptt_meili_cb_open' );
wptt_meili_request( wptt_meili_index_path( '/documents' ), 'DELETE', null, 10 );
WP_CLI::success( 'Da xoa sach tai lieu trong index ' . WPTT_MEILI_INDEX . ' va reset Circuit Breaker.' );
}
} );
}
EOF
chmod 644 wp-content/mu-plugins/wptt-meilisearch.php
php -l wp-content/mu-plugins/wptt-meilisearch.phpBước 3: Đồng bộ toàn bộ dữ liệu chỉ với 1 dòng lệnh WP-CLI
Đứng ở thư mục gốc website và chạy đúng 1 lệnh duy nhất — hệ thống sẽ tự nhận diện website của bạn là Blog thuần hay có WooCommerce để thiết lập trọng số tìm kiếm (bao gồm cả trường lọc status và public cho WP-Admin) rồi đẩy toàn bộ dữ liệu sang Meilisearch:
# Đồng bộ sạch toàn bộ dữ liệu bài viết & sản phẩm sang Meilisearch
wp wptt-meili sync --reset --allow-root6. Tối ưu nâng cao cho WP-Admin Dashboard & AJAX Live Search
Tìm kiếm siêu tốc ngay trong WP-Admin (Bài viết & Sản phẩm WooCommerce)
Với những website tin tức nhiều nghìn bài viết hoặc shop WooCommerce nhiều nghìn mã hàng có hàng chục biến thể mỗi sản phẩm, mỗi lần nhân viên gõ tìm kiếm trong mục Bài viết → Tất cả bài viết hay Sản phẩm → Tất cả sản phẩm đều khiến MySQL chạy cực chậm (và gõ thiếu dấu tiếng Việt hay nhầm 1 ký tự SKU là tìm không ra).
Với MU-Plugin ở trên, tính năng tìm kiếm trong wp-admin/edit.php đã được tối ưu tự động và hoàn toàn an toàn:
- Hoạt động chuẩn trên mọi tab trạng thái: Ở tab Tất cả tự động lọc
status != "trash"; bấm sang tab Đã xuất bản, Bản nháp hay Thùng rác tự động tìm đúng bài thuộc tab đó mà không lo “tàng hình” bản nháp. - Tìm sản phẩm WooCommerce cực sướng cho đội vận hành: Chặn trước truy vấn SQL mặc định của WooCommerce ngay tại filter
request, giúp gõ tên sản phẩm không dấu, gõ sai chính tả, gõ mã SKU sản phẩm cha, gõ mã SKU của sản phẩm biến thể hoặc gõ thẳng ID sản phẩm đều ra ngay tức thì. - Không phá vỡ tính năng sẵn có của WordPress: Các bộ lọc theo Danh mục, Tháng/Năm, Tác giả, Tình trạng kho và thao tác bấm tiêu đề cột để sắp xếp theo Thời gian / Tiêu đề / Giá vẫn giữ nguyên 100%. Các mục khác như Trang tĩnh (Page) (nếu chưa bật trong
WPTT_MEILI_POST_TYPES) hay Đơn hàng WooCommerce được bỏ qua tự động để WordPress xử lý mặc định. - Khóa chặt chống lộ dữ liệu: Toàn bộ bản nháp, bài riêng tư và thùng rác đều mang cờ
public: false; ngoài trang khách và AJAX Live Search luôn lọc cứngpublic = truenên tuyệt đối không bao giờ lộ nội bộ ra ngoài.
Tối ưu AJAX Live Search cho Flatsome, WoodMart & Mọi nền tảng
Khi dùng ElasticPress trước đây, muốn kết hợp tìm kiếm trực tiếp AJAX của theme Flatsome, bạn thường phải vào tận tệp gốc wp-content/themes/flatsome/inc/extensions/flatsome-live-search/flatsome-live-search.php để chèn thêm 'ep_integrate' => true — rất bất tiện vì mỗi lần cập nhật theme là mất sạch code.
Với MU-Plugin ở trên, Flatsome Live Search và WoodMart đã tự động chạy qua Meilisearch mà không cần đụng một dòng nào vào file theme. Nếu website của bạn không dùng AJAX Search, đoạn mã tự động bỏ qua hoàn toàn (hoặc bạn có thể đặt define( 'WPTT_MEILI_AJAX', false ); trong wp-config.php để tắt triệt để).
Còn nếu bạn dùng bất kỳ theme hay plugin AJAX Search nào khác, chỉ cần làm đúng 4 bước trong 10 giây:
- Mở website bằng Chrome → nhấn F12 → chọn tab Network → lọc theo Fetch/XHR.
- Gõ một từ khóa vào ô tìm kiếm Live Search trên website.
- Nhấn vào dòng
admin-ajax.php?action=...vừa xuất hiện, copy chính xác tên đứng sauaction=(ví dụ với Flatsome làflatsome_ajax_search_products). - Thêm chuỗi tên action đó vào mảng trong hàm
wptt_meili_ajax_actions()của tệpwptt-meilisearch.phplà xong!
Ngoài ra, nếu bạn tự viết WP_Query tùy biến ở bất kỳ đâu (tương đương cơ chế 'ep_integrate' => true của ElasticPress), chỉ cần thêm tham số 'wptt_meili' => true:
$query = new WP_Query( array(
's' => 'dien thoai iphon',
'post_type' => 'product',
'wptt_meili' => true,
) );Mẹo riêng cho anh em dùng Flatsome + WooCommerce: Trong cài đặt tìm kiếm của Flatsome, bạn có thể tắt tùy chọn “Search by SKU” mặc định của theme đi. Lý do là MU-Plugin đã lập chỉ mục sẵn cả SKU sản phẩm cha lẫn SKU biến thể trong Meilisearch — tắt mục này giúp Flatsome không chạy thừa thêm một câu truy vấn
meta_querynặng nề nào nữa.
Lưu ý kỹ thuật về giới hạn của admin-ajax.php: Dù Meilisearch chỉ mất 1–2ms để trả kết quả, nhưng khi đi qua admin-ajax.php của theme, trình duyệt vẫn cần chờ PHP + WordPress khởi động xong (tổng thời gian phản hồi khoảng 120ms – 300ms). Tùy quy mô website mà bạn chọn cấp độ phù hợp:
| Cấp độ tối ưu AJAX | Cách hoạt động | Độ trễ thực tế | Ưu / Nhược điểm |
|---|---|---|---|
Cấp 1: Qua admin-ajax.php (MU-Plugin ở trên) | Giữ nguyên 100% giao diện & JS của Flatsome / mọi theme, thay bộ máy tìm kiếm bên dưới bằng Meilisearch | 120ms – 300ms (Database giảm tải tới 90%) | Cài 2 phút xong, không sửa theme, giữ trọn hiển thị giá khuyến mãi và tồn kho động của WooCommerce |
| Cấp 2: Instant Search gọi thẳng Meilisearch | JS ở trình duyệt gọi thẳng Reverse Proxy (OpenLiteSpeed/Nginx → 127.0.0.1:7700) bằng Search-Only Key | 5ms – 20ms (tức thì đúng nghĩa) | Chịu tải hàng nghìn người gõ cùng lúc gần như 0% CPU PHP, nhưng phải tự viết giao diện JS gợi ý và đồng bộ thêm ảnh/giá |
7. Hướng dẫn kiểm tra: Thế nào là ĐÃ OK, thế nào là CHƯA OK?
Vì MU-Plugin có cơ chế cầu dao dự phòng tự động lùi về tìm kiếm mặc định WordPress nếu kết nối lỗi, bạn đừng chỉ thấy có bài hiện ra mà vội kết luận đã xong. Hãy kiểm tra lần lượt đủ 4 bước xác minh kỹ thuật sau:
Test 1: Kiểm tra trạng thái chỉ mục và tìm thử ngay trên Terminal
# Xem môi trường tự nhận diện (Blog hay WooCommerce), trạng thái WP-Admin/AJAX và số lượng bản ghi
wp wptt-meili stats --allow-root
# Thử gõ tiếng Việt KHÔNG DẤU + cố tình sai chính tả
wp wptt-meili test "toi uu toc do wordpres" --allow-root- ĐÃ OK:
Environmentnhận đúng loại web (WordPress BloghoặcWordPress + WooCommerce),WP-Admin SearchlàENABLED,Healthlàavailable,numberOfDocumentskhớp tổng số bài viết/sản phẩm,Circuit BreakerlàCLOSED (binh thuong)và lệnhtesttrả về đúng top 5 kết quả chỉ trong vài mili-giây. - CHƯA OK: Nếu báo
'wptt-meili' is not a registered wp command→ kiểm tra lại 3 dòngdefine('WPTT_MEILI_...')trongwp-config.phpđã đặt phía trênwp-settings.phpchưa, và filewp-content/mu-plugins/wptt-meilisearch.phpđã đặt đúng đường dẫn chưa.
Test 2: Kiểm tra HTTP Header X-WPTT-Search trên cả 3 khu vực (Chỉ hiện với Admin)
Vì lý do bảo mật, MU-Plugin đã bọc sẵn điều kiện current_user_can( 'manage_options' ) để ẩn hoàn toàn header X-WPTT-Search với người ngoài (đảm bảo plugin Page Cache như LSCache / FastCGI Cache / Cloudflare không cache trang ?s= và không cache phiên đăng nhập Admin). Để kiểm tra chính xác cả 3 khu vực:
- Đăng nhập vào tài khoản Admin WordPress (
wp-admin) trên trình duyệt Chrome/Edge/Firefox của bạn, sau đó nhấn F12 → chọn tab Network. - Kiểm tra WP-Admin Dashboard: Vào Bài viết → Tất cả bài viết (hoặc Sản phẩm → Tất cả sản phẩm) → gõ từ khóa không dấu hoặc mã SKU → bấm Tìm các bài viết / Tìm sản phẩm → lọc tab Doc / HTML → nhấn vào dòng
edit.php?s=...→ xem Response Headers. - Kiểm tra AJAX Live Search (nếu có): Ra trang chủ → lọc tab Fetch/XHR → gõ từ khóa vào ô tìm kiếm → nhấn vào dòng
admin-ajax.php?action=...→ xem Response Headers. - Kiểm tra trang tìm kiếm chính: Lọc tab Doc / HTML → nhấn Enter mở trang kết quả (
/?s=...) → nhấn vào URL đầu tiên → xem Response Headers.
- ĐÃ OK: Bạn sẽ thấy dòng header sạch đẹp tương ứng từng khu vực:
- Trong WP-Admin:
x-wptt-search: meilisearch-admin[post] 0ms hits=255hoặcmeilisearch-admin[product] 0ms hits=1 - Trang tìm kiếm chính:
x-wptt-search: meilisearch-main[post] 1ms hits=42 - AJAX Live Search:
x-wptt-search: meilisearch-ajax[product] 0ms hits=1 | meilisearch-ajax[post] 0ms hits=0
- Trong WP-Admin:
- CHƯA OK — Trả về
fallback-wp-defaulthoặcfallback-circuit-open: Kết nối tới Meilisearch đang lỗi, lệch tênWPTT_MEILI_INDEXvới Scoped API Key hoặc chưa chạywp wptt-meili sync --reset --allow-root. Chạywp wptt-meili stats --allow-rootđể xem lỗi cụ thể. - CHƯA OK — Đã đăng nhập Admin nhưng vẫn không thấy header
x-wptt-search: Với trang chính, kiểm tra xem Cloudflare/plugin Cache có đang cache nhầm URL/?s=...hay không; với AJAX Live Search, kiểm tra xem tênaction=của theme đã có trong hàmwptt_meili_ajax_actions()chưa.
Ghi chú cho anh em thích kiểm tra bằng lệnh curl qua SSH: Nếu muốn test nhanh bằng curl -sI "https://tenmiencuaban.com/?s=wordpress" | grep -i "x-wptt-search" mà không cần cookie Admin, hãy tạm thêm define( 'WPTT_MEILI_DEBUG_HEADER', true ); vào wp-config.php, test xong thì nhớ xóa dòng đó đi.
Test 3: Kiểm tra tiếng Việt không dấu, SKU biến thể & Chống lộ Bản nháp
- Tạo 1 bài viết ở trạng thái Bản nháp (Draft) có tiêu đề đặc biệt (ví dụ
Ban Nhap Bi Mat 7766). - Vào WP-Admin → Bài viết gõ không dấu
ban nhap bi mat 7766→ ĐÃ OK nếu bài viết hiện ngay trong trang quản trị (ở cả tab Tất cả lẫn tab Bản nháp). - Mở tab Ẩn danh ra ngoài trang khách, tìm
7766→ ĐÃ OK nếu trang khách báo không tìm thấy kết quả nào (xác nhận 100% không lộ bài nháp ra ngoài). - Nếu có WooCommerce: vào WP-Admin → Sản phẩm gõ thử mã SKU của một biến thể → ĐÃ OK nếu trả về ngay sản phẩm cha tương ứng.
Test 4: Kiểm tra đồng bộ tự động (Real-time Sync)
- Xuất bản bài test
7766ở trên, đợi 2 giây rồi tìm lại ngoài trang khách → ĐÃ OK nếu bài xuất hiện ngay lập tức. - Chuyển bài test vào Thùng rác, đợi 2 giây: kiểm tra ngoài trang khách phải biến mất ngay, trong khi bấm sang tab Thùng rác ở WP-Admin tìm
7766vẫn thấy. - Bấm Xóa vĩnh viễn bài test → biến mất hoàn toàn khỏi cả Meilisearch lẫn WP-Admin.
| Dấu hiệu quan sát được | Trạng thái | Nguyên nhân & Cách xử lý nhanh |
|---|---|---|
Admin thấy X-WPTT-Search: meilisearch-main / ajax / admin[...], tab Ẩn danh không thấy header và không lộ bản nháp | OK 100% | Hệ thống đạt chuẩn Enterprise ở cả 3 khu vực: Trang khách, AJAX và WP-Admin |
X-WPTT-Search: fallback-wp-default hoặc fallback-circuit-open | CHƯA OK | Sai Scoped API Key, lệch tên WPTT_MEILI_INDEX, Meilisearch đang tắt hoặc chưa chạy wp wptt-meili sync --reset --allow-root |
Không thấy header X-WPTT-Search | CHƯA OK | Chưa đăng nhập Admin, đặt define() sau wp-settings.php, thiếu action trong wptt_meili_ajax_actions() hoặc trang ?s= đang bị cache |
X-WPTT-Search: meilisearch-... 1ms hits=0 với mọi từ khóa | CHƯA OK | Index đang trống — chạy lại wp wptt-meili sync --reset --allow-root |
8. Kinh nghiệm vận hành, đồng bộ định kỳ, tối ưu RAM và nâng cấp
- Có cần đặt Cron đồng bộ lại mỗi ngày không? Không cần, vì mọi thao tác thêm/sửa/xóa bài viết và sản phẩm đã tự động đồng bộ theo thời gian thực. Nếu website có dùng phần mềm bên ngoài đẩy dữ liệu thẳng xuống SQL (như công cụ đồng bộ kho ERP/KiotViet bỏ qua hook WordPress) hoặc sau khi bạn vừa Import CSV hàng nghìn sản phẩm, chỉ cần chạy lại
wp wptt-meili sync --allow-root(hoặc đặt Cron 1 lần/tuần vào 3h sáng Chủ Nhật và tuyệt đối KHÔNG dùng cờ--resettrong Cron để tránh xóa trống index tạm thời):0 3 * * 0 cd /duong/dan/toi/html && /usr/local/bin/wp wptt-meili sync --allow-root >/dev/null 2>&1 - Kiểm soát RAM tránh OOM Killer: Quá trình lập chỉ mục ban đầu tốn RAM nhất. Luôn giữ thông số
max_indexing_memory(trong/etc/meilisearch.tomlvới Cách 4A hoặcMEILI_MAX_INDEXING_MEMORYtrong/etc/meilisearch.envvới Cách 4B) ở mức khoảng 25% – 35% RAM trống của VPS. Nếu thấy dịch vụ tự tắt bất thường, chạydmesg -T | grep -i -E "oom|meilisearch"để kiểm tra. - Chiến lược sao lưu (Backup) siêu nhẹ: Dữ liệu gốc luôn nằm an toàn trong MariaDB/MySQL của WordPress. Bạn không cần tốn dung lượng ổ cứng backup thư mục
/var/lib/meilisearchhàng ngày — chỉ cần sao lưu file cấu hình/etc/meilisearch.toml(hoặc/etc/meilisearch.env) và filewp-content/mu-plugins/wptt-meilisearch.php. Khi chuyển sang VPS mới, cài Meilisearch rồi chạy đúng 1 lệnhwp wptt-meili sync --reset --allow-rootlà khôi phục sạch trong vài chục giây. - Nâng cấp phiên bản mới an toàn: Nếu cài bằng Binary (Cách 4A), tải file binary mới về thay vào
/usr/local/bin/meilisearch(xem Changelog nếu nhảy bản lớn cần cờ--upgrade-db) rồi chạysystemctl restart meilisearch. Nếu cài bằng Podman (Cách 4B), chỉ cần chạypodman pull docker.io/getmeili/meilisearch:latestrồisystemctl restart meilisearch.
9. Hướng dẫn gỡ bỏ hoàn toàn Meilisearch (Nếu sau này không muốn dùng nữa)
Một ưu điểm rất lớn của cách triển khai bằng MU-Plugin là không hề can thiệp hay tạo thêm bảng rác nào trong database WordPress. Nếu sau này bạn muốn quay về tìm kiếm mặc định của WordPress hoặc chuyển sang giải pháp khác, chỉ cần làm đúng 2 bước sau để gỡ sạch 100%:
Bước 1: Gỡ tích hợp trên WordPress (Quay về mặc định trong 10 giây)
# Di chuyển vào thư mục gốc WordPress (ví dụ: cd /usr/local/lsws/tenmiencuaban.com/html)
# 1. Xóa file MU-Plugin
rm -f wp-content/mu-plugins/wptt-meilisearch.php
# 2. Xóa transient cầu dao nếu có
wp transient delete wptt_meili_cb_open --allow-rootSau đó, mở tệp wp-config.php và xóa bỏ các dòng define( 'WPTT_MEILI_...', ... ); bạn đã thêm ở Mục 5 (và xóa dòng Cron trong crontab -e nếu trước đó có đặt lịch đồng bộ định kỳ). Ngay lập tức website sẽ quay về tìm kiếm mặc định của WordPress mà không ảnh hưởng bất kỳ dữ liệu nào.
Bước 2: Gỡ sạch dịch vụ Meilisearch khỏi Linux VPS (Giải phóng 100% RAM & ổ cứng)
Nếu trước đó bạn cài bằng Binary (Cách 4A):
systemctl disable --now meilisearch
rm -f /etc/systemd/system/meilisearch.service
systemctl daemon-reload
rm -f /usr/local/bin/meilisearch /etc/meilisearch.toml
rm -rf /var/lib/meilisearch
userdel meilisearch 2>/dev/null || trueNếu trước đó bạn cài bằng Podman (Cách 4B):
systemctl disable --now meilisearch
rm -f /etc/systemd/system/meilisearch.service
systemctl daemon-reload
podman rm -f meilisearch 2>/dev/null || true
podman rmi docker.io/getmeili/meilisearch:latest 2>/dev/null || true
rm -f /etc/meilisearch.env /etc/containers/containers.conf.d/99-lxc.conf
rm -rf /var/lib/meilisearch
# (Tùy chọn) Gỡ luôn Podman nếu VPS không dùng cho container nào khác:
# dnf remove -y podmanChạy lệnh ss -tulpn | grep 7700 — nếu không còn dòng nào trả về nghĩa là Meilisearch đã được dọn sạch hoàn toàn khỏi VPS.
Lời kết
Chỉ với khoảng 10 phút cài đặt Meilisearch nội bộ trên Linux VPS (hỗ trợ mượt từ Ubuntu, Debian, AlmaLinux 10 cho tới AlmaLinux 8/9 KVM/LXC) cùng tệp MU-Plugin thuần PHP chuẩn Enterprise — dùng Scoped API Key tách biệt từng website, tự động thích ứng cho cả Blog thuần lẫn WooCommerce, tăng tốc đồng bộ cả Trang tìm kiếm chính, AJAX Live Search lẫn WP-Admin Dashboard (tìm mượt tên bài, sản phẩm, SKU biến thể và ID), có sẵn Circuit Breaker, tách biệt chống lộ bản nháp, bảo mật ẩn header với người ngoài và có thể gỡ sạch không để lại rác bất cứ lúc nào — bạn đã sở hữu một cỗ máy tìm kiếm đẳng cấp mà không tốn thêm bất kỳ chi phí thuê bao hàng tháng nào. Chúc bạn triển khai thành công!



Để lại một bình luận