pravinbanjade/laravel

Laravel全功能Docker镜像

镜像概述

本镜像为Laravel应用提供完整的运行环境，集成了nginx、php-fpm(8.1)、Horizon、CLI工具、Composer和Cron调度器。通过多组件拆分设计，实现镜像优化，提升运行时执行效率，适合直接部署到Kubernetes环境。

核心功能与特性

• 多组件架构：拆分FPM服务器、Web服务器、Cron调度器、Horizon队列管理器和前端构建工具等独立组件
• 完整运行环境：包含PHP-FPM 8.1、Nginx、Composer、Laravel Horizon和Cron
• 开发友好：支持代码热更新，本地代码变更可实时同步到容器
• 灵活配置：通过环境变量和卷挂载实现个性化配置
• Kubernetes就绪：镜像设计考虑Kubernetes部署需求，组件间松耦合

使用场景

• Laravel应用的开发、测试和生产环境部署
• 需要完整服务组件（Web服务、队列处理、定时任务、前端构建）的Laravel项目
• 计划使用Kubernetes进行容器编排的Laravel应用

使用方法与配置说明

完整Docker Compose配置

以下配置包含所有必要组件，包括PostgreSQL数据库和Redis：

yaml
version: '3.8'
services:
    # FPM容器 - 处理PHP应用逻辑
    laravel.fpm:
        build:
            context: .
            target: fpm_server
        image: laravel-in-kubernetes/fpm_server
        environment:
            APP_DEBUG: "true"  # 可覆盖.env中的环境变量
        volumes:
            - '.:/opt/apps/laravel'  # 挂载代码目录，实现热更新
        networks:
            - laravel-in-kubernetes

    # Web服务器容器 - 处理静态资源和反向代理
    laravel.web:
        build:
            context: .
            target: web_server
        image: laravel-in-kubernetes/web_server
        ports:
            - '8080:80'  # 本地8080端口映射到容器80端口
        environment:
            FPM_HOST: "laravel.fpm:9000"  # FPM服务地址
        volumes:
            - './public:/opt/apps/laravel/public'  # 挂载静态资源目录
        networks:
            - laravel-in-kubernetes

    # Cron容器 - 运行Laravel调度器
    laravel.cron:
        build:
            context: .
            target: cron
        image: laravel-in-kubernetes/cron
        volumes:
            - '.:/opt/apps/laravel'  # 挂载代码目录
        networks:
            - laravel-in-kubernetes

    # Horizon容器 - 运行Laravel队列管理器
    laravel.horizon:
        build:
            context: .
            target: horizon
        image: laravel-in-kubernetes/horizon
        volumes:
            - '.:/opt/apps/laravel'  # 挂载代码目录
        networks:
            - laravel-in-kubernetes

    # 前端容器 - 处理前端资源构建和热更新
    laravel.frontend:
        build:
            context: .
            target: frontend
        command: ["npm", "run", "watch"]  # 监听前端文件变化并重新编译
        image: laravel-in-kubernetes/frontend
        volumes:
            - '.:/opt/apps/laravel'  # 挂载代码目录
            - '/opt/app/node_modules/'  # 独立node_modules卷，避免本地与容器架构冲突
        networks:
            - laravel-in-kubernetes

    # PostgreSQL数据库
    pgsql:
        image: 'postgres:14'
        ports:
            - '${FORWARD_DB_PORT:-5432}:5432'
        environment:
            PGPASSWORD: '${DB_PASSWORD:-secret}'
            POSTGRES_DB: '${DB_DATABASE}'
            POSTGRES_USER: '${DB_USERNAME}'
            POSTGRES_PASSWORD: '${DB_PASSWORD:-secret}'
        volumes:
            - 'laravel-in-kubernetes-pgsql:/var/lib/postgresql/data'
        networks:
            - laravel-in-kubernetes
        healthcheck:
            test: ["CMD", "pg_isready", "-q", "-d", "${DB_DATABASE}", "-U", "${DB_USERNAME}"]
            retries: 3
            timeout: 5s

    # Redis缓存
    redis:
        image: 'redis:alpine'
        ports:
            - '${FORWARD_REDIS_PORT:-6379}:6379'
        volumes:
            - 'laravel-in-kubernetes-redis:/data'
        networks:
            - laravel-in-kubernetes
        healthcheck:
            test: ["CMD", "redis-cli", "ping"]
            retries: 3
            timeout: 5s

