composer config -g repo.packagist 在 Docker 中不生效，因 Composer 2.2+ 对键名、type 和 URL 格式三者硬校验：键名必须为 repo.packagist（单数），type 必须显式写 composer，URL 必须以 https:// 开头且结尾带 /；任一不符则静默忽略。同时需注意用户权限（如 www-data 无法读 /root/.composer）、Alpine 缺失 ca-certificates 和 curl、多阶段构建中配置未正确复制，以及配置命令须在 COPY composer.json composer.lock 之后执行，否则被项目级 repositories 覆盖。
composer config -g repo.packagist 命令为什么在Docker里总不写入
它不是失败，是根本没被识别为合法配置项。Composer 2.2+ 对全局镜像源的键名、type 和 URL 格式三者都做了硬校验：键名必须是 repo.packagist（单数，不能是 repos.packagist 或 packagist.org），第二个参数必须显式写 composer（这是 type 字段值，不是注释），URL 必须以 https:// 开头且末尾带 /（例如 https://mirrors.aliyun.com/composer/）。漏任一，composer config -g 就静默忽略，composer install 仍走 https://packagist.org。
验证是否真写进去了，别只看命令没报错，得运行：
composer config -g repo.packagist
输出必须是完整 JSON，比如 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}；如果返回空、null、或只有 URL 字符串，说明没生效。
Dockerfile里配镜像源，但K8s Pod启动后还是连官方源
因为 composer config -g 写的是 /root/.composer/config.json，而多数生产 PHP 镜像（如 php:8.2-apache）默认以 www-data 用户运行 Apache/PHP-FPM。容器启动时，www-data 读不到 /root 下的配置，直接 fallback。
- 解决方法是在 Dockerfile 中切换用户再执行配置：
RUN su www-data -c "composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/" - 或者统一用项目级配置（更可靠）：
RUN composer config repo.packagist composer https://mirrors.aliyun.com/composer/，该命令会把仓库写进当前目录的composer.json的repositories字段，不受用户权限影响 - 注意：项目级配置优先级高于全局，只要
composer.json里有"repositories"字段（哪怕为空数组），全局配置就完全失效
Alpine镜像中HTTPS请求失败，镜像配对了也卡住
Alpine 默认不带 CA 证书和 curl，导致 composer config 命令本身静默失败（无报错但没写入），composer install 则在 TLS 握手阶段报 SSL certificate problem。
必须在 Dockerfile 中补全基础依赖：
-
RUN apk add --no-cache ca-certificates—— 否则 HTTPS 请求全部失败 -
RUN apk add --no-cache curl—— 否则composer config在部分 Alpine 版本中无法发起网络请求，配置不落地 - 别用已停用的旧镜像地址，如
https://packagist.phpcomposer.com（2023 年下线）或https://packagist.laravel-china.org（2024 年停止），换用https://mirrors.aliyun.com/composer/或https://mirrors.cloud.tencent.com/composer/
多阶段构建中 final 阶段镜像源失效
builder 阶段明明跑了 composer config -g，final 阶段一执行 composer dump-autoload 就又连回 packagist.org，问题通常不在命令本身，而在路径与用户隔离：
- builder 阶段写入的是
/root/.composer/config.json，但 final 阶段基础镜像（如php:8.2-cli-slim）可能没挂载/root，或压根没创建该路径 - final 阶段若用
COPY --from=builder /root/.composer /root/.composer，要确认目标镜像里/root目录存在且可写；否则 COPY 失败静默跳过 - 更稳妥的做法是：在 builder 阶段把 vendor 打包好，在 final 阶段只 COPY
vendor/和composer.lock，完全不依赖运行时composer命令——这样连镜像源都不需要
最易被忽略的一点：所有配置命令必须放在 COPY composer.json composer.lock ./ 之后。如果先 config -g 再 COPY，项目里的 repositories 字段会覆盖掉刚写的全局配置，白忙一场。
