Composer报错requires php ^8.1本质是PHP版本低于包要求，解决需升级PHP或降级包（不推荐）；须确认Composer实际调用的PHP版本，再按macOS、Linux、Windows不同环境升级并清理缓存。
Composer 报错 requires php ^8.1 或类似提示，本质是当前 PHP 版本低于目标包的 require 约束。解决方向只有两个：升级 PHP，或降级包（不推荐）。优先升级环境。
确认当前 PHP 版本和 Composer 使用的 PHP
很多人误以为 php -v 显示的就是 Composer 调用的版本——其实不一定。Composer 会使用它启动时绑定的 PHP 解释器，可能来自系统 PATH、别名、或通过 php 命令查到的路径不一致。
- 运行
which php和composer config --global --list | grep php查看是否设置了php二进制路径 - 直接执行
php -r "echo PHP_VERSION;"和composer -v | head -1对比版本号 - 若用
php /path/to/composer.phar install，则明确指定了 PHP 解释器，此时以该php为准
macOS 上用 Homebrew 升级 PHP（最常见场景）
Homebrew 默认只保留一个 php 符号链接（如指向 php@8.2），但旧版可能仍被激活。需手动切换并清理残留。
- 先查看已安装版本：
brew list | grep php（常见有php@7.4、php@8.1、php@8.2等） - 卸载旧版（例如要弃用 7.4）：
brew uninstall php@7.4 - 安装新版（如 8.2）：
brew install php@8.2 - 重设符号链接：
brew unlink php && brew link php@8.2 - 检查
php -v和which php是否指向/opt/homebrew/bin/php（Apple Silicon）或/usr/local/bin/php（Intel）
Linux（Ubuntu/Debian）添加 Ondřej Surý PPA 升级 PHP
系统源里的 PHP 版本通常滞后，必须换源。Ondřej 的 PPA 是最稳定的选择，支持 7.4–8.3 各版本。
立即学习“PHP免费学习笔记（深入）”；
- 执行以下命令（以 Ubuntu 22.04 + PHP 8.2 为例）：
sudo apt install -y software-properties-common sudo add-apt-repository ppa:ondrej/php sudo apt update sudo apt install -y php8.2 php8.2-cli php8.2-mbstring php8.2-xml php8.2-zip
- 设置默认
php命令指向 8.2：sudo update-alternatives --config php，选中/usr/bin/php8.2 - 验证：
php -v应输出PHP 8.2.x；php -m | grep mbstring确保扩展已加载 - 注意：Apache/Nginx 若用
libapache2-mod-php，需对应安装libapache2-mod-php8.2并重启服务
Windows（XAMPP/WAMP/独立 PHP）切换版本的实操要点
Windows 下 Composer 往往调用的是 PATH 中第一个 php.exe，但 XAMPP/WAMP 自带的控制面板可能未同步更新 CLI 环境。
- 下载对应版本的 PHP Windows Binaries（选 Thread Safe + VC17 x64）
- 解压后修改系统 PATH：把新 PHP 目录（如
C:\php-8.2.12）移到 PATH 最前面 - 在 CMD 中执行
where php，确保只返回一条且是新路径；再运行php -v - 若用 WAMP/XAMPP，还需在面板里「PHP → Version」中切换，否则 Web 请求仍走旧版（CLI 和 Web 是两套配置）
- 检查
php.ini中extension_dir和扩展是否匹配新版本，缺失的扩展（如php_opcache.dll）需从同版本包中复制
最常被忽略的是：即使 PHP 版本升上去了，Composer 缓存可能仍记录着旧版本兼容性判断。遇到升级后仍报错，先清缓存：composer clear-cache。另外，某些包强制要求 ext-gd 或 ext-intl，光升级 PHP 不开扩展也没用。
