Hướng dẫn cài đặt Laravel trên cPanel bằng Softaculous và bằng cách upload source

Laravel là một framework PHP phổ biến nhất hiện nay, được sử dụng rộng rãi để xây dựng các website và ứng dụng web hiện đại. Khi triển khai Laravel trên hosting cPanel, bạn có thể lựa chọn nhiều cách cài đặt khác nhau tùy theo nhu cầu và mức độ kinh nghiệm. Trong bài viết này, mình sẽ hướng dẫn 2 cách cài đặt Laravel trên cPanel: sử dụng Softaculous để cài nhanh chỉ với vài thao tác và upload source code thủ công để chủ động hơn trong cấu hình và quản lý dự án.

Những điểm chính

• Hướng dẫn cài đặt Laravel trên cPanel bằng Softaculous: Nắm vững cách cài đặt Laravel trên cPanel chỉ trong vài cú nhấp chuột bằng Softaculous, giúp bạn tiết kiệm thời gian và không cần biết dòng lệnh.
• Hướng dẫn cài đặt Laravel trên cPanel bằng cách upload source code: Hiểu rõ quy trình triển khai một dự án Laravel có sẵn lên hosting cPanel một cách đầy đủ, giúp bạn kiểm soát hoàn toàn quá trình cài đặt và tùy biến.
• Giới thiệu Vietnix: Khám phá giải pháp hosting được tối ưu sẵn cho Laravel từ Vietnix, giúp bạn yên tâm phát triển dự án mà không cần lo lắng về vấn đề hạ tầng.
• Câu hỏi thường gặp: Nhận được câu trả lời ngắn gọn cho các thắc mắc về việc cài đặt Laravel trên cPanel.

Softaculous là trình cài đặt tự động (Auto-Installer) phổ biến nhất hiện nay, được tích hợp trực tiếp trong cPanel, cho phép cài đặt hơn 450 mã nguồn mở chỉ trong vài giây. Việc cài đặt Laravel trên cPanel bằng Softaculous mang lại những lợi ích như:

• Tiết kiệm thời gian: Hoàn tất cài đặt chỉ từ 10 – 60 giây, thay vì phải gõ lệnh qua terminal (SSH) và chờ đợi Composer tải thư viện thủ công.
• Không cần kiến thức dòng lệnh: Không cần kiến thức về SSH hay dòng lệnh phức tạp, cực kỳ phù hợp cho người mới bắt đầu hoặc cần test nhanh dự án.

Điều kiện cần chuẩn bị trước khi cài đặt

Trước khi cài đặt Laravel trên cPanel bằng Softaculous, hãy đảm bảo bạn đáp ứng các yêu cầu sau:

• Có tài khoản hosting sử dụng cPanel.
• Hosting hỗ trợ Softaculous Apps Installer.
• Domain hoặc subdomain đã được tạo và trỏ DNS về địa chỉ IP hosting thành công.
• PHP phiên bản 8.1 trở lên (tùy phiên bản Laravel).
• Bật các PHP extension cần thiết:openssl, pdo, pdo_mysql, mysqli, mbstring, tokenizer, xml, ctype, json, bcmath, fileinfo.

Xử lý lưu lượng truy cập đột biến cho doanh nghiệp

Phần cứng chuyên dụng, công nghệ tăng tốc Vietnix Speed Optimize độc quyền, tải trang nhanh và bảo mật

Tăng tốc website

Trong bài viết này, mình sẽ hướng dẫn bạn cài Laravel cho subdomain: laravel.vietnix.xyz bằng Softaculous, kèm các bước cấu hình quan trọng để chạy ổn định.

Các bước cài đặt chi tiết

Bước 1: Truy cập Softaculous Apps Installer

• Đăng nhập vào cPanel.
• Trong mục Software, chọn Softaculous Apps Installer.
• Tìm kiếm Laravel hoặc chọn trực tiếp trong danh sách Framework.

