如何在PHP&Nginx Docker容器中配置Composer并安装Guzzle库？

核心问题分析 #

• Docker构建阶段的Composer安装结果被卷挂载覆盖：你的docker-compose.yml里把本地的vendor/、composer.json、composer.lock直接挂载到容器的/var/www/html/目录，这会完全替换掉Dockerfile构建时生成的文件，导致之前的composer install操作直接失效。
• 卷挂载路径错误：./vendor/:/var/www/html/是把本地vendor目录覆盖容器整个html根目录，逻辑完全错误；./composer.json/:/var/www/html/也是路径错误，应该挂载文件而非目录。

修正后的配置方案 #

1. 调整PHP Dockerfile（优化构建流程）

# 请根据你的需求替换基础镜像，比如php:8.2-fpm、php:7.4-fpm等
FROM php:8.2-fpm

ENV COMPOSER_ALLOW_SUPERUSER=1
# 从官方Composer镜像复制二进制文件
COPY --from=composer:latest /usr/bin/composer /usr/bin/composer

# 设置工作目录，统一后续操作路径
WORKDIR /var/www/html

# 先复制composer配置文件，利用Docker缓存机制，避免每次改代码都重新安装依赖
COPY ./src/composer.json ./src/composer.lock ./
# 生产环境建议加--no-dev和--optimize-autoloader，开发环境可移除--no-dev
RUN composer install --no-dev --optimize-autoloader

# 最后复制项目源码
COPY ./src .

2. 修正docker-compose.yml（移除破坏性卷挂载）

services:
  nginx:
    build:
      context: .
      dockerfile: nginx/Dockerfile
    ports:
      - "8080:80"
    networks:
      - internal
    volumes:
      - ./src/:/var/www/html/
      - ./logs/nginx:/var/log/nginx/
  php:
    build:
      context: .
      dockerfile: php/Dockerfile
    networks:
      - internal
    volumes:
      - ./src/:/var/www/html/
      - ./logs/php.log:/var/log/fpm-php.www.log
      # 移除会覆盖构建结果的vendor和composer文件挂载
      # 若开发时需实时修改依赖，可参考下方开发环境配置添加挂载
networks:
  internal:
    driver: bridge

安装Guzzle的具体步骤 #

1. 在本地./src/composer.json中添加Guzzle依赖：

{
  "require": {
    "guzzlehttp/guzzle": "^7.0"
  }
}

2. 重新构建PHP容器：

docker-compose build php

3. 启动容器：

docker-compose up -d

开发环境可选配置（实时更新依赖） #

如果开发时需要频繁修改composer依赖，可以保留相关文件挂载，手动在容器内执行命令：

1. 在docker-compose.yml的php服务中添加挂载：

volumes:
  # ...保留原有挂载
  - ./src/composer.json:/var/www/html/composer.json
  - ./src/composer.lock:/var/www/html/composer.lock
  - ./vendor/:/var/www/html/vendor/

2. 进入PHP容器执行依赖安装：

docker-compose exec php composer require guzzlehttp/guzzle

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