使用 Docker 搭建 Laravel 集群指南

本指南将介绍如何使用 Docker 和 Docker Compose 搭建一个 Laravel 应用集群，包含 Web 服务器、MySQL 数据库、Redis 缓存和负载均衡。

（通过GitHub和DockerHub的集成实现自动化构建流程。包括设置GitHub组织、配置DockerHub访问权限、创建仓库及使用webhook触发构建过程。）

1. 准备工作

确保已安装：

Docker (>= 20.10)
Docker Compose (>= 2.0)
Git

2. 项目结构

laravel-cluster/
├── docker/
│   ├── nginx/
│   │   ├── Dockerfile
│   │   └── default.conf
│   ├── php/
│   │   └── Dockerfile
│   └── haproxy/
│       └── haproxy.cfg
├── src/ (Laravel 项目)
├── docker-compose.yml
└── .env

3. 配置 Docker 环境

docker-compose.yml

version: '3.8'

services:
  # MySQL 数据库
  mysql:
    image: mysql:8.0
    container_name: mysql
    environment:
      MYSQL_ROOT_PASSWORD: ${DB_ROOT_PASSWORD}
      MYSQL_DATABASE: ${DB_DATABASE}
      MYSQL_USER: ${DB_USERNAME}
      MYSQL_PASSWORD: ${DB_PASSWORD}
    volumes:
      - mysql_data:/var/lib/mysql
    networks:
      - laravel-network

  # Redis 缓存
  redis:
    image: redis:alpine
    container_name: redis
    ports:
      - "6379:6379"
    networks:
      - laravel-network

  # PHP-FPM 服务 (多个实例)
  php1:
    build:
      context: ./docker/php
    container_name: php1
    volumes:
      - ./src:/var/www/html
    environment:
      - DB_HOST=mysql
      - REDIS_HOST=redis
    networks:
      - laravel-network
    depends_on:
      - mysql
      - redis

  php2:
    build:
      context: ./docker/php
    container_name: php2
    volumes:
      - ./src:/var/www/html
    environment:
      - DB_HOST=mysql
      - REDIS_HOST=redis
    networks:
      - laravel-network
    depends_on:
      - mysql
      - redis

  # Nginx Web 服务器 (多个实例)
  nginx1:
    build:
      context: ./docker/nginx
    container_name: nginx1
    ports:
      - "8081:80"
    volumes:
      - ./src:/var/www/html
    depends_on:
      - php1
    networks:
      - laravel-network

  nginx2:
    build:
      context: ./docker/nginx
    container_name: nginx2
    ports:
      - "8082:80"
    volumes:
      - ./src:/var/www/html
    depends_on:
      - php2
    networks:
      - laravel-network

  # HAProxy 负载均衡
  haproxy:
    image: haproxy:2.4
    container_name: haproxy
    ports:
      - "80:80"
      - "8404:8404" # 统计页面
    volumes:
      - ./docker/haproxy/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg
    depends_on:
      - nginx1
      - nginx2
    networks:
      - laravel-network

volumes:
  mysql_data:

networks:
  laravel-network:
    driver: bridge

docker/php/Dockerfile

FROM php:8.1-fpm

# 安装依赖
RUN apt-get update && apt-get install -y \
    libzip-dev \
    zip \
    unzip \
    libpq-dev \
    libonig-dev \
    libxml2-dev

# 安装 PHP 扩展
RUN docker-php-ext-install pdo_mysql mbstring exif pcntl bcmath zip

# 安装 Composer
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer

# 设置工作目录
WORKDIR /var/www/html

docker/nginx/default.conf

server {
    listen 80;
    index index.php index.html;
    server_name localhost;
    error_log  /var/log/nginx/error.log;
    access_log /var/log/nginx/access.log;
    root /var/www/html/public;

    location / {
        try_files $uri $uri/ /index.php?$query_string;
    }

    location ~ \.php$ {
        try_files $uri =404;
        fastcgi_split_path_info ^(.+\.php)(/.+)$;
        fastcgi_pass php1:9000; # 修改为对应的 PHP 容器名
        fastcgi_index index.php;
        include fastcgi_params;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        fastcgi_param PATH_INFO $fastcgi_path_info;
    }
}

docker/haproxy/haproxy.cfg

global
    stats socket /var/run/api.sock user haproxy group haproxy mode 660 level admin expose-fd listeners
    log stdout format raw local0 info

defaults
    mode http
    timeout connect 5000ms
    timeout client 50000ms
    timeout server 50000ms

frontend http_front
    bind *:80
    stats uri /stats
    default_backend http_back

backend http_back
    balance roundrobin
    server nginx1 nginx1:80 check
    server nginx2 nginx2:80 check

listen stats
    bind *:8404
    stats enable
    stats uri /
    stats refresh 5s

4. 部署步骤

克隆 Laravel 项目到 src 目录：

git clone https://github.com/laravel/laravel.git src

创建 .env 文件：
```
cp src/.env.example src/.env
```

修改 src/.env 数据库配置：

DB_CONNECTION=mysql
DB_HOST=mysql
DB_PORT=3306
DB_DATABASE=laravel
DB_USERNAME=laravel
DB_PASSWORD=secret

创建项目 .env 文件：

cat > .env <<EOF
DB_ROOT_PASSWORD=root
DB_DATABASE=laravel
DB_USERNAME=laravel
DB_PASSWORD=secret
EOF

构建并启动容器：
```
docker-compose up -d --build
```

安装 Laravel 依赖：

docker-compose exec php1 composer install

生成应用密钥：

docker-compose exec php1 php artisan key:generate

运行数据库迁移：

docker-compose exec php1 php artisan migrate

5. 访问应用

应用: http://localhost
HAProxy 统计页面: http://localhost:8404/stats

6. 扩展集群

要增加更多 PHP 和 Nginx 实例：

在 docker-compose.yml 中添加 php3 和 nginx3 服务
更新 HAProxy 配置添加新服务器

重新部署：

docker-compose up -d --scale php=3 --scale nginx=3

7. 监控与管理

查看容器日志：
```
docker-compose logs -f
```
进入容器：
```
docker-compose exec php1 bash
```
停止集群：
```
docker-compose down
```

这个配置提供了基本的 Laravel 集群环境，您可以根据需要添加更多服务如队列 worker、Horizon 监控等。