Bước 2: Thực hiện cài đặt Laravel

Bạn nhấn Install và điền các thông số liên quan tới cài đặt:

• Choose Protocol: Ưu tiện chọn https:// (nếu đã có chứng chỉ SSL).
• Choose Domain: Chọn domain hoặc subdomain cần cài Laravel (ví dụ: laravel.vietnix.xyz).
• In Directory: Để trống để website chạy trực tiếp trên domain. Nếu bạn nhập “laravel”, trang web sẽ chạy ở đường dẫn laravel.vietnix.xyz/laravel.
• Version: Chọn phiên bản Laravel mới nhất để đảm bảo bảo mật.
• Advanced Options: Cho phép điều chỉnh 1 số thông số khác khi tạo website như tên database, database user, password,… Phần này thường không cần phải điều chỉnh, bạn bỏ qua hệ thống cũng sẽ tạo mặc định cho bạn.
• Email installation details to: Điền địa chỉ email nhận thông tin sau khi cài đặt hoàn tất.

Sau khi thiết lập xong, bạn nhấn Install và chờ từ 10–60 giây để hệ thống hoàn tất quá trình khởi tạo.

Bước 3: Điều chỉnh file .htaccess

Khi website Laravel được khởi tạo xong, mọi truy cập vào https://laravel.vietnix.xyz sẽ tự động chuyển hướng về https://laravel.vietnix.xyz/public.

Nguyên nhân là do Softaculous tự động tạo một file htaccess ở thư mục gốc với nội dung chuyển hướng sau:

<IfModule mod_alias.c>
RedirectMatch 301 ^/$ https://laravel.vietnix.xyz/public
</IfModule>

Để truy cập trực tiếp từ https://laravel.vietnix.xyz mà không bị chuyển hướng, bạn cần chỉnh sửa file .htaccess bằng cách xóa hoặc dùng dấu # để vô hiệu hóa các dòng code trên, sau đó bổ sung nội dung sau vào file:

<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule ^(.*)$ public/$1 [L]
</IfModule>

Sau khi lưu lại, bạn hãy xóa cache trình duyệt hoặc dùng tab ẩn danh để kiểm tra. Lúc này, https://laravel.vietnix.xyz sẽ hoạt động chính xác mà không bị chuyển hướng sang thư mục /public nữa.

Trong trường hợp bạn đã có sẵn mã nguồn Laravel trên máy tính, việc upload trực tiếp source lên hosting và cấu hình chạy trên cPanel là giải pháp nhanh chóng, dễ triển khai mà không cần thiết lập phức tạp.

Các bước cài đặt chi tiết

Bước 1: Upload mã nguồn Laravel vào public_html

1.1. Đăng nhập vào cPanel

Đầu tiên, bạn cần đăng nhập vào giao diện cPanel bằng thông tin đã được cung cấp sau khi đăng ký dịch vụ.

1.2. Truy cập File Manager

Trong giao diện cPanel, bạn tìm đến mục Files và chọn File Manager để quản lý dữ liệu trên hosting.

1.3. Truy cập thư mục public_html

Trong giao diện File Manager, bạn tìm và nhấp đúp vào thư mục public_html. Đây là thư mục gốc mặc định mà máy chủ web sẽ đọc để hiển thị website của bạn. Toàn bộ mã nguồn sẽ được đặt tại đây.

1.4. Upload file source Laravel

Trên thanh công cụ của File Manager, bạn nhấp vào nút Upload, nhấn tiếp Select File và chọn file nén (.zip) chứa toàn bộ mã nguồn dự án Laravel của bạn từ máy tính. Sau đó, bạn chỉ cần chờ đợi cho đến khi quá trình tải lên hoàn tất 100%.

1.5. Giải nén mã nguồn Laravel

Quay lại File Manager, nhấp chuột phải vào file .zip vừa upload và chọn Extract để giải nén trực tiếp trong thư mục public_html.

