Chuyển tới nội dung chính

aaPanel: Quản Lý Phiên Bản PHP Hiệu Quả

Giới Thiệu​

Việc quản lý các phiên bản PHP khác nhau là một nhiệm vụ quan trọng đối với bất kỳ quản trị viên máy chủ hoặc nhà phát triển web nào. Các phiên bản PHP mới hơn thường mang lại hiệu suất tốt hơn, các tính năng mới và các bản vá bảo mật quan trọng, trong khi các ứng dụng cũ hơn có thể yêu cầu các phiên bản PHP cụ thể để hoạt động ổn định. aaPanel là một bảng điều khiển quản lý máy chủ web mạnh mẽ, giúp bạn dễ dàng cài đặt, chuyển đổi và quản lý nhiều phiên bản PHP một cách linh hoạt cho toàn bộ máy chủ hoặc cho từng website riêng lẻ.

Hướng dẫn này sẽ chỉ cho bạn cách tận dụng tối đa khả năng quản lý PHP của aaPanel, đảm bảo các ứng dụng web của bạn luôn chạy trên phiên bản PHP phù hợp nhất.

📋 Thời gian: ~10 phút | Độ khó: Cơ bản

Yêu Cầu​

Để thực hiện theo hướng dẫn này, bạn cần:

  • Một máy chủ đã cài đặt và cấu hình aaPanel hoạt động.
  • Quyền truy cập vào giao diện quản trị aaPanel với tài khoản quản trị.
  • Hiểu biết cơ bản về cách hoạt động của các ứng dụng web và PHP.

Các Bước Thực Hiện​

Bước 1: Cài Đặt Các Phiên Bản PHP Khác Nhau​

Trước tiên, chúng ta cần cài đặt các phiên bản PHP mà bạn muốn sử dụng trên máy chủ của mình. aaPanel cho phép bạn cài đặt nhiều phiên bản PHP cùng lúc.

  1. Đăng nhập vào bảng điều khiển aaPanel của bạn.
  2. Trên thanh điều hướng bên trái, nhấp vào mục "App Store".
  3. Trong phần "App Store", bạn sẽ thấy danh sách các ứng dụng có thể cài đặt. Tìm kiếm các phiên bản PHP bạn muốn (ví dụ: PHP-7.4, PHP-8.0, PHP-8.1, PHP-8.2).
  4. Nhấp vào nút "Install" bên cạnh mỗi phiên bản PHP bạn muốn thêm vào máy chủ. ⚠️ Lưu ý: Quá trình cài đặt có thể mất vài phút tùy thuộc vào tốc độ mạng và tài nguyên máy chủ của bạn. Đảm bảo cài đặt các phiên bản PHP-FPM để có hiệu suất tốt nhất.

Bước 2: Chuyển Đổi Phiên Bản PHP Mặc Định Cho Máy Chủ​

Sau khi cài đặt các phiên bản PHP, bạn có thể thiết lập một phiên bản PHP mặc định cho toàn bộ máy chủ. Phiên bản này sẽ được áp dụng cho tất cả các website trừ khi bạn cấu hình cụ thể cho từng website.

  1. Trong aaPanel, đi tới "App Store".
  2. Nhấp vào tab "Installed" để xem các ứng dụng đã cài đặt.
  3. Tìm kiếm mục "PHP Manager" hoặc bất kỳ phiên bản PHP nào đã cài đặt (ví dụ: PHP-7.4, PHP-8.0).
  4. Nhấp vào nút "Settings" (biểu tượng bánh răng) bên cạnh một phiên bản PHP đã cài đặt.
  5. Trong cửa sổ cài đặt của PHP, bạn sẽ thấy tùy chọn để đặt nó làm phiên bản mặc định. Chọn phiên bản PHP bạn muốn và nhấp vào nút "Set as Default". ✅ Một thông báo xác nhận sẽ xuất hiện khi thay đổi thành công.

Bước 3: Cấu Hình PHP Cho Từng Website Cụ Thể​

Đây là tính năng quan trọng nhất, cho phép bạn chỉ định phiên bản PHP riêng biệt cho mỗi website, đảm bảo tính tương thích và hiệu suất tối ưu.

  1. Trên thanh điều hướng bên trái, nhấp vào mục "Website".
  2. Tìm website bạn muốn thay đổi phiên bản PHP trong danh sách.
  3. Nhấp vào nút "Settings" (biểu tượng bánh răng) bên cạnh tên miền của website đó.
  4. Trong cửa sổ cài đặt website, tìm tab "PHP Version".
  5. Từ menu thả xuống, chọn phiên bản PHP mong muốn cho website này (ví dụ: PHP-8.1).
  6. Nhấp vào nút "Save" để áp dụng thay đổi. 💡 Mẹo: Nếu bạn có các ứng dụng cũ hơn cần PHP 7.4 và các ứng dụng mới cần PHP 8.2, bạn có thể dễ dàng quản lý chúng mà không cần nhiều máy chủ.

Bước 4: Quản Lý Tiện Ích Mở Rộng PHP (Extensions)​

