终端php -v显示版本与网站实际运行版本不同，根本原因是PATH中PHP路径优先级冲突；应将宝塔PHP路径如/www/server/php/82/bin前置到PATH开头，或用/www/server/php/82/bin/php显式调用，避免修改系统软链。
终端执行 php -v 显示的版本，和宝塔/ThinkPHP/Nginx 实际运行的版本不是一回事 —— 根本原因就是环境变量 PATH 里多个 PHP 路径的优先级冲突了。
为什么 php -v 总是旧版本？
系统找 php 命令时，只看 PATH 从左到右第一个匹配的可执行文件。常见情况：
-
/usr/bin/php（系统自带，比如 Ubuntu 的 8.1）排在~/.phpenv/shims或/www/server/php/82/bin前面 - 宝塔面板自己用的是
/www/server/php/82/bin/php，但你终端敲的php根本没走它 -
which php返回/usr/bin/php，就说明当前 PATH 顺序有问题
如何让 phpenv 真正生效？
关键不是“装了”，而是 shell 是否真正加载了 phpenv 的 shims 层：
- 确认
~/.phpenv/bin在PATH最前面：echo $PATH | grep phpenv应该出现在开头附近 - 必须执行
eval "$(phpenv init -)"，且这行要写在~/.bashrc或~/.zshrc末尾，不能只写export PATH=... - 改完配置后，用
source ~/.zshrc（或对应 shell 文件），别只开新终端 —— 某些终端不会自动 reload - 执行
phpenv rehash，否则新安装的版本不会出现在phpenv versions列表里
宝塔用户：别动 /usr/bin/php，直接软链或前置 PATH
删 /usr/bin/php 风险高，很多系统工具依赖它。更安全的做法：
立即学习“PHP免费学习笔记（深入）”；
- 临时切换：把宝塔目标版本目录加到 PATH 开头，比如
export PATH="/www/server/php/82/bin:$PATH" - 永久生效：在
~/.bashrc里加这行，并确保它在其他 PATH 修改之前 - 或者用软链接（lnmp 用户常用）：
sudo ln -sf /www/server/php/82/bin/php /usr/bin/php，但要注意权限和 SELinux 限制 - 验证：执行
which php和php -v，两者输出必须一致且指向宝塔目录
Composer 报错 “PHP version does not satisfy” 怎么办？
这不是 Composer 的问题，是它读到了错误的 php 版本：
- 先运行
composer --version和php -v，确认两者调用的是同一个解释器 - 如果
php -v是 7.4，但项目 require"php": "^8.2"，composer install必然失败 - 不要用
platform配置硬绕过 —— 这会让后续php artisan或think命令在运行时报错 - 正确做法：用
phpenv global 8.2.0切换，再phpenv rehash，最后composer install
最容易被忽略的一点：即使你用了 phpenv local，进入项目目录后仍要确认 which php 输出是否已变 —— 有些 shell（比如 zsh + oh-my-zsh）会缓存命令路径，不 rehash 就不会刷新。
