Docker构建PHP容器时composer install报错，手动执行却正常

问题根源 #

构建镜像时执行RUN composer install报错找不到composer.json，核心原因是：

• Docker镜像构建阶段（docker compose build）早于容器启动阶段，docker-compose.yml中配置的volumes: - ./src:/var/www/html是在容器启动后才会把本地./src目录挂载到容器内，构建阶段容器的/var/www/html目录是空的，自然找不到composer.json。
• 容器启动后挂载生效，本地./src里的文件被映射到容器内，所以手动执行composer install能成功。

解决方案 #

方案一：将依赖打包进镜像（适合生产环境） #

修改Dockerfile，在执行composer install前，先把本地的composer.json和composer.lock复制到镜像中：

FROM php:7.4-apache
COPY --from=composer /usr/bin/composer /usr/bin/composer

RUN docker-php-ext-install pdo_mysql mysqli
RUN a2enmod rewrite

WORKDIR /var/www/html

# 复制composer配置文件到镜像内（注意路径：Dockerfile在./docker/php，所以相对路径要回退到项目根目录）
COPY ../../src/composer.json ../../src/composer.lock ./

RUN apt-get update && apt-get install -y git
# 创建普通用户执行composer，避免root权限警告
RUN useradd -m appuser && chown -R appuser:appuser /var/www/html
USER appuser
# 生产环境建议添加--no-dev和--optimize-autoloader参数
RUN composer install --no-dev --optimize-autoloader

注意：如果你的Dockerfile位置不同，需要调整COPY命令的源路径，确保能正确读取到项目根目录下./src里的composer文件。

方案二：容器启动时自动执行composer（适合开发环境） #

保留本地目录挂载，去掉Dockerfile中的RUN composer install，改为在容器启动时自动执行：

1. 修改Dockerfile，移除最后一行RUN composer install
2. 更新docker-compose.yml的php服务配置，添加启动命令：

version: "3.9"
services:
  php:
    build: ./docker/php
    volumes:
      - ./src:/var/www/html
    ports:
      - 8080:80
    restart: unless-stopped
    # 启动时先执行composer install，再启动apache
    command: >
      sh -c "composer install && apache2-foreground"

这种方式每次容器启动都会检查并安装依赖，适合开发时频繁修改composer配置的场景。

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