Mỗi phiên bản PHP có bộ tiện ích mở rộng (extensions) riêng. Bạn có thể cần cài đặt các tiện ích mở rộng cụ thể cho ứng dụng của mình (ví dụ: gd, mysqli, opcache, redis).

  1. Đi tới "App Store" -> tab "Installed".
  2. Tìm phiên bản PHP mà bạn muốn quản lý tiện ích mở rộng (ví dụ: PHP-8.2).
  3. Nhấp vào nút "Settings" (biểu tượng bánh răng) bên cạnh phiên bản PHP đó.
  4. Trong cửa sổ cài đặt, chuyển đến tab "Install extensions".
  5. Chọn các tiện ích mở rộng bạn cần và nhấp vào "Install". 
    # Ví dụ kiểm tra các tiện ích mở rộng đã cài đặt cho PHP CLI (tùy thuộc vào cấu hình aaPanel)
    php -m | grep gd
    # Kiểm tra phiên bản PHP hiện tại của CLI
    php -v
    ⚠️ Quan trọng: Sau khi cài đặt tiện ích mở rộng, bạn nên khởi động lại dịch vụ PHP-FPM cho phiên bản PHP đó để các thay đổi có hiệu lực.

Bước 5: Khởi Động Lại Dịch Vụ PHP và Kiểm Tra​

Sau khi thực hiện bất kỳ thay đổi nào liên quan đến PHP (chuyển đổi phiên bản, cài đặt tiện ích mở rộng), việc khởi động lại dịch vụ PHP-FPM là cần thiết để các thay đổi có hiệu lực.

  1. Đi tới "App Store" -> tab "Installed".
  2. Tìm phiên bản PHP mà bạn đã thay đổi.
  3. Nhấp vào nút "Settings" (biểu tượng bánh răng) bên cạnh phiên bản PHP đó.
  4. Trong cửa sổ cài đặt, nhấp vào nút "Restart". ✅ Sau khi khởi động lại thành công, các thay đổi của bạn sẽ được áp dụng.

Để kiểm tra xem phiên bản PHP đã thay đổi đúng cách chưa, bạn có thể tạo một tệp info.php trong thư mục gốc của website với nội dung sau:

<?php
phpinfo();
?>

Sau đó truy cập yourdomain.com/info.php trên trình duyệt để xem thông tin chi tiết về phiên bản PHP đang chạy. Đừng quên xóa tệp info.php sau khi kiểm tra xong vì lý do bảo mật.

Troubleshooting​

  • Website hiển thị lỗi 500 hoặc không tải được:
    • Nguyên nhân: Phiên bản PHP được chọn không tương thích với mã nguồn website của bạn hoặc thiếu tiện ích mở rộng cần thiết.
    • Giải pháp: Thử chuyển về phiên bản PHP trước đó mà website hoạt động hoặc kiểm tra log lỗi của website (thường nằm trong /www/wwwlogs/yourdomain.com_error.log). Cài đặt các tiện ích mở rộng PHP bị thiếu.
  • Phiên bản PHP không thay đổi sau khi lưu:
    • Nguyên nhân: Dịch vụ PHP-FPM chưa được khởi động lại hoặc có lỗi cấu hình.
    • Giải pháp: Đảm bảo bạn đã nhấp "Restart" cho phiên bản PHP tương ứng. Nếu vẫn không được, thử khởi động lại toàn bộ máy chủ hoặc sử dụng lệnh bt trong SSH để sửa lỗi aaPanel.
    # Chạy lệnh fix panel nếu gặp lỗi không xác định trên aaPanel
    bt
    # Chọn tùy chọn để fix panel hoặc rebuild environment
  • Lỗi khi cài đặt tiện ích mở rộng PHP:
    • Nguyên nhân: Thiếu thư viện hệ thống, lỗi biên dịch hoặc xung đột.
    • Giải pháp: Đảm bảo hệ điều hành của bạn được cập nhật. Kiểm tra log cài đặt trong aaPanel để xem chi tiết lỗi.

Kết Luận​

aaPanel cung cấp một giao diện trực quan và mạnh mẽ để quản lý các phiên bản PHP, giúp bạn dễ dàng chuyển đổi giữa các phiên bản, cài đặt tiện ích mở rộng và tối ưu hóa môi trường chạy cho các ứng dụng web của mình. Bằng cách làm theo các bước trong hướng dẫn này, bạn có thể đảm bảo rằng các website của mình luôn hoạt động trên phiên bản PHP phù hợp nhất, mang lại hiệu suất cao và bảo mật tốt.

💡 Best practices:

  • Luôn sử dụng phiên bản PHP mới nhất có thể cho các dự án mới để tận dụng hiệu suất và tính năng bảo mật.
  • Kiểm tra kỹ lưỡng các thay đổi phiên bản PHP trên môi trường phát triển hoặc staging trước khi áp dụng cho môi trường production.
  • Thường xuyên cập nhật các phiên bản PHP để nhận các bản vá bảo mật và cải tiến hiệu suất.