宿主机 composer config -g 对 Docker 构建无效，因构建在隔离容器中执行，不读取本地 ~/.composer/config.json；必须在 Dockerfile 中显式配置镜像源，如 RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，并验证输出为完整 JSON。
直接在 Dockerfile 的构建阶段显式配置镜像源，而不是改宿主机 composer config —— 后者对构建完全无效。
为什么宿主机 composer config -g 对 Docker 构建没用
容器构建在隔离的临时环境中执行，不读取你本地 ~/.composer/config.json。你在终端里执行的任何全局配置，只影响宿主机 CLI，对 RUN composer install 零作用。
典型现象：构建卡在 Loading composer repositories 或反复请求 https://packagist.org/packages.json，耗时数分钟——这不是网络慢，是根本没走镜像源。
-
repo.packagist拼写必须准确，不能写成repo.packagist.org或漏掉composer类型标识 - 镜像 URL 末尾必须带
/，例如https://mirrors.aliyun.com/composer/，少斜杠会报 404 - 验证是否生效：加一行
RUN composer config -g repo.packagist，输出应为完整 JSON 对象（不是 null 或空）
RUN composer config -g repo.packagist 是最稳写法
它在构建容器内全局生效，覆盖所有后续 composer install 行为，且兼容 CI/CD 和多阶段构建。
立即学习“PHP免费学习笔记（深入）”；
推荐组合写法：
RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ \
&& composer config -g http-max-concurrent-downloads 6
- 并发数设太高（如 15）容易触发
file_put_contents(/tmp/): failed to open stream错误——不是磁盘满，而是容器 tmpfs 的 inode 耗尽 - CI 环境建议固定为 6；本地构建可试 8，但必须同步设置
COMPOSER_CACHE_DIR=/root/.composer/cache - 别用已弃用的
parallel-downloads，Composer 2.2+ 会静默忽略
镜像源只加速 packagist 依赖，绕不开 Git 地址
如果 composer.lock 中某依赖的 "source": {"type": "git"}，比如 git@github.com:xxx/yyy.git 或 https://github.com/xxx/yyy.git，Composer 会直接走 Git 协议或 HTTPS 克隆，完全绕过 packagist 镜像源。
这类依赖无法靠换源解决，必须：
- 检查
composer.lock的source字段，确认是否含git、svn或自定义 URL - 优先改用 packagist 托管版本（如
"monolog/monolog": "^2.10"），而非 dev 分支或私有仓库地址 - 若必须用 Git 地址，需配
GITHUB_TOKEN环境变量防 API 限流，或在 Dockerfile 中提前RUN git config --global url."https://oauth2:${GITHUB_TOKEN}@github.com/".insteadOf "https://github.com/"
多阶段构建中 builder 和 final 的 PHP 版本必须严格一致
哪怕只是小版本号（如 8.1.22 vs 8.1.26）或发行版（bullseye vs bookworm）不一致，都可能导致 autoload classmap 生成逻辑与运行时解析脱节。
常见错误：
-
FROM composer:2 AS builder—— 该镜像绑定的 PHP 版本不可控，且常缺ext-mbstring等必需扩展 -
FROM php:8.3-cli AS builder+FROM php:8.2-fpm-alpine AS final—— 构建成功，启动即Fatal error: Uncaught ParseError
正确做法：builder 和 final 的 FROM 行必须一字不差，包括 PHP 小版本、发行版、架构（如 php:8.2-cli-bullseye / php:8.2-fpm-bullseye）。
最容易被忽略的是 WORKDIR 和 --chown：builder 阶段 WORKDIR /app，final 阶段也必须相同；复制 vendor 时漏掉 --chown=www-data:www-data，会导致 FPM 进程因权限拒绝读取 vendor/autoload.php。
