必须切换至PHP 8.1+ CLI版本执行composer install，如Linux用/usr/bin/php8.1 composer install，Windows用"C:\php\php81\php.exe" composer install，并确保php -v、which php和composer diagnose三者一致，切勿用--ignore-platform-reqs或伪造platform.php导致运行时ParseError。
composer install 报 “requires php ^8.1” 但你用的是 PHP 7.4，怎么办
这不是 Composer 在刁难你，而是它严格按 php -v 输出的版本校验 composer.json 里的 "php": "^8.1" 约束。不匹配就停，不装、不妥协、不自动降级。
常见错误操作包括：
- 看到报错就加
--ignore-platform-reqs—— 装完可能直接ParseError: unexpected token "match"，因为 PHP 7.4 根本不认识 PHP 8.1 的语法 - 改了
config.platform.php却没跑composer update --lock，导致composer.lock还锁着旧包，冲突照旧 - 在 PHP 7.4 环境里设
"platform": {"php": "8.2"}后直接跑 Laravel 11 —— 本地根本跑不起来
正确做法是让 Composer 明确知道你要按哪个 PHP 版本解析依赖：
- Linux/macOS：
/usr/bin/php8.1 composer install（路径必须绝对，不能用~/） - Windows：
"C:\php\php81\php.exe" composer install（含空格必须加引号） - 宝塔用户：
/www/server/php/81/bin/php /usr/bin/composer install
为什么 php -v 显示 8.1，composer install 却报 7.4？
根本不是编码或 locale 问题，而是 Composer 实际调用的 PHP 解释器路径和你终端里敲 php 的根本不是同一个。中文用户尤其容易中招：phpstudy、XAMPP、宝塔等工具自带的 composer 命令，往往是 shell wrapper 脚本，硬编码了类似 /phpstudy/php/php-5.6/bin/php 这种路径。
立即学习“PHP免费学习笔记（深入）”；
验证三步法（别信 php -v）：
- 运行
composer diagnose，看 “PHP version” 行 —— 这才是它真正加载的版本 - 运行
which composer，再用head -n1 $(which composer)查 shebang 行（如#!/usr/bin/env php），这个php才是关键 - 运行
php -r "echo PHP_BINARY;"—— 这是 Composer 内部实际加载的路径，必须和你期望的一致
显式指定 PHP 路径执行 composer.phar 是最稳的做法，能绕过所有 PATH、alias、wrapper 和环境变量干扰。
如何安全降级依赖以适配旧 PHP
伪造 platform.php 有风险，升级 PHP 是根本解法；但如果短期无法升级，应显式锁定兼容旧版本的包大版本。
例如：
- Laravel 10 要求 PHP 8.1+，但 Laravel 9 支持 PHP 8.0+，Laravel 8 还支持 PHP 7.3+
- 查 Packagist 或文档，确认最后一个兼容你 PHP 版本的主版本（如 PHP 7.4 →
"laravel/framework": "^8.75"） - 删掉
composer.lock和vendor/目录 - 再跑
composer install，让 Composer 重新计算兼容组合
也可用 composer prohibits vendor/package 快速定位谁在拦路，比如 composer prohibits monolog/monolog 会告诉你哪个依赖强制绑定了高版本 monolog。
切换 PHP 版本后还 panic？清理 vendor 和 lock 是必须的
直接跑 composer install 很大概率 panic 或 silent fail，因为旧 vendor/ 里可能含针对 PHP 7.4 编译的 .so 扩展，或由旧版本生成的 autoload 文件。
务必执行：
rm -rf vendor/ composer.lockcomposer clear-cache- 再用目标 PHP 二进制执行
composer install
特别注意：composer.lock 不只是记录版本，它还固化了 autoloader 结构、classmap、files 加载顺序 —— 换 PHP 大版本后，这些都得重来，否则 autoload 可能漏类、扩展可能加载失败、甚至进程 segfault。