1.6. Kiểm tra cấu trúc source Laravel

Sau khi giải nén, thư mục public_html cần có đầy đủ các thành phần của Laravel như:

• app/, bootstrap/, config/
• database/, storage/, vendor/
• public/
• File .env

1.7. Xóa file zip không còn sử dụng

Sau khi kiểm tra source đầy đủ, bạn nên xóa file .zip để tránh chiếm dung lượng hosting không cần thiết. Bạn chỉ cần nhấp chuột phải vào file .zip và chọn Delete.

Bước 2: Cấu hình .htaccess để trỏ website vào thư mục public

Thay vì di chuyển mã nguồn trong thư mục public, bạn có thể sử dụng file .htaccess để chuyển toàn bộ truy cập website về đúng thư mục public của Laravel.

2.1. Tạo hoặc chỉnh sửa file .htaccess

Trong thư mục public_html, bạn tìm file có tên là .htaccess. Nếu chưa có, hãy tạo một file mới bằng cách nhấp vào + File và đặt tên là .htaccess.

2.2. Thêm cấu hình rewrite cho Laravel

Bạn mở file .htaccess bằng cách nhấp chuột phải và chọn Edit. Sau đó, bạn thêm đoạn code sau vào file và lưu lại. Đoạn code này sẽ chuyển hướng mọi truy cập đến thư mục public của Laravel.

<IfModule mod_rewrite.c>
    RewriteEngine On
    RewriteCond %{REQUEST_URI} !^public
    RewriteRule ^(.*)$ public/$1 [L]
</IfModule>

Bước 3: Tạo database MySQL

Mọi ứng dụng Laravel đều cần một cơ sở dữ liệu để hoạt động.

• Trong giao diện cPanel, bạn tìm mục Databases và chọn Database Wizard.
• Nhập tên cơ sở dữ liệu mới và nhấn Next Step.
• Tạo một user mới bằng cách nhập tên người dùng và mật khẩu. Sau đó nhấn Create User.
• Gán quyền cho người dùng. Tích vào ô ALL PRIVILEGES để cấp toàn bộ quyền cho user trên database vừa tạo, sau đó nhấn Make Changes.

Bước 4: Cấu hình file .env

Bây giờ, bạn cần kết nối ứng dụng Laravel với cơ sở dữ liệu vừa tạo.

• Bạn quay lại File Manager, tìm và mở file .env trong thư mục public_html.
• Cập nhật chính xác các thông tin database vừa tạo ở Bước 3.

DB_CONNECTION=mysql
DB_HOST=localhost
DB_DATABASE=ten_database
DB_USERNAME=ten_user
DB_PASSWORD=mat_khau

Bước 5: Import database cho Laravel

Tùy thuộc vào dự án của bạn, hãy chọn một trong hai cách sau để thiết lập cấu trúc bảng cho cơ sở dữ liệu.

Cách 1: Import database từ file .sql

Cách này phù hợp khi bạn đã có sẵn một file backup dữ liệu.

• Trong cPanel, bạn truy cập phpMyAdmin.
• Chọn đúng database đã tạo ở cột bên trái, sau đó chuyển sang tab Import.
• Nhấn Choose File, chọn file .sql từ máy tính của bạn để bắt đầu quá trình import.

Cách 2: Import database bằng Artisan migrate

Cách này phù hợp cho các dự án mới, sử dụng các file migration của Laravel để tạo bảng.

• Trong cPanel, tìm và mở công cụ Terminal trong mục Advanced.
• Di chuyển vào thư mục source Laravel và chạy lệnh:

cd ~/public_html
php artisan migrate

Bước 6: Kiểm tra website

Bạn hãy truy cập tên miền đã trỏ về Hosting. Nếu website hiển thị bình thường, quá trình cài đặt Laravel đã thành công.

Các lỗi thường gặp và cách xử lý

