Docker+PHP Composer问题：包安装在根目录而非vendor目录

核心原因分析 #

从你的配置来看，问题大概率出在Docker卷挂载时机和Composer安装路径一致性上：

• 若在Dockerfile中执行composer install后，通过docker-compose将本地项目目录挂载到容器内项目根目录，会直接覆盖容器内已生成的vendor目录，导致容器内vendor为空，而本地之前误生成的Composer文件（如autoload.php）会留在根目录。
• 另一种可能是Composer命令执行时的工作目录错误，导致包被安装到了非预期路径。

分步解决方案 #

1. 调整Dockerfile，确保Composer安装路径正确且不被挂载覆盖 #

修改Dockerfile，将Composer安装步骤放在挂载卷之前，明确指定工作目录：

FROM php:8.1-apache

# 设置容器内项目工作目录
WORKDIR /var/www/html

# 引入官方Composer镜像
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer

# 先复制Composer配置文件，利用Docker缓存优化构建
COPY composer.json composer.lock ./

# 执行依赖安装，指定vendor目录（与composer.json配置保持一致）
RUN composer install --no-interaction --optimize-autoloader

# 复制剩余项目文件
COPY . .

# 可添加WordPress相关配置（如启用mod_rewrite等）
# RUN a2enmod rewrite

2. 修正docker-compose.yaml的挂载规则 #

通过排除vendor目录挂载，避免本地目录覆盖容器内已生成的依赖文件：

version: '3.8'
services:
  web:
    build: .
    ports:
      - "8080:80"
    volumes:
      # 挂载本地项目文件，但排除vendor目录
      - .:/var/www/html
      - /var/www/html/vendor

这里的/var/www/html/vendor是匿名卷，会保留容器内Composer生成的依赖目录，不受本地挂载影响。

3. 确认composer.json的vendor-dir配置 #

确保composer.json中的配置无错误，相对路径以容器内工作目录为基准：

{
  "config": {
    "vendor-dir": "vendor"
  },
  // 其他项目配置
}

4. 清理残留文件并重新构建 #

• 删除本地根目录下的autoload.php、composer.lock等误生成的文件
• 执行清理命令：docker-compose down -v（清除旧容器与卷）
• 重新构建启动：docker-compose up --build

验证方式 #

容器启动后，进入容器检查目录结构：

docker exec -it [容器名称/ID] ls -la /var/www/html

确认vendor目录存在且包含依赖文件，根目录无多余的Composer生成文件。

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