Tài liệu Hướng dẫnvPanel GUIPHP Versions

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.

PHP Versions

Tổng quan giao diện

Thành phầnMô tả
RefreshTải lại danh sách phiên bản từ trình quản lý gói.
SearchLọc nhanh theo số phiên bản (ví dụ 8.2).
Show entriesSố 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).
StatusInstalled (đã cài) hoặc Available (có thể cài đặt).
Memory LimitGiá trị memory_limit được đọc từ php.ini của phiên bản.
Sites UsingSố 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.
ActionsCá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ải lsphp<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 lsphp chưa được đăng ký trên server.
  • Giải pháp: Chạy lại install.sh hoặ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 lsphp bị 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
Đang tải mục lục...
Nội dung bài viết