Hướng dẫn cài đặt Laravel trên hosting cPanel thông qua Softaculous

Laravel là một PHP Framework phổ biến hiện nay, tuy nhiên việc cài đặt thủ công thường đòi hỏi kiến thức về Composer và SSH. Với công cụ Softaculous có sẵn trên cPanel, bạn có thể triển khai Laravel chỉ với vài cú nhấp chuột. Cùng tìm hiểu ngay sau đây.

Tại sao nên dùng Softaculous để cài Laravel?

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.

• 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, 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ề 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.

Trong bài viết này, Vietnix 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.

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ó 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.

Cài đặt Laravel bằng Softaculous trên hosting cPanel là giải pháp nhanh gọn và hiệu quả, đặc biệt phù hợp với người mới hoặc khi cần triển khai môi trường test nhanh chóng. Phương pháp này giúp bạn tiết kiệm đáng kể thời gian cấu hình, hạn chế lỗi kỹ thuật và vẫn đảm bảo tính ổn định, bảo mật cho website. Khi đã quen với Laravel, bạn hoàn toàn có thể mở rộng, tối ưu hoặc chuyển sang triển khai nâng cao hơn theo nhu cầu thực tế. Chúc bạn thành công.

VIETNIX – DỊCH VỤ HOSTING, VPS TỐC ĐỘ CAO, ỔN ĐỊNH, BẢO MẬT

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