镜像配置仅加速下载，不解决PHP环境问题；卡在Resolving dependencies多因PHP版本与platform不匹配、内存不足或Xdebug启用，需验证真实CLI版本、扩展加载及composer.json中platform声明是否一致。
镜像配置本身不改变PHP CLI版本，但会放大环境不匹配的问题
镜像只是换下载地址，不改PHP解释器、不装扩展、不调版本。很多人误以为换完阿里云镜像就“万事大吉”，结果composer install能跑通，vendor/autoload.php一引入就ParseError——根本不是镜像的事，是PHP CLI版本和config.platform.php对不上。
-
config.platform.php只在composer update或install --lock时起作用，它告诉Composer“假装运行环境是PHP 8.2”，但实际执行php -v还是你本地那个7.4 - 如果你在PHP 7.4 CLI下设
"platform": {"php": "8.2.0"}，Composer真会装进含enum语法的包，运行时直接崩溃 - 镜像加速的是
Downloading packages阶段，卡在Resolving dependencies？那八成是PHP内存不够、Xdebug开着，或platform和实际CLI版本冲突
PHP CLI版本不对时，镜像反而让错误更隐蔽
用https://mirrors.aliyun.com/composer/后下载飞快，容易让人忽略底层环境缺陷。比如Windows下PATH指向了XAMPP里的PHP 7.2，但php -v显示8.2——那是VS Code终端缓存了旧路径，真实CLI仍是7.2。
- 必须用完整路径验证：
C:\phpstudy_pro\Extensions\php\php-8.2.12\php.exe -v，不能只信php -v - Linux/macOS上
which php输出要和php -i | grep "Loaded Configuration File"一致，否则openssl、mbstring可能根本没加载 - 镜像URL末尾少
/（如写成https://mirrors.aliyun.com/composer）会导致404，但Composer报错是Could not resolve host——这是DNS劫持假象，实际是HTTP 404被curl误判
Docker里配镜像，必须和PHP基础镜像对齐
在php:8.2-cli镜像里跑composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/，看起来没问题，但若composer.json里没写"config": {"platform": {"php": "8.2.15"}}，Composer仍会按当前环境推测能力，可能装入仅兼容PHP 8.3的包。
- builder阶段必须用和final镜像同源的PHP：都是
php:8.2-fpm-alpine，别一个-cli一个-fpm - Alpine镜像需提前
RUN apk add --no-cache ca-certificates git unzip，否则镜像源HTTPS握手失败，跟换源无关 - 项目级配置比全局配置更可靠：
composer config repo.packagist composer https://mirrors.aliyun.com/composer/，它写进composer.json，CI构建时自动生效
中文路径+镜像=双重陷阱
项目根目录含中文、或composer init时输入中文作者名，会触发JSON编码乱码。镜像再快也没用——composer.json文件末尾多出\ufffd，后续所有命令都报Your requirements could not be resolved。
立即学习“PHP免费学习笔记（深入）”；
- Windows CMD默认GBK编码，
composer init交互式输入中文必然乱码 → 改用PowerShell或WSL，或直接手写composer.json - macOS/Linux用户注意终端locale，
echo $LANG应为en_US.UTF-8或zh_CN.UTF-8，非UTF-8 locale下写入中文也会坏 - 镜像配置成功后仍卡住？先跑
php -d xdebug.mode=off $(which composer) install排除Xdebug干扰，再查COMPOSER_MEMORY_LIMIT=-1是否生效
vendor能否运行的，永远是PHP CLI的实际版本、扩展状态和platform声明是否自洽——镜像只是让这个矛盾暴露得更快而已。 