networks:
    laravel-in-kubernetes:

volumes:
    laravel-in-kubernetes-pgsql:
    laravel-in-kubernetes-redis:

最小化Docker Compose配置（已有数据库和Redis）

当已在外部配置好数据库和Redis服务时，可使用以下精简配置：

yaml
version: '3.8'
services:
    # FPM容器 - 处理PHP应用逻辑
    laravel.fpm:
        build:
            context: .
            target: fpm_server
        image: laravel-in-kubernetes/fpm_server
        environment:
            APP_DEBUG: "true"  # 可覆盖.env中的环境变量
        volumes:
            - '.:/opt/apps/laravel'  # 挂载代码目录，实现热更新
        networks:
            - laravel-in-kubernetes

    # Web服务器容器 - 处理静态资源和反向代理
    laravel.web:
        build:
            context: .
            target: web_server
        image: laravel-in-kubernetes/web_server
        ports:
            - '8080:80'  # 本地8080端口映射到容器80端口
        environment:
            FPM_HOST: "laravel.fpm:9000"  # FPM服务地址
        volumes:
            - './public:/opt/apps/laravel/public'  # 挂载静态资源目录
        networks:
            - laravel-in-kubernetes

    # Cron容器 - 运行Laravel调度器
    laravel.cron:
        build:
            context: .
            target: cron
        image: laravel-in-kubernetes/cron
        volumes:
            - '.:/opt/apps/laravel'  # 挂载代码目录
        networks:
            - laravel-in-kubernetes

    # Horizon容器 - 运行Laravel队列管理器
    laravel.horizon:
        build:
            context: .
            target: horizon
        image: laravel-in-kubernetes/horizon
        volumes:
            - '.:/opt/apps/laravel'  # 挂载代码目录
        networks:
            - laravel-in-kubernetes

    # 前端容器 - 处理前端资源构建和热更新
    laravel.frontend:
        build:
            context: .
            target: frontend
        command: ["npm", "run", "watch"]  # 监听前端文件变化并重新编译
        image: laravel-in-kubernetes/frontend
        volumes:
            - '.:/opt/apps/laravel'  # 挂载代码目录
            - '/opt/app/node_modules/'  # 独立node_modules卷，避免本地与容器架构冲突
        networks:
            - laravel-in-kubernetes

networks:
    laravel-in-kubernetes:

关键配置说明

1. 环境变量：

   • 可通过environment字段覆盖.env文件中的配置（如APP_DEBUG）
   • FPM_HOST需设置为FPM容器地址，格式为容器名:端口

2. 卷挂载：

   • 代码目录挂载：.:/opt/apps/laravel实现本地代码热更新
   • 静态资源挂载：./public:/opt/apps/laravel/public供Nginx直接访问
   • 前端node_modules独立卷：避免本地与容器架构差异导致的依赖问题

3. 服务组件：

   • laravel.fpm：PHP-FPM服务，处理应用核心逻辑
   • laravel.web：Nginx服务，处理静态资源和反向代理
   • laravel.cron：运行Laravel调度器，处理定时任务
   • laravel.horizon：运行Laravel Horizon，管理队列任务
   • laravel.frontend：处理前端资源构建，支持热更新

启动方法

1. 将上述配置保存为docker-compose.yml
2. 在项目根目录执行命令：docker-compose up -d
3. 访问http://localhost:8080即可查看应用