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ỉ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

3.2 KiB Raw Blame History