Page cache có thể làm một trang Botble phản hồi nhanh hơn vì request sau không phải chạy lại controller, query, theme, widget và shortcode. Nhưng nếu HTML đó chứa giá, tồn kho, currency hoặc tên người dùng không đúng, “nhanh” lập tức trở thành lỗi dữ liệu. Vì vậy Page Cache Beta của Botble không bật sẵn: tài liệu yêu cầu đi từ Off sang Test (shadow), đọc kết quả rồi mới cân nhắc On.

Bài này tập trung vào quyết định rollout, không benchmark tốc độ. Môi trường kiểm tra hiện tại không có bộ cài Botble 7.6.13+ được cấp phép, nên ma trận bên dưới là mô hình được dựng từ rule trong tài liệu chính thức, không phải log runtime của một site thật. Giới hạn này quan trọng: nó đủ để chuẩn bị test, nhưng không thay được 24 giờ traffic trên chính theme và plugin của các bạn.

Page Cache Beta khác cache ứng dụng ở đâu?

Theo tài liệu Page Cache Beta của Botble, tính năng có từ Botble CMS 7.6.13, mặc định Off và lưu HTML hoàn chỉnh dưới storage/framework/page-cache. Cache ứng dụng thường lưu query, object hoặc kết quả nhỏ bên trong quá trình render; page cache đi xa hơn: với một cache hit, phần render trang được bỏ qua.

Page cache cũng không đồng nghĩa với Public Cache Control. Public Cache Control cho phép CDN hoặc reverse proxy như Cloudflare/Varnish giữ response bên ngoài ứng dụng. Page cache nằm ngay trong Botble và có thể dùng trên shared hosting không có Redis hay quyền cấu hình nginx. Hai lớp có thể cùng tồn tại, nên khi debug cần nhìn đúng header của từng lớp thay vì gom tất cả thành một chữ “cache”.

Chỗ dễ nhầm là session vẫn chạy qua middleware ngay cả khi HTML được lấy từ page cache. Tài liệu nói khách vẫn có session cookie và CSRF token riêng. Tuy vậy, request có cart, wishlist, flash message, form error, currency hoặc cookie ảnh hưởng HTML sẽ bị BYPASS; không nên suy ra rằng mọi trang có form đều an toàn chỉ vì middleware còn chạy.

Bắt đầu bằng Shadow, đừng nhảy thẳng sang On

Trong Admin, tùy chọn nằm ở Settings → Cache → Page cache (server-side) — Beta. Có ba mode: Off không lưu hoặc phục vụ cache; Test (shadow) lưu bản ứng viên nhưng vẫn render live cho khách; On mới phục vụ HTML đã lưu. Nếu đặt biến môi trường thì CMS_PAGE_CACHE_MODE thắng cài đặt trong Admin và ô chọn sẽ bị khóa.

CMS_PAGE_CACHE_MODE=shadow
CMS_PAGE_CACHE_TTL=600
CMS_PAGE_CACHE_MAX_BODY_KB=2048

Không copy nguyên ba dòng này lên production rồi xem như xong. Trước hết hãy xác nhận site đã ở 7.6.13 trở lên, backup có thể restore và cron đang chạy. Bài kiểm tra restore Botble trước khi cần cứu site là bước đệm hợp lý, vì rollback cấu hình không giúp được nếu thay đổi khác đã làm hỏng dữ liệu.

Shadow có một ưu điểm đẹp: khách vẫn nhận trang render mới, còn Botble so HTML hiện tại với bản đã lưu và ghi kết quả vào log. Nghĩa là có thể quan sát mismatch mà chưa phục vụ bản cache cho người dùng. Sau vài ngày, lệnh report tổng hợp 24 giờ hoặc bảy ngày:

php artisan cms:page-cache:report
php artisan cms:page-cache:report --days=7

Tên lệnh cần được kiểm lại bằng php artisan list trên đúng bản cài. Tài liệu là rolling docs; một site chưa nâng đủ phiên bản sẽ không có command dù trang hướng dẫn hiện tại đã mô tả nó.

