composer config -g repo.packagist 在 php-fpm 容器中不生效，因 php-fpm 不读该配置且 www-data 家目录常不存在或不可写；必须在 dockerfile 的同一 run 指令中先配置再 install，并确保键名、type 值、url 斜杠三者正确。
composer config -g repo.packagist 命令在容器里为什么总不生效
不是镜像地址错了，也不是网络不通，而是这条命令在 PHP-FPM 容器启动时执行根本没意义。php-fpm 是常驻进程，不跑 composer install 就不会读配置；composer config -g 写的是 ~/.composer/config.json，但多数基础镜像里 www-data 用户的家目录压根不存在，或者不可写——写进去也白写。
Dockerfile 里必须这么写才真正生效
全局镜像配置只在构建阶段（docker build）运行 composer install 时起作用。所以必须把配置和安装放在同一个 RUN 指令里，且确保路径、参数、斜杠三者全对：
RUN composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/- 紧接着同一行用
&&连接composer install，比如：&& composer install --no-dev --optimize-autoloader - 验证是否写入成功：在这条
RUN后加一句RUN composer config -g repo.packagist，构建日志里应输出{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
别踩这仨硬坑：键名、type、结尾斜杠
漏掉任意一个，命令静默失败，不报错但也不生效：
- 键名必须是
repo.packagist（单数repo，不是repos或repository） -
composer是type字段值，小写，不可省略（不是注释，是必需参数） - URL 必须以
https://开头，且末尾带/，例如https://mirrors.aliyun.com/composer/✅，少斜杠会拼出/composerpackages.json导致 404
项目级配置比全局更稳，尤其在 K8s 或 CI 中
全局配置依赖用户家目录，在 Pod 重启、CI runner 切换用户时必然丢失。项目级配置直接写进 composer.json，Git 可追踪，环境无关：
- 进项目根目录（含
composer.json），执行：composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 它会自动在
repositories字段里安全追加，不破坏已有私有源 - 改完必须删掉
vendor/和composer.lock，再跑composer install - 注意：
"packagist": false会屏蔽所有基础包，千万别写
composer config -g 的效果完全取决于它是否被固化进镜像层，而不是你能不能在容器里手动敲出来。真正关键的不是“怎么配”，而是“在哪配、谁来读、什么时候用”。php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
