Composer安装报“requires php ^8.1”但本地是PHP 7.4，根本原因是composer.json中"php": "^8.1"与当前CLI的php -v版本不匹配；应显式调用目标PHP二进制执行，如Linux/macOS用/usr/bin/php8.1 composer install，Windows用"C:\php\php81\php.exe" composer install，并确保php -v、which php和composer config platform.php三者一致。
composer install 报 requires php ^8.1 但你本地是 PHP 7.4？别换镜像，换 PHP 执行器
镜像（如阿里云、腾讯云）只改包下载地址，不改 PHP 版本校验逻辑。换镜像后报错更快，不是问题修好了，而是 Composer 的依赖求解器更快确认“无解”。真正拦住你的，是 composer.json 里写的 "php": "^8.1" 和你当前 CLI 的 php -v 不匹配。
确认 Composer 实际用哪个 PHP：
- 运行
php -v—— 看输出的版本号 - 再跑
which php—— 看它到底加载的是哪个二进制 - 两者对不上（比如
php -v显示 8.2，which php却指向/usr/bin/php），说明有 alias、shell 函数或 PATH 缓存干扰
最稳方案：显式用目标 PHP 二进制调用 composer.phar，绕过所有环境干扰：
- Linux/macOS：
/usr/bin/php8.2 /path/to/composer.phar install（路径必须写全） - Windows：
"C:\php\php-8.2\php.exe" composer.phar install（路径含空格必须加双引号） - macOS Homebrew 用户常用：
php@8.2 -d memory_limit=-1 /path/to/composer.phar install
composer self-update --version 降级失败？v2.5.0+ 禁止退到老主版本
composer self-update --version 只能退到官方发布的稳定版（如 2.5.8、2.2.22），但 v2.5.0 及以上默认禁止降级到低于 v2.5.0 的版本。执行 composer self-update --version 2.1.14 会直接报错：Downgrading to a version older than 2.5.0 is not supported。
立即学习“PHP免费学习笔记（深入）”；
查可用版本最准的方式：
- 访问 GitHub Release 页面
- 或用命令快速扫一眼：
curl -s https://api.github.com/repos/composer/composer/releases | grep \"tag_name\" | head -5 - Windows PowerShell 中必须给版本号加引号：
composer self-update "2.5.8"
国内网络下 self-update 常卡在 SSL 连接或超时，因为默认从 https://getcomposer.org 下载——这个域名不稳定。不要用 --no-ssl（不安全且新版已弃用），优先选：
- 临时配代理：
export HTTP_PROXY=http://127.0.0.1:7890; export HTTPS_PROXY=http://127.0.0.1:7890 - 手动下载对应 PHAR，校验 SHA384 后替换：
curl -sS https://getcomposer.org/download/2.5.8/composer.phar -o /tmp/composer.phar，再比对官网 checksum
降级后 composer install 失败？锁文件不兼容是主因
回退 Composer 版本后跑 composer install 报错，常见原因不是命令错了，而是元数据不匹配：Your lock file does not contain a compatible set of packages —— 说明 composer.lock 是高版本（如 v2.7）生成的，低版本（如 v2.1）无法解析。
解决方式只有两个选择：
- 删掉
composer.lock，重新跑composer install（适合开发环境，但会丢失精确版本控制） - 升级 Composer 到能读该锁文件的最低版本（推荐，尤其 CI 构建）
注意：composer update 不会帮你降级自身，它只管项目依赖；--rollback 仅能单次回退至上一版本且依赖备份文件，不可靠。
config.platform.php 设了 "8.2" 就能装？它只骗过安装，骗不过 PHP 解释器
config.platform.php 是 Composer 唯一允许你“声明目标平台 PHP 版本”的配置项，但它只影响 install/update 阶段的依赖解析，对运行时零作用。
适用场景：
- 你在 PHP 7.4 的机器上，但要为 PHP 8.2 的生产环境打包
vendor/（比如 CI 构建部署包） - 设置方式：
composer config platform.php "8.2.0"，然后必须跑composer update --lock重生成composer.lock
严重误用：
- 本地是 PHP 7.4，设
"platform.php": "8.2"后composer install成功了，结果vendor/里塞进一堆 PHP 8.2 语法（如match、enum），一运行就ParseError - 真实运行环境不支持的语法，PHP 解释器自己就会报错，谁也绕不过去
真正让项目跑起来，得看清约束来源、执行路径和运行时边界——php -v 输出的版本，才是唯一决定因素。
