Khắc phục lỗi WordPress LiteSpeed PHP: Hướng dẫn toàn diện từ A đến Z

Lỗi WordPress LiteSpeed PHP là một trong những vấn đề phổ biến nhất khi vận hành website trên môi trường LiteSpeed Server. Người dùng thường gặp các thông báo lỗi như “502 Bad Gateway”, “503 Service Unavailable”, “PHP Fatal Error” hoặc “Internal Server Error” khi plugin LiteSpeed Cache không tương thích với phiên bản PHP hoặc cấu hình hosting. Bài viết này sẽ giúp bạn hiểu rõ nguyên nhân, cách chẩn đoán và khắc phục triệt để mọi lỗi liên quan đến WordPress LiteSpeed PHP, giúp website hoạt động ổn định và tối ưu tốc độ.

WordPress LiteSpeed PHP lỗi là gì?

Lỗi WordPress LiteSpeed PHP xảy ra khi quá trình xử lý tập lệnh PHP trên máy chủ LiteSpeed gặp sự cố, dẫn đến website không thể truy cập hoặc hiển thị sai. LiteSpeed là một web server hiệu năng cao, thường đi kèm với plugin LiteSpeed Cache cho WordPress. Tuy nhiên, sự không tương thích giữa plugin, phiên bản PHP, hoặc cấu hình server có thể gây ra hàng loạt lỗi khác nhau.

Dấu hiệu nhận biết lỗi WordPress LiteSpeed PHP

• Trang web hiển thị màn hình trắng (White Screen of Death).
• Thông báo “502 Bad Gateway” hoặc “504 Gateway Timeout”.
• “503 Service Unavailable” khi kích hoạt plugin LiteSpeed Cache.
• Lỗi “PHP Fatal error: Uncaught Error” trong error log.
• Không thể truy cập wp-admin hoặc frontend.
• Plugin LiteSpeed Cache báo lỗi “LSCWP not loaded” hoặc “PHP version incompatible”.

Nguyên nhân phổ biến gây ra lỗi WordPress LiteSpeed PHP



Các nguyên nhân thường xuất phát từ ba yếu tố chính: phiên bản PHP, cấu hình plugin LiteSpeed Cache và giới hạn tài nguyên server.

Phiên bản PHP không tương thích

Plugin LiteSpeed Cache yêu cầu PHP 7.4 trở lên để hoạt động ổn định. Nếu bạn đang sử dụng PHP 7.3 hoặc cũ hơn, các hàm mới trong plugin sẽ gây lỗi. Một số hosting mặc định PHP 8.0/8.1, nhưng nếu theme hoặc plugin cũ không hỗ trợ, xung đột sẽ xảy ra.

Cài đặt PHP handler sai

Trên máy chủ LiteSpeed, PHP handler phải được đặt ở chế độ “LiteSpeed PHP” hoặc “LSAPI”. Nếu bạn chọn “CGI” hoặc “FastCGI”, plugin LiteSpeed Cache không thể giao tiếp chính xác với server, gây ra lỗi.

Giới hạn bộ nhớ PHP (memory_limit) quá thấp

Khi plugin cố gắng tối ưu CSS/JS hoặc cache, nó tiêu tốn nhiều bộ nhớ. Nếu memory_limit dưới 128MB, quá trình xử lý có thể bị ngắt và gây ra lỗi PHP.

Xung đột giữa các plugin cache

Nếu bạn đồng thời kích hoạt LiteSpeed Cache và một plugin cache khác (như W3 Total Cache, WP Rocket), chúng sẽ tranh chấp quyền kiểm soát. Kết quả là lỗi WordPress LiteSpeed PHP liên tục xuất hiện.

Hướng dẫn khắc phục lỗi WordPress LiteSpeed PHP chi tiết



Thực hiện theo thứ tự ưu tiên để tránh mất thời gian.

1. Kiểm tra và cập nhật phiên bản PHP

Đầu tiên, bạn cần xác định phiên bản PHP hiện tại. Vào cPanel → Select PHP Version hoặc qua LiteSpeed WebAdmin Console. Nếu PHP dưới 7.4, hãy nâng lên 8.0 hoặc 8.1. Lưu ý: kiểm tra tương thích của theme và plugin trước khi nâng cấp.

1. Truy cập cPanel → MultiPHP Manager (nếu có).
2. Chọn tên miền đang gặp lỗi.
3. Chọn phiên bản PHP 8.0 hoặc 8.1.
4. Nhấn Apply và kiểm tra website.

2. Chuyển đổi PHP handler sang LSAPI

Trong cPanel, tìm phần LiteSpeed Web Server → PHP Handler. Nếu đang chọn “CGI” hoặc “FastCGI”, chuyển sang “LiteSpeed PHP” hoặc “LSAPI”. Điều này giúp plugin LiteSpeed Cache tận dụng tối đa khả năng của máy chủ.

3. Tăng giới hạn bộ nhớ PHP (memory_limit)

Có thể thực hiện qua file wp-config.php hoặc cPanel. Thêm dòng sau vào wp-config.php trước dòng / That's all, stop editing! /:

define('WP_MEMORY_LIMIT', '256M');

Hoặc qua cPanel → Select PHP Version → Switch to PHP Options, tìm memory_limit và đặt giá trị 256M hoặc 512M.

4. Vô hiệu hóa tạm thời plugin LiteSpeed Cache

Nếu không thể truy cập wp-admin, hãy vào FTP hoặc File Manager, đổi tên thư mục /wp-content/plugins/litespeed-cache/ thành /wp-content/plugins/litespeed-cache-backup/. Sau đó kiểm tra xem lỗi còn không. Nếu hết, đó là do plugin gây ra.

Không nhất thiết. LiteSpeed Cache hỗ trợ tốt cho PHP 8.0 và 8.1. PHP 8.2 có thể gây ra lỗi với một số plugin chưa cập nhật. Chỉ nên nâng lên 8.2 nếu bạn chắc chắn mọi thành phần đều tương thích.

Lỗi “503 Service Unavailable” có phải do WordPress LiteSpeed PHP không?

Có thể. Khi plugin cố gắng tạo cache trong quá trình xử lý PHP nhưng server không đáp ứng kịp, nó sẽ trả về 503. Kiểm tra memory_limit và max_execution_time để khắc phục.

Có thể sử dụng LiteSpeed Cache với các hosting không dùng LiteSpeed Server không?

Không. Plugin này chỉ hoạt động hiệu quả trên máy chủ sử dụng LiteSpeed Web Server. Nếu bạn dùng Apache hoặc Nginx, hãy chọn plugin cache khác như WP Rocket hoặc W3 Total Cache.

Lỗi “Call to undefined function litespeed_request_headers()” sửa thế nào?

Lỗi này cho thấy plugin chưa được kích hoạt đúng cách hoặc file chính bị thiếu. Hãy xóa plugin và cài lại phiên bản mới từ WordPress.org. Nếu vẫn lỗi, kiểm tra PHP handler xem có ở chế độ LSAPI không.

Kết luận

Lỗi WordPress LiteSpeed PHP có thể khiến bạn đau đầu, nhưng với hướng dẫn chi tiết trong bài viết này, bạn hoàn toàn có thể tự khắc phục. Hãy bắt đầu bằng việc kiểm tra phiên bản PHP và chuyển handler sang LSAPI. Đừng quên tăng memory_limit và xóa cache cũ. Nếu lỗi vẫn còn, error log sẽ là cứu cánh. Với cách tiếp cận có hệ thống, bạn sẽ đưa website trở lại hoạt động nhanh chóng và tận dụng tối đa sức mạnh của LiteSpeed Cache.