bisnow/laravel

Laravel一体化部署容器

镜像概述

本Docker镜像为Laravel应用提供一体化部署解决方案，在单个容器内集成运行web服务、worker进程（队列任务处理）和scheduler定时任务功能，旨在简化传统部署中多容器或多进程管理的复杂性，降低应用架构复杂度。

核心功能与特性

• 一体化部署：单个容器内同时运行Laravel应用所需的web服务（如Nginx/PHP-FPM）、worker队列进程和scheduler定时任务，减少容器编排依赖
• 进程管理：内置进程管理机制，自动监控并重启异常退出的web、worker或scheduler进程，保障服务稳定性
• 灵活配置：支持通过环境变量自定义Laravel应用配置（如数据库连接、缓存驱动等）及进程参数（如worker数量、调度频率）
• 标准兼容：适配标准Laravel项目结构，支持composer依赖管理及.env配置文件加载

使用场景与适用范围

• 中小型Laravel应用的简化部署（避免多容器协调管理）
• 开发/测试环境快速搭建（一键启动完整应用服务）
• 对部署架构复杂度敏感的生产环境（减少容器资源开销及运维成本）
• 需要统一管理web服务、队列任务和定时任务的场景

使用方法与配置说明

1. 前提条件

• 已安装Docker Engine（20.10+版本）
• Laravel项目代码（建议通过卷挂载方式挂载至容器，或构建自定义镜像时内置代码）

2. 镜像拉取

bash
docker pull [镜像仓库地址]/laravel-single-container:latest

注：请替换[镜像仓库地址]为实际镜像存放地址

3. 基本使用示例

3.1 快速启动（开发环境）

bash
docker run -d \
  --name laravel-app \
  -p 80:80 \
  -v /path/to/laravel-project:/app \
  -e APP_ENV=local \
  -e APP_KEY=base64:your_app_key_here \
  -e DB_CONNECTION=mysql \
  -e DB_HOST=mysql \
  -e DB_PORT=3306 \
  -e DB_DATABASE=laravel \
  -e DB_USERNAME=root \
  -e DB_PASSWORD=secret \
  laravel-single-container:latest

3.2 docker-compose配置（生产环境建议）

yaml
version: '3.8'
services:
  laravel:
    image: laravel-single-container:latest
    container_name: laravel-app
    restart: always
    ports:
      - "8080:80"
    volumes:
      - ./laravel-project:/app
      - ./storage:/app/storage  # 持久化存储目录
      - ./bootstrap/cache:/app/bootstrap/cache  # 持久化缓存目录
    environment:
      - APP_ENV=production
      - APP_KEY=base64:your_production_app_key
      - APP_URL=http://your-domain.com
      - DB_CONNECTION=mysql
      - DB_HOST=mysql-service  # 外部数据库服务名/IP
      - DB_PORT=3306
      - DB_DATABASE=laravel_prod
      - DB_USERNAME=laravel_user
      - DB_PASSWORD=strong_password
      - QUEUE_CONNECTION=redis  # 队列驱动（支持sync/redis/database等）
      - WORKER_PROCESSES=4  # worker进程数量（默认1）
      - SCHEDULER_INTERVAL=* * * * *  # 定时任务调度频率（默认每分钟）
    depends_on:
      - mysql-service  # 如需依赖外部服务（如数据库），需在此声明

4. 核心配置参数说明

5. 高级配置

5.1 自定义启动脚本

如需修改进程启动逻辑（如添加前置命令、调整进程启动顺序），可通过卷挂载自定义启动脚本：

bash
docker run -v /path/to/custom-entrypoint.sh:/app/entrypoint.sh \
  --entrypoint /app/entrypoint.sh \
  laravel-single-container:latest

5.2 健康检查配置

在docker-compose中添加健康检查确保服务可用：

yaml
services:
  laravel:
    # ... 其他配置 ...
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost/health"]  # 需确保应用提供健康检查接口
      interval: 30s
      timeout: 10s
      retries: 3

注意事项

• 生产环境建议配合反向代理（如Nginx/Traefik）使用，以提供SSL终止、负载均衡及静态资源缓存能力
• 高并发场景下，建议根据服务器CPU核心数调整WORKER_PROCESSES参数（通常设置为CPU核心数的1-2倍）
• 容器资源限制：建议根据应用负载设置合理的CPU/内存限制（通过--cpus/--memory参数），避免资源竞争
• 数据持久化：务必通过卷挂载方式持久化Laravel的storage和bootstrap/cache目录，防止容器重启后数据丢失