PHP Versions
QUẢN LÝ PHIÊN BẢN PHP TRÊN VPANEL
Hướng dẫn chi tiết cách cài đặt, gỡ bỏ và thiết lập phiên bản PHP mặc định trên nền tảng OpenLiteSpeed (lsphp). Module này cho phép quản trị viên hỗ trợ nhiều phiên bản PHP song song để mỗi tài khoản hosting có thể chọn runtime phù hợp với ứng dụng của mình.
1. Truy cập PHP Versions
Đăng nhập vào Admin Panel ở cổng :2087. Trên thanh sidebar, mở Software và chọn PHP Versions.

Tổng quan giao diện
| Thành phần | Mô tả |
|---|---|
| Refresh | Tải lại danh sách phiên bản từ trình quản lý gói. |
| Search | Lọc nhanh theo số phiên bản (ví dụ 8.2). |
| Show entries | Số dòng hiển thị mỗi trang (10, 20, 50). |
Các cột trong bảng
| Cột | Ý nghĩa |
|---|---|
| Version | Định danh phiên bản PHP (7.4, 8.0, 8.1, 8.2, 8.3, 8.4). |
| Status | Installed (đã cài) hoặc Available (có thể cài đặt). |
| Memory Limit | Giá trị memory_limit được đọc từ php.ini của phiên bản. |
| Sites Using | Số website đang sử dụng phiên bản PHP này. |
| Default | Đánh dấu phiên bản mặc định của toàn server. |
| Actions | Các nút Install, Remove hoặc Set Default tuỳ trạng thái. |
2. Cài đặt phiên bản PHP mới
- Bước 1: Ở dòng phiên bản Available, nhấn Install.
- Bước 2: Xác nhận trong hộp thoại. vPanel sẽ gọi
apt/dnfđể tảilsphp<phiên-bản>cùng các extension phổ biến. - Bước 3: Chờ tác vụ hoàn tất — trạng thái sẽ tự động chuyển sang Installed.
Quá trình cài đặt chạy bất đồng bộ dưới dạng background task. Bạn có thể rời trang và quay lại sau; tiến trình vẫn được theo dõi.
3. Đặt phiên bản mặc định
- Bước 1: Ở dòng phiên bản đã cài, nhấn Set Default.
- Bước 2: Xác nhận. Giá trị mặc định sẽ áp dụng cho các website mới và những website đang kế thừa cấu hình server.
Các website hiện có vẫn giữ nguyên phiên bản PHP đang chọn cho tới khi bạn thay đổi trong List Accounts → Manage → PHP.
4. Gỡ bỏ phiên bản PHP
- Bước 1: Đảm bảo cột Sites Using hiển thị
0. Phiên bản đang được sử dụng không thể gỡ bỏ. - Bước 2: Nhấn Remove và xác nhận.
Không thể gỡ phiên bản đang được đặt làm mặc định. Hãy chọn phiên bản mặc định khác trước.
5. Khắc phục sự cố và lưu ý
Cài đặt thất bại với thông báo "package not found"
- Nguyên nhân: Repository
lsphpchưa được đăng ký trên server. - Giải pháp: Chạy lại
install.shhoặc thêm repository LiteSpeed thủ công.
Set Default không có hiệu lực với website hiện có
- Nguyên nhân: Website đó đang chọn phiên bản PHP cố định.
- Giải pháp: Chỉnh sửa website trong List Accounts và chọn Use Server Default.
Phiên bản PHP biến mất sau khi reboot
- Nguyên nhân: Gói
lsphpbị hold bởi cơ chế unattended-upgrades. - Giải pháp: Bỏ hold bằng lệnh
apt-mark unhold lsphp<phiên-bản>.
Chúc bạn quản trị Server an toàn và hiệu quả!
Lần cuối cập nhật: 8/7/2026
Nội dung bài viết
Nội dung bài viết
