如何用Docker Compose为PHP应用搭建后台任务独立容器

你完全可以复用现有PHP服务的配置来创建独立的队列容器，无需重复定义整个PHP服务。下面是两种简洁的实现方式，都遵循Docker单容器单进程的最佳实践：

方法一：使用YAML锚点复用配置（推荐） #

利用YAML的锚点（&）和别名（*）特性，直接继承现有PHP服务的所有配置，仅覆盖启动命令即可：

version: '3'

services:
    web:
        image: nginx:latest
        ports:
            - "${SERVICE_PORT}:80"
        volumes:
            - ./storage/logs/nginx/:/var/log/nginx/
            - ./.docker/conf/nginx/nginx.conf:/etc/nginx/conf.d/default.conf
    php: &php-base # 定义锚点，作为PHP服务的基准配置
        build:
            context: .
            dockerfile: ./.docker/Dockerfile
        volumes:
            - ./.env:/usr/src/app/.env
            - vendor:/usr/src/app/vendor
            - storage:/usr/src/app/storage
    queue:
        <<: *php-base # 继承php服务的所有配置
        command: php artisan queue:work --tries=3 --timeout=60 # 覆盖启动命令，运行队列脚本
        restart: always # 异常退出时自动重启，保证队列持续运行
volumes:
    vendor:
    storage:

配置说明： #

• &php-base 给PHP服务标记一个锚点，后续的queue服务用<<: *php-base直接导入所有配置项，避免重复编写build、volumes等内容。
• command 字段替换了PHP容器默认的php-fpm启动命令，改为运行Laravel队列处理脚本。
• restart: always 确保队列容器因异常退出时自动重启，不用手动干预。
• 共享的vendor和storage卷保证队列容器与PHP服务使用相同的依赖和存储数据，环境完全一致。

方法二：复用已构建的PHP镜像 #

如果你先给构建好的PHP镜像打标签，也可以直接在队列容器中引用该镜像，省去重复build的步骤：

version: '3'

services:
    web:
        image: nginx:latest
        ports:
            - "${SERVICE_PORT}:80"
        volumes:
            - ./storage/logs/nginx/:/var/log/nginx/
            - ./.docker/conf/nginx/nginx.conf:/etc/nginx/conf.d/default.conf
    php:
        build:
            context: .
            dockerfile: ./.docker/Dockerfile
        image: my-app-php # 给构建的镜像打标签
        volumes:
            - ./.env:/usr/src/app/.env
            - vendor:/usr/src/app/vendor
            - storage:/usr/src/app/storage
    queue:
        image: my-app-php # 直接复用已构建的PHP镜像
        volumes:
            - ./.env:/usr/src/app/.env
            - vendor:/usr/src/app/vendor
            - storage:/usr/src/app/storage
        command: php artisan queue:work --tries=3 --timeout=60
        restart: always
volumes:
    vendor:
    storage:

这种方式的优势： #

• 如果你需要单独更新PHP镜像，只需重新buildphp服务，queue容器会自动使用最新镜像。
• 适合需要在多个环境复用同一PHP镜像的场景。

核心优势总结 #

不管用哪种方式，都能实现：

1. 每个容器职责单一：Nginx处理HTTP请求、PHP-FPM处理业务逻辑、队列容器单独处理异步任务，符合Docker最佳实践。
2. 无需安装supervisor：Docker本身就能管理容器的启停和重启，减少容器内部复杂度。
3. 配置无冗余：通过复用配置或镜像，避免重复编写相同的build、volume等内容。

内容的提问来源于stack exchange，提问作者Amega