Composer报错“PHP version too low”但php -v显示正确，根本原因是Composer实际调用的PHP解释器路径与终端显示版本不一致，需通过验证PHP_BINARY、shebang行和composer内部PHP_BINARY三者是否统一，并显式指定PHP路径执行composer.phar，切换PHP后须清理vendor和lock文件并重启终端。
composer install 报错“PHP version too low”但 php -v 显示版本正确
这说明 Composer 没有实际运行在你看到的那个 PHP 版本下。根本原因不是 php -v 的输出，而是 Composer 启动时真正调用的解释器路径。常见干扰源包括：PHP_BINARY 环境变量被残留设置、shell wrapper 脚本硬编码了旧路径、或终端未重启导致仍绑定旧 PHP 进程。
验证真实执行环境的三步法：
- 运行
echo $PHP_BINARY（Linux/macOS）或echo %PHP_BINARY%（Windows），看是否指向旧版本 - 运行
which composer，再用head -n1 $(which composer)查 shebang 行（如#!/usr/bin/env php），这个php才是关键 - 运行
php -r "echo PHP_BINARY;"，这是 Composer 内部实际加载的二进制路径，必须与预期一致
显式指定 PHP 路径调用 composer.phar 是最稳方案
不依赖 PATH、不碰软链、不改全局配置，直接控制解释器——这是 CI/CD 和多项目共存下的事实标准。
实操要点：
立即学习“PHP免费学习笔记（深入）”；
- Linux/macOS：
/usr/bin/php8.2 composer.phar install或php8.2 /path/to/composer.phar update - macOS Homebrew 用户注意：
/opt/homebrew/bin/php@8.2 -d memory_limit=-1 /usr/local/bin/composer.phar install，-d参数必须紧接在 PHP 路径后 - Windows：
"C:\php\php-8.2.12\php.exe" composer.phar install，路径必须加引号（空格会导致命令解析失败） - 宝塔用户：
/www/server/php/82/bin/php /usr/bin/composer install
别用 alias composer='php8.2 composer' —— 在 Git hooks、Makefile、非交互 shell 中大概率失效。
切换后必须重装依赖，不能跳过 vendor 和 lock 文件清理
Composer 不会自动适配新 PHP 版本下的扩展兼容性或字节码差异。旧 vendor/ 目录里可能含针对旧 PHP 编译的扩展（如 ext-redis 的 .so）、或由旧版本生成的 autoload 文件（含不兼容语法）。
安全做法是彻底重建：
- 删除
vendor/目录和composer.lock - 确认当前
php -v和PHP_BINARY已就位 - 运行
composer install（而非update），让 Composer 重新解析依赖树并生成匹配当前环境的 autoload 和 bin scripts
如果项目用了 "config": {"platform": {"php": "8.1.0"}}，记得同步更新该值，否则 composer install 可能拉取不兼容的包版本。
phpenv 切换 PHP 后 composer 命令仍报 command not found
因为 phpenv 只管理 PHP 版本，不安装或注册 Composer。它不自动把 composer 加进 PATH，也不负责部署 composer.phar。
正确对接方式：
- 手动下载安装到
$HOME/phpenv/bin/composer：php composer-setup.php --install-dir=$HOME/phpenv/bin --filename=composer - 确保该路径已加入
PATH（检查echo $PATH是否含$HOME/phpenv/bin） - 验证：
$HOME/phpenv/bin/composer --version，成功后再设export PATH="$HOME/phpenv/bin:$PATH"到 shell 配置中
切记：每次用 phpenv global 或 phpenv local 切换版本后，必须关闭并重新打开终端——已打开的终端不会自动继承新 PHP 的环境变量或 PHP_BINARY。
最容易被忽略的是 PHP_BINARY 环境变量和终端进程绑定关系。即使你改了 phpenv global，旧终端里的 php 命令仍指向上一个版本的二进制，而 Composer 优先读这个变量。所以验证环节不能省，重装前必须确认三者一致：终端 php -v、PHP_BINARY 输出、以及 composer --version 启动时打印的 PHP 版本。
