核心是在构建阶段用多阶段dockerfile执行composer install，确保php扩展、ca证书、镜像源和权限配置正确，避免运行时安装导致失败。
在 Docker 里用 Composer，核心不是“能不能装上”，而是“在哪装、用谁的环境、权限和路径对不对”——构建时装依赖才是正路，运行时执行 composer install 或 composer require 只适合调试，且极易因 UID/GID 不匹配、PHP 扩展缺失或 SSL 证书问题直接失败。
构建阶段 RUN composer install 总卡住或报错 SSL certificate problem
Alpine 镜像默认没装 CA 证书，php 命令本身也常缺 openssl、zip、mbstring 这些 Composer 必需扩展。不补全就跑 composer install，会静默失败或卡在 HTTPS 源上。
- 先确认基础镜像支持：运行
docker run --rm php:8.2-cli php -m | grep -E "openssl|zip|mbstring"，缺哪个装哪个 - Alpine 用户必须加：
RUN apk add --no-cache ca-certificates php82-openssl php82-zip php82-mbstring - 国内网络下，务必提前设镜像源：
RUN COMPOSER_REPO_PACKAGIST=https://mirrors.aliyun.com/composer/ composer install - 别跳过校验：用官方安装脚本时，一定要验证 SHA384，否则 CI 环境可能拉到损坏包
Docker Compose 中误配 _composer 服务导致启动失败
不存在 _composer 官方镜像，Docker Hub 上也没有叫这个名字的标准服务。硬写进 docker-compose.yml 的 services 下，必然报 pull access denied 或 service "composer" not found。
- 开发时临时执行依赖安装，用
docker run --rm -v $(pwd):/app -w /app --user $(id -u):$(id -g) composer:2-php8.2 install - 生产构建必须走 Dockerfile：
COPY composer.json composer.lock ./→RUN composer install --no-dev --no-scripts --optimize-autoloader - 如果想在 PHP 容器里交互式用 Composer，把
composer.phar挂进去：volumes: [./composer.phar:/usr/local/bin/composer]，但前提是本地已下载并校验过
挂载 vendor 目录后 Class not found 或 Permission denied
宿主机（尤其是 macOS/Windows）挂载的文件默认属主是 root:root（uid=0），而 PHP 容器常用用户是 www-data（uid=33）或 1001。生成的 vendor/ 文件容器内不可读、不可 autoload，错误往往出现在运行时而非安装时。
- 别把
vendor/做成 volume：它会覆盖镜像里预构建的优化层，CI 缓存失效，还引发权限冲突 - 挂载项目目录时，强制指定用户：
docker run --rm -u $(id -u):$(id -g) -v $(pwd):/app php:8.2-cli composer install - 若已生成 root 属主的
vendor/，进容器后立刻修正：chown -R 1001:1001 vendor/（按实际 UID 调整） - 多阶段构建中，
COPY --from=builder /app/vendor /var/www/html/vendor后，检查目标路径是否被后续COPY .覆盖
Dockerfile 中 COPY 顺序错导致每次构建都重装 vendor
把 COPY . /app 放在 RUN composer install 之前，会导致只要改一行代码，Docker 就无法复用缓存，整个 vendor/ 重装一遍，构建时间暴增。
- 严格按顺序：
COPY composer.json composer.lock ./→RUN composer install --no-dev --prefer-dist --optimize-autoloader→COPY . /app - 加
--no-interaction，否则构建卡在交互提示上 - 避免用
apt-get install composer：Debian/Ubuntu 源里的版本太旧，不兼容composer.lockv2 格式 - PHP 基础镜像如
php:8.2-cli-slim默认不带curl和unzip，得手动apt-get install -y curl unzip
最麻烦的不是命令跑不通，而是 vendor 权限和 autoload 路径在构建和运行时错位——这两个点一旦忽略，后面花再长时间调 autoload 加载逻辑都是白搭。
