PHP Version
HƯỚNG DẪN PHP VERSION TRÊN VPANEL
Trang PHP Version cho phép chọn phiên bản PHP cho từng domain, bật/tắt extension, và tinh chỉnh các thông số php.ini phổ biến như memory_limit, upload_max_filesize, max_execution_time. Mỗi thiết lập áp riêng theo domain qua cơ chế PHP_INI_SCAN_DIR của OpenLiteSpeed, nên các site khác nhau trên cùng server có thể chạy cấu hình khác nhau một cách an toàn.
1. Chọn phiên bản PHP
Đăng nhập User Panel cổng :2083. Ở thanh bên, chọn PHP Version trong nhóm Software.
Giao diện
| Thành phần | Mô tả |
|---|---|
| Chọn Domain | Chọn domain cần cấu hình. |
| Current Version Badge | Phiên bản PHP đang chạy trên domain. |
| Available Versions Dropdown | Toàn bộ PHP admin đã cài (VD: 7.4, 8.0, 8.1, 8.2, 8.3). |
| Apply Button | Chuyển sang phiên bản đã chọn. |
Chọn phiên bản và nhấn Apply. vPanel cập nhật PHP handler của vhost và reload OpenLiteSpeed.
Cảnh báo: Chuyển PHP 7.x → 8.x có thể làm hỏng code dùng cú pháp cũ (dynamic property, curly-brace access). Nhớ sao lưu trước.
2. Quản lý PHP Extension
Sang tab Extensions.
Danh sách hiển thị mọi extension có sẵn cùng toggle từng cái:
| Cột | Mô tả |
|---|---|
| Extension | Tên (VD: curl, gd, mbstring, intl, imagick). |
| Description | Mô tả ngắn công dụng. |
| Enabled | Toggle để load/unload extension cho domain. |
Bật/tắt rồi nhấn Save Extensions. vPanel ghi INI vào scan dir của domain và kill worker lsphp liên quan để request kế tiếp nạp cấu hình mới.
Lưu ý: Một số extension core (như
opcache) luôn bật — toggle bị disable để tránh nhầm.
3. Chỉnh PHP Options (php.ini)
Sang tab Options.
Các thông số thường tinh chỉnh:
| Directive | Khoảng phổ biến | Ý nghĩa |
|---|---|---|
| memory_limit | 128M – 1024M | RAM tối đa cho một request. |
| upload_max_filesize | 2M – 256M | Kích thước file lớn nhất khi upload. |
| post_max_size | ≥ upload_max_filesize | Tổng dung lượng POST body. |
| max_execution_time | 30 – 600 | Số giây script được chạy. |
| max_input_time | 60 – 600 | Số giây để parse input. |
| max_input_vars | 1000 – 10000 | Số biến GET/POST tối đa. Tăng cho form lớn. |
| display_errors | Off (prod), On (dev) | Hiển thị lỗi PHP trong response. |
| date.timezone | Asia/Ho_Chi_Minh | Timezone mặc định. |
Sửa xong nhấn Save Options. Cùng cơ chế scan-dir như extension — không cần service reload.
4. Xử lý sự cố
Dropdown phiên bản trống
- Nguyên nhân: Admin chưa cài PHP nào, hoặc gói không cho phép đổi phiên bản.
- Cách xử lý: Liên hệ admin.
Extension đã bật nhưng không load
- Cause: Extension chưa có bản cho PHP hiện tại.
- Cách xử lý: Xác nhận extension có sẵn cho phiên bản đó — một số (VD:
mcrypt) đã bị bỏ ở PHP 8.
Đổi upload_max_filesize mà không hiệu lực
- Nguyên nhân: Worker
lsphpchưa recycle, hoặc Cloudflare/reverse proxy giới hạn nhỏ hơn. - Cách xử lý: Đợi ~30 giây, hoặc tăng giới hạn
client_max_body_sizephía trên.
Trắng trang sau khi chuyển PHP 7 → 8
- Nguyên nhân: Code dùng cú pháp deprecated/removed.
- Cách xử lý: Bật tạm
display_errors=On, load site, đọc lỗi fatal, sửa hoặc quay lại PHP 7.4.
Chúc bạn quản trị Server an toàn và hiệu quả!