Đọc header mà không tự đánh lừa mình

Ở shadow mode, response có thể là MISS, SHADOW-MATCH, SHADOW-MISMATCH hoặc BYPASS. MISS thường là lần đầu Botble tạo bản ứng viên. SHADOW-MATCH cho biết lần render mới khớp bản đã lưu. SHADOW-MISMATCH nghĩa là HTML khác; report sẽ chỉ vị trí khác đầu tiên. BYPASS là request không đủ điều kiện cache ngay từ đầu.

Khi chuyển sang On, bộ header chính đổi thành HIT, MISS và BYPASS; X-Page-Cache-Age cho biết tuổi cache. Đừng dùng một request HIT làm bằng chứng mọi route an toàn. Nó chỉ chứng minh URL và trạng thái request đó đã đi qua cache.

Ma trận request guest UTM filter cart và block ngẫu nhiên trong shadow mode
Ma trận kỳ vọng dựng từ rule tài liệu Botble; đây không phải log runtime của production.

Ma trận trên được tạo bằng một script nhỏ từ các rule công khai: tracking key như utm_source được bỏ qua khi tạo cache key; filter query tùy ý bị bypass; cart cookie tạo trạng thái cá nhân; block ngẫu nhiên và giá thay đổi ngoài đường invalidation tạo mismatch. Nó là checklist kỳ vọng để chuẩn bị test, không phải khẳng định một phiên Botble đã trả đúng các header này.

Tình huốngKỳ vọngViệc cần kiểm
Guest, URL chuẩn, HTML ổn địnhSHADOW-MATCH sau lần đầuSo nội dung và canonical
Có UTM/analytics query được hỗ trợDùng cùng cache keyKhông để tracking làm nổ số entry
Search, filter, sort, currencyBYPASSQuery nào thực sự đổi HTML
Cart, wishlist, flash, form errorBYPASSCookie và session key nào đang hoạt động
Random block hoặc markup theo thiết bịMismatch nếu key chưa táchLoại URL hoặc thêm cache-key part
Giá/tồn kho đổi ngoài AdminCó thể cũ tới TTLGọi clear cache từ job đồng bộ

Sáu case nên chạy trên staging

Đầu tiên là guest thuần ở trang tĩnh. Dùng private window, gọi cùng canonical hai lần và lưu toàn bộ X-Page-Cache*. Đây là positive control. Tiếp theo thêm utm_source để xác nhận tracking parameter không tạo hành vi khác. Case thứ ba dùng search hoặc filter query; đây phải là negative control vì nội dung thay đổi theo query.

Case thứ tư tạo cart hoặc cookie thật trên staging, nhưng không dùng dữ liệu khách hàng. Kết quả đúng là render live. Case thứ năm dựng một block ngẫu nhiên hoặc view counter để xem report phân loại match-volatile, mismatch hay bypass. Đừng tự xếp mọi mismatch là “vô hại”: một banner xoay ngẫu nhiên khác hoàn toàn giá và tồn kho.

Case cuối cùng thay đổi dữ liệu bên ngoài Admin/API chuẩn, chẳng hạn cập nhật bảng synthetic bằng job. Tài liệu nói các thay đổi content qua Admin sẽ clear page cache, còn dữ liệu đổi ngoài đường này có thể cũ tới hết TTL. Nếu website đồng bộ giá từ ERP, job đồng bộ cần gọi clear cache hoặc action flush phù hợp thay vì chờ khách phát hiện.

Theme render HTML khác nhau dựa trên user agent cũng cần một nhánh riêng. Responsive CSS không phải vấn đề; server-side markup cho mobile/desktop mới là rủi ro. Botble cung cấp filter cms_page_cache_key_parts để thêm thiết bị vào key. Chỉ dùng khi thật sự cần, vì mỗi key part nhân số bản cache phải quản lý.

Mismatch nào phải chặn trước khi bật?

