Composer install 报 PHP 版本不满足，因其校验的是 shell 中 php 命令指向的 CLI 版本，而非 Web 服务器（如 Nginx+PHP-FPM）所用版本；即使 phpinfo() 显示 8.3，若 php -v 输出 8.1，则会因不匹配 "php": "^8.3" 而报错。
composer install 为什么总报 PHP 版本不满足？
因为 composer install 校验的是当前 shell 中 php 命令指向的 CLI 版本，不是你 Web 服务器（如 Nginx + PHP-FPM）用的版本，也不是 phpinfo() 显示的那个。哪怕浏览器里 phpinfo() 是 8.3，只要终端执行 php -v 输出是 8.1，composer install 就会按 8.1 去比对 composer.json 里的 "php": "^8.3"，直接报错。
常见错误信息：This package requires php ^8.3 but your PHP version (8.1.25) does not satisfy that requirement
- 别急着改系统默认 PHP——不同项目可能要求不同版本，硬切容易互相干扰
- 先确认真实调用链：
head -n1 $(which composer)看 shebang；再查which php和php -v - Windows 用户务必打开
composer.bat文件，检查第二行是否硬编码了旧版路径（如C:\php74\php.exe），PATH 修改无效
怎么让 composer install 用指定 PHP 版本运行？
最稳的方式是显式传入 PHP 解释器路径，不依赖环境变量或软链接。Composer 本身不“切换版本”，它只是个被 PHP 执行的脚本。
- Linux/macOS：
/usr/bin/php8.3 /usr/local/bin/composer install - macOS Homebrew：
/opt/homebrew/bin/php@8.3 /usr/local/bin/composer install - 宝塔面板：
/www/server/php/83/bin/php /usr/bin/composer install - Windows：
"C:\php\php83\php.exe" composer install
注意：config.platform.php 只影响依赖解析阶段（比如 composer update 时假装有某个 PHP 版本），它不会改变 composer install 实际运行时的解释器，也不会修复运行时报错。
立即学习“PHP免费学习笔记（深入）”；
vendor 目录在不同 PHP 版本间能复用吗？
不能。生成的 vendor/autoload.php 和 vendor/composer/autoload_static.php 严重依赖当前 PHP 版本的反射行为、语法支持和扩展可用性。PHP 8.1 下生成的 autoload 文件，在 8.3 下运行可能类找不到、方法不存在，甚至 fatal error。
- 换 PHP 版本后必须删掉
vendor/和composer.lock，再用目标版本重新composer install - CI/CD 脚本中若缓存了
vendor/，要确保缓存 key 包含 PHP 版本（如php-8.3-composer-lock-hash） -
--ignore-platform-reqs是临时绕过手段，装出来的vendor很大概率在运行时报错，别用于生产
刚 clone 项目就 install 失败，该查什么？
不是网络问题，大概率是环境与锁文件前提不匹配。重点看三件事：
- 确认
composer.lock文件存在且已提交到 Git——没有它，composer install会退化为update，结果不可控 - 检查
vendor/是否被.gitignore错误排除，导致 CI 拉不到完整代码树（尤其某些模板项目会误加） - 验证
composer.json里包名有没有隐藏空格或拼写错误（如"laravel/framework": "10.x-dev "多了个空格），这种错误install不报，但后续autoload失效
真正容易被忽略的一点：即使 composer install 成功，也不代表项目能跑起来。类找不到、命令不存在、php artisan 报错，90% 是因为自动加载没生效或路径映射错位——别急着重装，先看 vendor/autoload.php 是否被正确引入，再查 composer dump-autoload -o 是否执行成功。
