Ứng dụng PHP

Cài Joomla, OpenCart, PrestaShop, phpBB, MediaWiki hoặc Laravel bằng một chạm, tìm trang quản trị của từng ứng dụng và chạy ứng dụng PHP bạn tự tải lên.

Cập nhật 09/10/2026 · 9 phút đọc

ZoPanel cài các ứng dụng PHP phổ biến vào một website PHP trống chỉ bằng một chạm: tải bản ổn định mới nhất từ nguồn chính thức, tạo database MariaDB và chạy trình cài đặt dòng lệnh của chính ứng dụng dưới quyền tài khoản hosting. Hãy dùng tính năng này để dựng nhanh một website mới; với code bạn phát triển trên Git, dùng Git deploy, còn WordPress xem WordPress Toolkit.

Trước khi bắt đầu

• Một website PHP còn trống. Tạo website loại PHP ở Website → Thêm website (xem Website và PHP). Trình cài đặt từ chối thư mục đã có file; chỉ chấp nhận index.html mặc định, .well-known và .user.ini.
• Còn chỗ cho một database. Mỗi ứng dụng có database riêng, tính vào giới hạn database của gói và của license (bản Free: 10 database, xem License).
• Phiên bản PHP phù hợp đã cài ở mục Runtime (xem bảng bên dưới). Laravel còn cần Composer, cài ở Runtime → Composer.
• Gói hosting phải bật Cài ứng dụng & công cụ WordPress. Nếu không, thẻ cài ứng dụng sẽ không hiện.

Hãy trỏ tên miền về máy chủ và bật SSL trước khi cài: ứng dụng chỉ được cấu hình với https:// khi website đã có chứng chỉ.

Ứng dụng được hỗ trợ

Panel kiểm tra theo dải trên, dải này theo đúng bản phát hành được cài:

Nếu phiên bản PHP của website nằm ngoài dải của panel, ZoPanel chuyển website sang phiên bản mới nhất đã cài nằm trong dải. Nếu không có phiên bản nào, quá trình cài dừng với thông báo "<Ứng dụng> needs PHP <dải>; ask the administrator to install a suitable PHP version". Muốn tự chọn phiên bản, hãy đặt Phiên bản PHP ở tab PHP & cấu hình trước khi cài.

Cài ứng dụng

1. Mở website (Website → Quản lý) và ở lại tab Tổng quan.
2. Trong thẻ Ứng dụng, bấm vào ứng dụng cần cài. Thẻ này hiện khi website chạy PHP, thư mục gốc nằm trong public_html và chưa cài ứng dụng nào.
3. Xem các nhãn: dải PHP, Chế độ Apache (.htaccess) nếu ứng dụng cần, và đường dẫn tới website của dự án.
4. Điền các trường:

5. Bấm Cài đặt. Cửa sổ tác vụ hiển thị tiến trình.

Tác vụ này sẽ:

1. Bật chế độ Apache cho OpenCart và PrestaShop (lần đầu, Apache được cài lên máy chủ, xem Chế độ Apache).
2. Tạo database và user tên <tài-khoản>_<2 chữ cái><4 ký tự ngẫu nhiên> với mật khẩu ngẫu nhiên 24 ký tự, liên kết với website.
3. Tải bản phát hành qua HTTPS (tự tải tiếp nếu mất kết nối), giải nén và chạy trình cài đặt. Mật khẩu không bao giờ xuất hiện trên dòng lệnh.
4. Xoá thư mục install/installation và đặt quyền để file chứa mật khẩu database chỉ tài khoản đọc được.
5. Kết thúc bằng dòng Admin area: https://<tên-miền>/<đường-dẫn>.

Nếu có bước nào lỗi, file cài dở và database bị xoá, website trở về như cũ, để bạn sửa nguyên nhân rồi cài lại.

Lưu ý: mật khẩu database không hiển thị trong panel mà nằm trong file cấu hình của ứng dụng (xem phần sau). Chỉ đổi mật khẩu ở Cơ sở dữ liệu nếu bạn cập nhật cả file đó.

Sau khi cài

Khi đã cài ứng dụng, phần đầu trang website có nút Trang quản trị mở địa chỉ quản trị (trừ PrestaShop, xem bên dưới). Mọi ứng dụng được cài bằng tiếng Anh; hãy đổi ngôn ngữ trong trang quản trị của từng ứng dụng.

Quan trọng: thư mục quản trị của PrestaShop được đổi thành admin kèm 8 ký tự ngẫu nhiên, theo yêu cầu của PrestaShop. Địa chỉ này chỉ xuất hiện trong nhật ký tác vụ (Tác vụ). Hãy lưu lại; nếu quên, dùng Quản lý file tìm thư mục có tên bắt đầu bằng admin trong public_html.

Laravel

Trình cài Laravel chạy composer create-project laravel/laravel bằng phiên bản PHP của website, sau đó:

• tạo .env từ .env.example với APP_NAME (tên website), APP_ENV=production, APP_DEBUG=false, APP_URL và kết nối MySQL (DB_CONNECTION=mysql, DB_HOST=localhost, database và user vừa tạo);
• chạy php artisan key:generate --force, php artisan migrate --force và php artisan storage:link;
• đặt thư mục gốc của website thành public_html/public và quy tắc rewrite Laravel.

Dự án nằm trong public_html, bên ngoài thư mục gốc web, nên không ai tải được .env hay vendor. Về scheduler, queue và deploy, xem Laravel.

Trình cài dùng được cho cả website loại PHP lẫn loại Laravel: dự án luôn nằm trong public_html, và thư mục gốc web thành public_html/public.

Cập nhật ứng dụng

ZoPanel cài ứng dụng nhưng không cập nhật chúng: hãy dùng công cụ cập nhật của từng dự án. Sao lưu website và database trước (xem Sao lưu).

Chạy các lệnh trong Terminal SSH dưới quyền tài khoản hosting, với cùng phiên bản PHP của website, ví dụ php8.3 maintenance/run.php update.

Ứng dụng PHP khác

Ứng dụng PHP không có trong danh sách có thể cài thủ công:

1. Tạo website PHP với phiên bản PHP mà ứng dụng cần.
2. Tải file lên public_html bằng Quản lý file hoặc SFTP.
3. Tạo database ở Cơ sở dữ liệu rồi chạy trình cài đặt web của ứng dụng.
4. Nếu ứng dụng chạy từ thư mục con (ví dụ public hoặc web), đặt Thư mục gốc ở tab PHP & cấu hình, ví dụ public_html/public. Thư mục này phải nằm trong public_html.
5. Nếu ứng dụng dựa vào rewrite trong .htaccess, bật Hỗ trợ .htaccess (chế độ Apache) ở tab Công cụ. Với quy tắc Mặc định, nginx đã chuyển URL không tồn tại về index.php, đủ cho hầu hết front controller.

Composer

Khi dự án có composer.json, cài thư viện qua SSH bằng đúng phiên bản PHP của website (Composer phải được cài ở Runtime):

cd ~/domains/example.com/public_html
php8.3 /usr/local/bin/composer install --no-dev --optimize-autoloader

Nếu dự án nằm trên Git, Git deploy tự chạy Composer mỗi lần phát hành và nhận diện Laravel, Symfony.

Các tuỳ chọn PHP như upload_max_filesize được đặt ở Công cụ → Thiết lập PHP cho website; dòng php_value trong .htaccess bị bỏ qua.

Xử lý sự cố

Toàn bộ output của trình cài được lưu trong Tác vụ.

Xem thêm

• Website và PHP
• Laravel
• Git deploy
• Cơ sở dữ liệu
• Sao lưu
• Quản lý file