150 lines
4.1 KiB
Markdown
150 lines
4.1 KiB
Markdown
# Laravel Docker Setup - thankcard-system
|
|
|
|
## 1. Cấu trúc thư mục
|
|
|
|
```txt
|
|
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:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```txt
|
|
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**:
|
|
|
|
```bash
|
|
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):**
|
|
```bash
|
|
npm run dev
|
|
```
|
|
- **Build production tĩnh:**
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
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`):
|
|
```bash
|
|
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:
|
|
```bash
|
|
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:
|
|
|
|
```bash
|
|
# 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
|
|
```
|
|
|
|
### 4.6. Mở công cụ quản lý Database (phpMyAdmin)
|
|
|
|
Dự án có sẵn một file cấu hình riêng để mở giao diện quản lý MySQL (đã được trỏ sẵn vào database trên máy bạn):
|
|
|
|
```bash
|
|
docker compose -f docker/docker-compose.phpmyadmin.yml up -d
|
|
```
|
|
Sau đó truy cập: `http://localhost:8889` để vào phpMyAdmin.
|
|
|
|
---
|
|
|
|
## 5. Các lệnh tiện ích khác
|
|
|
|
- **Truy cập vào Bash của container app:**
|
|
```bash
|
|
docker compose -f docker/docker-compose.yml exec app bash
|
|
```
|
|
- **Xem log Laravel thời gian thực:**
|
|
```bash
|
|
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:**
|
|
```bash
|
|
docker compose -f docker/docker-compose.yml exec app php artisan optimize:clear
|
|
```
|
|
- **Dừng các container:**
|
|
```bash
|
|
docker compose -f docker/docker-compose.yml down
|
|
```
|
|
|
|
docker compose -f docker/docker-compose.yml exec app php artisan key:generate
|