PHP Extensions
QUẢN LÝ PHP EXTENSIONS TRÊN VPANEL
Hướng dẫn chi tiết cách bật/tắt các extension PHP cho từng phiên bản PHP đã cài đặt. Module PHP Extensions hoạt động ở cấp server — trạng thái extension áp dụng cho mọi website đang chạy phiên bản PHP tương ứng.
1. Truy cập PHP Extensions
Đăng nhập vào Admin Panel ở cổng :2087. Trên sidebar, mở Software và nhấn PHP Extensions.
Tổng quan giao diện
| Thành phần | Mô tả |
|---|---|
| PHP Version | Menu chọn phiên bản PHP cần quản lý (7.4 … 8.4). |
| Search | Lọc extension theo tên (ví dụ redis, imagick). |
| Enable All | Bật hàng loạt toàn bộ extension hỗ trợ cho phiên bản đó. |
| Disable All | Tắt hàng loạt các extension đang bật. |
| Apply Changes | Lưu trạng thái checkbox và graceful restart OpenLiteSpeed. |
Danh sách extension
Mỗi dòng là một checkbox tương ứng với một extension:
| Cột | Ý nghĩa |
|---|---|
| Enabled | Checkbox — được tick nghĩa là extension sẽ được nạp khi PHP khởi động. |
| Name | Tên extension (curl, gd, mbstring, intl, redis, imagick, xdebug, opcache, mysqli…). |
| Description | Mô tả ngắn gọn về chức năng extension. |
| Package | Gói hệ thống cung cấp extension đó. |
2. Bật / tắt extension
- Bước 1: Chọn phiên bản PHP muốn cấu hình trong menu PHP Version.
- Bước 2: Tick vào checkbox của extension cần bật, hoặc bỏ tick để tắt.
- Bước 3: Nhấn Apply Changes. vPanel sẽ ghi lại các file INI và graceful restart
lshttpd.
Graceful restart chỉ khởi động lại nhẹ nhàng tiến trình PHP worker. Các yêu cầu HTTP đang xử lý được hoàn tất trước khi thay thế, nên người dùng không gặp lỗi.
3. Thao tác hàng loạt
Sử dụng Enable All để bật toàn bộ extension mà phiên bản hỗ trợ — hữu ích khi chuẩn bị server mới cho một stack CMS phổ biến.
Sử dụng Disable All để loại bỏ các extension không cần thiết trên server sản xuất đã được hardening. Chỉ các module Core, date, pcre và Reflection được giữ mặc định.
4. Khắc phục sự cố và lưu ý
Extension hiển thị đã cài nhưng PHP không nạp
- Nguyên nhân: File INI của extension tồn tại nhưng bị tắt bởi cơ chế khác (ví dụ
phpdismod). - Giải pháp: Bỏ tick rồi tick lại checkbox, sau đó nhấn Apply Changes để tái tạo trạng thái.
Website trả về lỗi 503 sau khi áp dụng thay đổi
- Nguyên nhân: Extension mới bật xung đột với
opcachehoặcxdebug. - Giải pháp: Tắt extension gây lỗi và kiểm tra
/usr/local/lsws/logs/error.log.
Redis / Imagick không kích hoạt được
- Nguyên nhân: Thư viện hệ thống đi kèm chưa được cài (ví dụ
libhiredis,libmagickwand). - Giải pháp: Cài đặt gói phụ thuộc ở tầng OS rồi mở lại trang extension.
Chúc bạn quản trị Server an toàn và hiệu quả!