Một ID ngẫu nhiên, nonce chỉ dùng ở client hoặc thứ tự bài “gợi ý ngẫu nhiên” có thể là mismatch chấp nhận được nếu không chứa dữ liệu riêng. Tuy nhiên giá, stock, cart, currency, tên người dùng, nội dung theo quyền hoặc token là tín hiệu dừng. Với nhóm này, lựa chọn an toàn là thêm URL vào Never cache, sửa component để render client-side, hoặc đưa đúng dimension vào cache key.

Shortcode động cũng là điểm phải soi kỹ. Bài test cache và escape cho Botble shortcode động xử lý cache ở cấp component; page cache lưu luôn output cuối của shortcode. Nếu shortcode ghi session, set cookie hoặc có side effect trong lúc render, cache hit có thể khiến code đó không chạy. Tài liệu Botble nêu rõ view counter và recently viewed là hai giới hạn đã biết.

Cây quyết định từ mismatch và bypass tới giữ Shadow loại URL hoặc bật On
Mismatch liên quan dữ liệu riêng hoặc giá cần chặn trước; chỉ bật On sau khi traffic đại diện đã sạch.

Chỉ nên sang On khi report đã phủ traffic đại diện, mọi mismatch có giải thích và đường rollback đã thử. Bắt đầu với TTL ngắn, quan sát HIT/MISS/BYPASS, rồi tăng dần nếu dữ liệu cho phép. Không cần chạy theo con số “would-hit” đẹp nếu phần còn lại chứa một mismatch nguy hiểm.

Kill switch phải thật sự dùng được

Nếu thấy HTML sai sau khi bật, đặt CMS_PAGE_CACHE_MODE=off hoặc chọn Off trong Admin để quay lại render live. Đây là kill switch, không phải thao tác “để lát nữa”. Sau đó ghi lại URL, request state và header; chuyển lại Shadow để tái hiện. Xóa cache mù quáng có thể làm lỗi biến mất tạm thời nhưng không giải thích vì sao entry sai được tạo.

Bài Botble hiện giao diện cũ sau deploy có quy trình tách browser, CDN, application cache, theme và asset. Quy trình đó vẫn hữu ích ở đây: page cache chỉ là một lớp. Nếu response HTML đã đúng mà CSS cũ, bật/tắt page cache không chữa được asset cache hoặc CDN.

Cũng cần cron cho cms:page-cache:prune. Tài liệu nói entry hết hạn được dọn hằng ngày qua scheduler, và có cơ chế dọn xác suất khi lưu nhiều trang nếu thiếu cron. Cơ chế dự phòng không phải lý do bỏ cron, đặc biệt trên shared hosting có dung lượng nhỏ.

Bằng chứng tối thiểu trước khi chuyển On

Một rollout đủ chắc nên giữ lại exact version Botble/PHP/Laravel, cache và session driver; kết quả php artisan list; request matrix đã scrub cookie; report 24 giờ và bảy ngày; danh sách URL loại trừ; TTL; cách flush từ job ngoài; và thời gian rollback. Không ghi secret, session ID hay dữ liệu khách vào artifact chia sẻ.

Nếu chưa có bản cài 7.6.13+ để chạy staging, hãy dừng ở bước chuẩn bị. Ma trận từ tài liệu giúp biết phải test gì, nhưng không chứng minh theme, plugin và cookie của site tương thích. Oke, chậm thêm một ngày shadow vẫn rẻ hơn phục vụ nhầm giá hoặc cart cho khách.

Chốt lại

Shadow mode đáng dùng vì nó tách hai việc: quan sát cache candidate và phục vụ cache cho khách. Hãy bắt đầu bằng guest tĩnh, cố tình tạo BYPASS, tái hiện một mismatch vô hại rồi kiểm các nhánh nguy hiểm như giá, cart, currency và markup theo thiết bị. Khi mọi mismatch đã có lời giải, mới bật On với TTL ngắn và kill switch sẵn tay.

Page cache không phải nút tăng tốc chung cho mọi site. Nó là một thay đổi kiến trúc render có điều kiện. Bằng chứng tốt nhất không nằm ở claim 3–6× của nhà cung cấp, mà ở report và request matrix của chính website trong những ngày có traffic thật.