Trong quá trình cài đặt Laravel trên cPanel bằng cách upload source code thủ công, người dùng thường gặp một số lỗi liên quan đến cấu hình môi trường, phân quyền thư mục hoặc kết nối cơ sở dữ liệu. Dưới đây là những lỗi phổ biến nhất và cách xử lý tương ứng, giúp bạn nhanh chóng khắc phục và đưa website Laravel vào hoạt động ổn định.

Lỗi trắng trang hoặc Lỗi HTTP 500 (Internal Server Error)

Nguyên nhân:

• Thường do sai quyền (permission) của thư mục.
• Phiên bản PHP không tương thích.

Cách xử lý:

• Đảm bảo các thư mục storage/ và bootstrap/cache/ có quyền ghi (permission 775).
• Kiểm tra và đảm bảo phiên bản PHP trên hosting phù hợp với yêu cầu của phiên bản Laravel bạn đang sử dụng.

Lỗi “No application encryption key has been specified”

Nguyên nhân:

• Chưa có APP_KEY trong file .env.

Cách xử lý:

• Kiểm tra file .env và đảm bảo có dòng APP_KEY.
• Nếu trống, bạn hãy vào Terminal trong cPanel và chạy lệnh tạo APP_KEY sau:

cd public_html
php artisan key:generate

Lỗi kết nối database

Nguyên nhân:

• Sai thông tin database.
• Chưa import dữ liệu.

Cách xử lý:

• Kiểm tra lại thông tin trong .env.
• Đảm bảo đã import database bằng file .sql hoặc Artisan migrate.

Lỗi khi chạy php artisan migrate

Nguyên nhân:

• Cấu hình database chưa đúng.
• Source thiếu migration hoặc vendor.

Cách xử lý:

• Kiểm tra lại file .env
• Đảm bảo source Laravel đã được build đầy đủ trước khi upload.

Giải pháp hosting cPanel tối ưu cho Laravel từ Vietnix

Để quá trình cài đặt và vận hành Laravel trên cPanel luôn ổn định, việc lựa chọn hạ tầng hosting phù hợp đóng vai trò rất quan trọng. Vietnix cung cấp dịch vụ hosting tích hợp sẵn cPanel, được tối ưu hiệu năng cho website và ứng dụng web, đặc biệt phù hợp với các dự án Laravel từ nhỏ đến quy mô doanh nghiệp.

Hệ thống hosting tại Vietnix sử dụng phần cứng tốc độ cao, đảm bảo truy cập nhanh, hoạt động ổn định và bảo mật tốt, giúp website Laravel vận hành mượt mà ngay cả khi có lượng truy cập lớn. Bên cạnh đó, đội ngũ kỹ thuật hỗ trợ 24/7 sẵn sàng đồng hành, hỗ trợ xử lý sự cố, cấu hình môi trường PHP hoặc tư vấn triển khai phù hợp cho doanh nghiệp, giúp bạn yên tâm tập trung phát triển sản phẩm thay vì lo lắng về hạ tầng.

Thông tin liên hệ:

• Website: https://vietnix.vn/
• Hotline: 1800 1093
• Email: sales@vietnix.com.vn
• Địa chỉ: 265 Hồng Lạc, Phường Bảy Hiền, Thành Phố Hồ Chí Minh

Trên đây là hướng dẫn chi tiết 2 cách cài đặt Laravel trên cPanel bằng Softaculous và bằng phương pháp upload source code thủ công. Tùy theo nhu cầu sử dụng và mức độ am hiểu kỹ thuật, bạn có thể lựa chọn cách triển khai phù hợp: Softaculous giúp cài đặt nhanh, đơn giản, trong khi upload source cho phép tùy biến và kiểm soát cấu hình sâu hơn. Dù áp dụng phương pháp nào, việc đảm bảo đúng phiên bản PHP, cấu hình môi trường và phân quyền thư mục là yếu tố then chốt để Laravel hoạt động ổn định và hiệu quả.