需确保 composer 运行时使用匹配的 php 版本：临时指定路径（如 /usr/bin/php8.1 composer install）、切换系统默认 php、修正 windows 的 composer.bat 路径，或在 composer.json 中配置 "platform": {"php": "x.y"} 统一环境。
composer install 报错 “This package requires php ^8.1 but your PHP version (7.4.33) does not satisfy that requirement”
这是最常见的情况：项目 composer.json 里写了 "php": "^8.1"，但当前系统默认 PHP 是 7.4，composer install 直接失败。Composer 本身不管理 PHP 版本，它只是读取当前运行环境的 php -v 结果来校验。
解决思路不是让 Composer “切换 PHP”，而是确保它执行时调用的是目标版本的 PHP 解释器：
- 临时指定 PHP 路径运行：比如你装了 PHP 8.1 在
/usr/bin/php8.1，就用/usr/bin/php8.1 /usr/bin/composer install - 改系统默认
php命令（Linux/macOS）：用update-alternatives --config php或brew unlink php@7.4 && brew link php@8.1（macOS Homebrew） - Windows 用户注意：别只改 PATH 里的 php.exe 顺序，还要确认
composer.bat里硬编码的 PHP 路径（打开看第 2 行），否则它可能仍调用旧版
composer create-project 拉下来的项目跑不起来，提示 “Class 'Composer\Autoload\ClassLoader' not found”
这通常发生在用低版本 PHP 运行了本该用高版本生成的项目 —— 尤其是 Laravel、Symfony 等框架的脚手架项目，它们的 vendor/autoload.php 可能依赖 PHP 8+ 的语法或扩展（如 mbstring 缺失、json 扩展未启用），而 Composer 并不会在 create-project 阶段做完整运行时检查。
关键点：Composer 的 require 校验只发生在 install/update 阶段，且仅检查 php 版本声明和扩展是否存在，不验证扩展是否启用或配置是否合理。
立即学习“PHP免费学习笔记（深入）”；
- 先手动运行
php -m | grep -E 'mbstring|json|xml|curl'确认必需扩展已加载 - 检查
php --ini输出的配置文件路径，确认没被多个php.ini冲突（比如 CLI 和 FPM 用不同配置） - 如果用 XAMPP/MAMP，CLI 的 PHP 配置常和 Web 不一致，务必单独检查
php -i | grep 'Loaded Configuration File'
PHP 多版本共存时，composer global require 总装到错的 vendor 目录
composer global require 的安装位置取决于当前 PHP 的 sys_get_temp_dir() 和 get_cfg_var('phar.readonly') 等运行时参数，而不是 Composer 自身路径。不同 PHP 版本下，~/.composer 可能被不同版本写入，导致命令冲突或 autoload 错乱。
最稳妥的做法是彻底避免混用：
- 不要全局安装框架 CLI 工具（如
laravel/installer），改用composer create-project laravel/laravel或项目内局部安装 - 如果必须用 global，每次切换 PHP 后都执行一次
composer global update，强制重装并重建 autoloader - 检查
composer global config home输出，确认它指向的是你期望的目录；某些旧版 Composer 会把 global vendor 写进 PHP 扩展目录里，极难清理
CI/CD 中用 docker run --rm -v $(pwd):/app composer install 总报 PHP 版本不匹配
Docker 官方 composer 镜像（如 composer:2）自带 PHP 运行时，但它和宿主机 PHP 版本无关 —— 问题出在你本地 composer.json 的 platform 配置没对齐。
例如：你本地开发用 PHP 8.2，但 CI 用的 composer:2 镜像是基于 PHP 8.1 构建的，而你的 composer.json 里又没设 "platform": {"php": "8.1"}，就会导致 composer.lock 记录的包版本在 CI 里无法复现。
- 在
composer.json的config段加上"platform": {"php": "8.1"}，强制锁定平台版本 - CI 脚本中加一步
composer show php，确认实际运行的 PHP 版本 - 不要在 Docker 中挂载宿主机的
~/.composer，容易污染镜像缓存，用--no-cache或独立 volume 更干净
多版本 PHP 切换本身不难，难的是 Composer 不报错的“静默不一致”——比如 lock 文件里记录了 PHP 8.2 特有的函数签名，但你在 8.1 下运行时直到 runtime 才 fatal error。这种延迟暴露的问题，比直接报错更耗时间定位。
