thankcard-system/docker

Laravel Docker Setup - thankcard-system

1. Cấu trúc thư mục

thankcard-system/
├─ .env
├─ artisan
├─ composer.json
├─ public/
├─ storage/
├─ bootstrap/
├─ doc/
└─ docker/
   ├─ docker-compose.yml
   ├─ Dockerfile
   ├─ README.md
   ├─ env/
   │  └─ .env.app
   ├─ nginx/
   │  └─ default.conf
   └─ php/
      └─ entrypoint.sh

---

2. Khởi chạy dự án (Docker)

Đứng tại thư mục root của dự án thankcard-system và chạy:

docker compose -f docker/docker-compose.yml up -d --build

Hoặc di chuyển vào thư mục docker/ rồi chạy:

cd docker
docker compose up -d --build

Sau khi các container chạy thành công, truy cập hệ thống tại trình duyệt:

http://localhost:8888

---

3. Cơ chế cấu hình môi trường (.env)

• File .env chính của Laravel vẫn nằm ở thư mục root để phục vụ máy local.
• Khi chạy trong container Docker, hệ thống sẽ sử dụng file docker/env/.env.app để ghi đè các cấu hình cần thiết (ví dụ: DB_HOST=host.docker.internal giúp PHP container kết nối ra cơ sở dữ liệu trên máy thật).

---

4. Các lệnh cần chạy thủ công khi cập nhật code

4.1. Khi thêm/cập nhật thư viện mới (composer.json)

Khi cập nhật hoặc cài đặt gói package PHP mới, bạn cần chạy lệnh cài đặt bên trong container:

docker compose -f docker/docker-compose.yml exec app composer install

4.2. Khi cập nhật giao diện (CSS / JS / Tailwind classes mới)

Do Docker container không cài Node.js, bạn cần chạy các lệnh compile frontend trực tiếp ở máy thật (host):

• Chạy chế độ phát triển (Hot Reload):

  npm run dev
  

• Build production tĩnh:

  npm run build
  

4.3. Khi cập nhật Database (Migrations)

Để cập nhật cơ sở dữ liệu khi có migrations mới:

docker compose -f docker/docker-compose.yml exec app php artisan migrate

4.4. Khi chạy dữ liệu mẫu (Seeders)

Để tạo dữ liệu mẫu (seed) vào cơ sở dữ liệu:

docker compose -f docker/docker-compose.yml exec app php artisan db:seed

Nếu chỉ muốn chạy một file seeder cố định (ví dụ: UserSeeder):

docker compose -f docker/docker-compose.yml exec app php artisan db:seed --class=UserSeeder

Hoặc để vừa chạy lệnh migrate vừa tự động seed luôn dữ liệu:

docker compose -f docker/docker-compose.yml exec app php artisan migrate --seed

4.5. Khi chỉnh sửa file .env hoặc .env.app

Bạn cần khởi động lại container để cập nhật biến môi trường mới và tiến hành xóa cache cấu hình:

# 1. Restart container app
docker compose -f docker/docker-compose.yml restart app

# 2. Xóa cache cấu hình trong container
docker compose -f docker/docker-compose.yml exec app php artisan config:clear

---

5. Các lệnh tiện ích khác

• Truy cập vào Bash của container app:

  docker compose -f docker/docker-compose.yml exec app bash
  

• Xem log Laravel thời gian thực:

  docker compose -f docker/docker-compose.yml exec app tail -f storage/logs/laravel.log
  

• Dọn dẹp toàn bộ cache của Laravel:

  docker compose -f docker/docker-compose.yml exec app php artisan optimize:clear
  

• Dừng các container:

  docker compose -f docker/docker-compose.yml down
  

docker compose -f docker/docker-compose.yml exec app php artisan key:generate