Các bước cần làm sau khi clone dự án laravel từ github về máy

Thời gian đầu mới làm quen với Laravel, mình từng nhiều lần clone một dự án từ GitHub về máy nhưng sau đó lại loay hoay không biết làm sao để hệ thống hoạt động. Mở lên trình duyệt thì chỉ thấy toàn báo lỗi.

Nếu bạn cũng từng gặp tình trạng tương tự, thì bài viết này dành cho bạn.

Bài viết này sẽ liệt kê các bước cơ bản cần làm sau khi clone một dự án Laravel từ Github về máy. Đây cũng là một phần hỗ trợ bổ sung cho các bạn đang theo dõi series Laravel File Upload mà mình chia sẻ trên blog, phòng khi bạn tải mã nguồn về mà chưa biết cấu hình ra sao.

Trước khi bắt đầu, yêu cầu máy tính của bạn đã được cài đặt sẵn môi trường triển Laravel. Xem hướng dẫn cài đặt trên macOS hoặc Windows 11.

1. Clone project từ GitHub

Đầu tiên, clone mã nguồn dự án từ GitHub. Ví dụ mình sẽ clone branch part-1-basic-upload của Laravel File Upload

git clone --single-branch --branch part-1-basic-upload https://github.com/10h30/laravel-file-upload-series.git
cd laravel-file-upload-seriesCode language: Bash (bash)

Nếu mở trình duyệt web, truy cập vào http://laravel-file-upload-series sẽ thấy báo lỗi Warning: require(......vendor/autoload.php): Failed to open stream....

Các bước tiếp theo cần thực hiện để dự án sẵn sàng hoạt động

2. Tạo file .env từ file mẫu

Laravel sử dụng file .env để cấu hình môi trường (database, mail, app key…). Sau khi clone, chúng ta cần tạo file .env:

cp .env.example .envCode language: CSS (css)

3. Cài đặt các thư viện PHP bằng Composer

Laravel sử dụng Composer để quản lý các thư viện PHP. Cần cài đặt các thư viện PHP bằng Composer

composer installCode language: Nginx (nginx)

Trong nhiều trường hợp do các package quá cũ không còn tồn tại, chúng ta sẽ dùng lệnh này

composer updateCode language: Nginx (nginx)

4. Tạo Application key

Laravel yêu cầu phải có APP_KEY để mã hóa dữ liệu. Tạo key mớ bằng lệnh:

php artisan key:generateCode language: CSS (css)

5. Cài đặt các thư viện frontend

Nếu dự án sử dụng Laravel Mix, Vite hoặc các tool frontend khác, chúng ta cần phải chạy thêm

npm installCode language: Nginx (nginx)

6. Cấu hình database

Mở file .env và cập nhật thông tin kết nối database phù hợp với môi trường local của bạn:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=ten_database
DB_USERNAME=root
DB_PASSWORD=

Sau đó chạy migration để tạo table

php artisan migrateCode language: Nginx (nginx)

Nếu dự án có dữ liệu mẫu (seeder), hãy chạy:

php artisan db:seedCode language: CSS (css)

Hoặc kết hợp cả hai:

php artisan migrate --seedCode language: Nginx (nginx)

7. Tạo symbolic link cho storage (nếu có)

Nếu dự án có dùng chức năng upload và lưu file (như trong series Laravel File Upload), bạn cần tạo symbolic link:

php artisan storage:linkCode language: CSS (css)

8. Lời kết

Trên đây là các bước cơ bản cần thực hiện sau khi clone một project Laravel từ GitHub về máy local. Khi đã quen với quy trình này, bạn có thể viết các script tự động hoá để tiết kiệm thời gian và tránh sai sót khi thao tác thủ công. Mình sẽ chia sẻ cách tự động hoá sử dụng Bash Script trong bài viết tiếp theo.

Hy vọng bài viết này hữu ích cho bạn, đặc biệt nếu bạn đang theo dõi các bài trong series Laravel File Upload. Nếu có bất kỳ thắc mắc nào trong quá trình thiết lập, cứ để lại bình luận bên dưới, mình sẽ hỗ trợ trong khả năng có thể.