Docker Compose中不能定义独立composer服务，因官方无\_composer镜像；正确做法是在PHP服务的Dockerfile构建阶段通过RUN composer config -g设置镜像源，并确保多阶段构建中PHP版本、WORKDIR、COPY顺序及权限（--chown）严格一致。
docker-compose.yml里不能直接写_composer服务
官方没有 _composer 镜像，硬在 services 下写一个叫 composer 的服务，docker compose up 会直接报 pull access denied 或 service "composer" not found。这不是配置问题，是根本不存在这个镜像。
真正该做的，是在需要安装依赖的 PHP 服务构建阶段注入镜像源，而不是起一个独立的 Composer 容器来“代理”安装。
- 别在
docker-compose.yml的services里加composer:块 - 如果只是本地开发临时装依赖，用
docker run --rm调一次官方composer:2-php8.2镜像即可，不进compose编排 - 生产构建必须靠 PHP 服务自己的
Dockerfile执行composer install，此时镜像源才真正生效
镜像源必须在Dockerfile中RUN composer config -g
宿主机上运行的 composer config -g repo.packagist https://mirrors.aliyun.com/composer/ 对容器完全无效——构建时容器是干净环境，~/.composer/config.json 根本不存在。
必须在 Dockerfile 的构建阶段显式设置：
RUN composer config -g repo.packagist https://mirrors.aliyun.com/composer/
Alpine 镜像额外注意：不装证书会卡在 SSL handshake：
RUN apk add --no-cache ca-certificates- 再执行上面的
config -g，否则composer install会报SSL certificate problem - 别用
COMPOSER_REPO_PACKAGIST环境变量替代——它只对当前命令有效，后续composer require还是走默认源
多阶段构建中builder和final的PHP版本必须严格一致
常见错误是 FROM php:8.3-cli AS builder + FROM php:8.2-fpm-alpine AS final。构建能过，但运行时报 Fatal error: Uncaught ParseError——比如 composer.lock 里用了 PHP 8.3 的 readonly 语法，而 final 镜像跑的是 8.2。
正确做法是小版本、发行版全对齐：
- builder 用
php:8.2-cli-bullseye，final 就用php:8.2-fpm-bullseye - 别图省事用
composer:2作为 builder：它绑定的 PHP 版本不可控，且常缺mbstring、xml等必需扩展 - WORKDIR 也要一致（都设
WORKDIR /app），否则vendor/autoload.php路径错位，FPM 进程读不到
COPY顺序错了，缓存就彻底失效
Docker 层缓存只认文件内容哈希 + 指令顺序。只要在 COPY composer.json composer.lock ./ 和 RUN composer install 之间插了任意一行（比如 RUN mkdir -p logs），后面所有层都会失效，每次改个 README.md 都重装整个 vendor。
标准顺序只能是：
COPY composer.json composer.lock ./RUN composer install --no-dev --optimize-autoloader --classmap-authoritative --no-scripts --no-progress-
COPY . /app（必须放在这之后）
final 阶段复制 vendor 时，--chown 必须匹配运行用户：
COPY --from=builder --chown=www-data:www-data /app/vendor /app/vendor
否则 FPM 进程因权限拒绝读取 autoload.php，报 Failed opening required 'vendor/autoload.php' ——这问题和代码无关，纯是构建路径与运行权限没对齐。
