换镜像只加速下载，不解决PHP版本兼容问题；报错根源是composer.json中"php": "^8.1"与本地PHP 7.4冲突，需用config.platform.php指定目标版本（如"7.4.33"）并删除composer.lock后重装。
为什么换镜像后旧版PHP项目还是装不上依赖
换镜像只加速下载，不解决 PHP 版本兼容性问题。你看到的 composer install 报错 “Your PHP version 7.4.33 does not satisfy that requirement”，根源是 composer.json 里写了 "php": "^8.1"，而 Composer 正在用当前 PHP 7.4 解释器校验——它没卡在下载，是直接拒绝解析依赖。镜像再快也没用。
常见误操作：先配了阿里云镜像，再运行 composer install，结果报错依旧。这不是镜像失效，是你还没处理平台约束。
- 确认 CLI PHP 版本：
php -v（注意不是 Web 环境的版本） - 检查
composer.json中"require": { "php": "..." }的值 - 若开发环境必须用 PHP 7.4，且不能升级，下一步不是换镜像，而是控制依赖解析逻辑
config.platform.php 是什么，怎么安全配合镜像使用
config.platform.php 是唯一能让 Composer “假装”当前环境是某 PHP 版本的配置项，它只影响依赖解析阶段，不改变实际运行能力。它和镜像无关，但必须和镜像一起用，否则即使镜像拉得快，也会装进一堆 PHP 8+ 语法的包。
正确流程是：先设 platform → 再清锁文件 → 最后用镜像重装。
立即学习“PHP免费学习笔记（深入）”；
- 执行：
composer config platform.php "7.4.33"（写入composer.json的config段） - 删掉
composer.lock和vendor/（旧锁文件仍绑定 PHP 8 的包版本） - 确保已配置中文镜像：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/ - 运行：
composer install—— 此时 Composer 会按 PHP 7.4.33 去 Packagist 镜像中找兼容版本
⚠️ 不要提交 config.platform.php 到团队仓库，除非所有成员 CLI PHP 版本完全一致；CI 环境可设，但需实测所有依赖在真实 PHP 7.4 下能跑通。
旧版 PHP 下该用哪个 Composer 版本
Composer 自身也有最低 PHP 要求。PHP 7.4 环境只能用 Composer 2.4.x（最后一个支持 PHP 7.2.5–8.1 的主版本），composer self-update 2.4.9 可降级。若强行用 Composer 2.5+，连 composer --version 都会报 Unsupported version。
- 验证当前 Composer 版本：
composer --version - 降级命令（Linux/macOS）：
composer self-update "2.4.9"（Windows 必须加引号） - 若
self-update国内超时，手动下载 PHAR：curl -sS https://getcomposer.org/download/2.4.9/composer.phar -o /tmp/composer.phar，校验 SHA384 后替换 - 降级后若仍报
Your lock file does not contain a compatible set of packages，说明composer.lock是高版本生成的，必须删除再composer install
装完还报 ParseError 或 Call to undefined function 怎么办
这说明 Composer 成功安装了包，但某些代码用了旧版 PHP 不支持的语法或函数。比如 #[Attribute]、match、enum 在 PHP 7.4 下直接解析失败；又或者扩展没启用（如 mbstring、json），导致 json_encode() 找不到。
- 运行
composer show vendor/package-name查看实际安装的版本，再上 Packagist 确认该版本是否真支持 PHP 7.4（例如symfony/console:v6要求^8.1，就得换v5.4） - 显式指定兼容版本：
composer require symfony/console:^5.4 - 检查 PHP 扩展：
php -m | grep -E "(mbstring|json|xml|curl)" - 禁用 opcache 缓存干扰：
php -d opcache.enable=0 artisan serve（Laravel 场景）
最易被忽略的一点：config.platform.php 只骗过 Composer，骗不过 PHP 解析器。它不会让 PHP 7.4 支持 readonly 属性或联合类型，那些代码一旦加载就崩。所以“兼容”不是靠配置绕过去，而是靠选对真正支持旧版的包版本。
