ionCube Loader là một PHP extension dùng để giải mã và thực thi các file PHP đã được mã hóa bằng phần mềm ionCube Encoder. Nhiều theme và plugin WordPress thương mại sử dụng công nghệ này để bảo vệ mã nguồn khỏi bị sao chép trái phép.

Nếu website của bạn xuất hiện lỗi The ionCube PHP Loader needs to be installed, nghĩa là server chưa bật extension này. Hãy làm theo đúng hướng dẫn tương ứng với môi trường bạn đang dùng bên dưới.

ionCube Loader — PHP extension giải mã file đã được mã hóa bởi ionCube Encoder

Đây là cách phổ biến và đơn giản nhất. Hầu hết hosting đã cài sẵn ionCube, bạn chỉ cần bật lên là xong.

• 1Đăng nhập cPanel, vào mục Software → click Select PHP Version.
• 2Chọn phiên bản PHP phù hợp với website (khuyến nghị PHP 8.1 trở lên).
• 3Chuyển sang tab Extensions, tìm ioncube_loader và tích chọn vào ô.
• 4Nhấn Save hoặc Apply để lưu thay đổi.
• 5Quay lại website, nhấn F5 và kiểm tra lỗi đã hết chưa.

cPanel → Select PHP Version → tab Extensions → tích vào ioncube_loader → Save

VPSSIM là công cụ quản lý VPS phổ biến tại Việt Nam. Cài ionCube qua VPSSIM rất nhanh và tự động hoàn toàn.

• 1SSH vào VPS bằng tài khoản root, gõ vpssim để vào menu quản lý, ấn 1 vào menu chính.
• 2Chọn menu 14) Config Cau Hinh PHP.
• 3Chọn tiếp 13) Install / Remove Ioncube.
• 4Hệ thống hỏi xác nhận — gõ Y rồi nhấn Enter để bắt đầu cài tự động.
• 5Chờ cài xong, F5 lại website để kiểm tra.

VPSSIM → menu 1 → chọn 14 (Config PHP) → chọn 13 (Install/Remove Ioncube) → nhấn Y xác nhận

aaPanel (BaoTa Panel quốc tế) có giao diện đồ họa trực quan, cài PHP extension cực kỳ đơn giản qua App Store.

• 1Đăng nhập aaPanel, vào App Store (Cửa hàng ứng dụng).
• 2Tìm phiên bản PHP website đang dùng, click Setting.
• 3Chọn tab Install Extensions (Cài tiện ích mở rộng).
• 4Tìm dòng ionCube trong danh sách, nhấn Install.
• 5Chờ cài xong — khi nút chuyển thành Uninstall là hoàn tất thành công.

aaPanel → App Store → chọn phiên bản PHP → Setting → Install Extensions → tìm ionCube → Install

CyberPanel tích hợp sẵn OpenLiteSpeed. Cài ionCube qua giao diện admin đơn giản, chỉ lưu ý reboot VPS sau khi cài.

• 1Đăng nhập CyberPanel bằng tài khoản admin.
• 2Vào menu PHP → Cài đặt tiện ích mở rộng (Install PHP Extensions).
• 3Chọn phiên bản PHP website đang sử dụng.
• 4Gõ tìm kiếm ioncube rồi nhấn Cài đặt.
• 5Sau khi cài xong, reboot lại VPS để áp dụng thay đổi, sau đó kiểm tra website.

CyberPanel → PHP → Install PHP Extensions → chọn phiên bản PHP → tìm ioncube → Cài đặt

Dành cho VPS không có control panel hoặc người muốn kiểm soát hoàn toàn quá trình cài đặt.

php -v

cd /usr/local
wget https://downloads.ioncube.com/loader_downloads/ioncube_loaders_lin_x86-64.tar.gz
tar xzf ioncube_loaders_lin_x86-64.tar.gz

echo 'zend_extension = "/usr/local/ioncube/ioncube_loader_lin_8.1.so"' \
  | sudo tee -a /etc/php/8.1/cli/php.ini

echo 'zend_extension = "/usr/local/ioncube/ioncube_loader_lin_8.1.so"' \
  | sudo tee -a /etc/php/8.1/fpm/php.ini

sudo systemctl restart php8.1-fpm
sudo systemctl restart nginx   # hoặc: apache2

Cài ionCube thủ công qua SSH — thêm dòng zend_extension vào php.ini rồi restart PHP-FPM

Sau khi kích hoạt, dùng một trong 2 cách sau để xác nhận ionCube đang chạy đúng.

Tạo file info.php với nội dung bên dưới, upload lên hosting rồi truy cập yourdomain.com/info.php, tìm từ khóa “ionCube” trong trang.

<?php phpinfo(); ?>

⚠️ Nhớ xóa file info.php ngay sau khi kiểm tra xong để tránh lộ thông tin server.

php -m | grep ioncube

Nếu terminal trả về dòng ionCube Loader là đã cài thành công.

Kết quả phpinfo() hiển thị ionCube Loader đã được kích hoạt thành công trên server