查看PHP版本的命令行方法

本文深入解析了在使用 phpenv 管理多版本 PHP 时如何准确识别“当前真正生效的 PHP 版本”，指出 `phpenv version` 是唯一反映配置优先级（shell > local > global > system）与实际选中状态的命令，而 `php -r "echo phpversion();"` 才是验证运行时真实版本的黄金标准；文章不仅澄清了 `php -v` 和 `phpenv versions` 的常见误用陷阱，还系统梳理了环境初始化、shim 机制、shell 配置加载、IDE 终端兼容性及临时设置失效等典型问题，并给出可落地的诊断组合：先看 `phpenv version` 理清配置逻辑，再用 `php -r "echo phpversion();"` 一锤定音——因为唯有 PHP 自己说出的版本，才不会被 PATH、环境变量或终端机制所欺骗。

phpenv global / local / shell 设置后，怎么确认当前生效的版本

phpenv 本身不提供直接显示“当前生效版本”的命令，phpenv version 是唯一能反映实际生效状态的命令——它输出三行：当前 shell 级别设置、项目级设置（.php-version 文件）、全局设置，并标出被选中的那个。

常见错误是误用 phpenv versions（只列已安装版本）或直接跑 php -v（它反映的是 PATH 中 php 可执行文件的版本，可能和 phpenv 管理的不一致）。

• phpenv version 输出示例：

  8.3.13 (set by /path/to/project/.php-version)

  表示项目级生效中
• 若输出为

  system

  ，说明未通过 phpenv 切换，走的是系统默认 PHP（比如 /usr/bin/php）
• 输出含 (set by ~/.phpenv/version) 表示全局生效；含 (set by $PWD/.php-version) 表示本地生效

为什么 php -v 和 phpenv version 结果不一致

根本原因是：phpenv 通过 shims（代理脚本）劫持 php 命令调用，而 php -v 走的是 shim 层，phpenv version 查的是配置逻辑。两者不一致，基本等于 phpenv 没生效。

• 检查是否执行过 eval "$(phpenv init -)" 并重载 shell（exec $SHELL -l）
• 确认 which php 返回的是 ~/.phpenv/shims/php，不是系统路径（如 /usr/bin/php）
• 如果用的是 zsh，需把初始化语句加到 ~/.zshrc，而非 ~/.bashrc
• 某些 IDE 终端或 VS Code 集成终端不会自动加载 shell 配置，需手动 source 或重启终端

在项目目录里快速验证 PHP 版本是否按预期加载

最可靠的验证方式不是看命令输出，而是让 PHP 自己说——用它运行一行代码，输出 phpversion()，这结果和 Web 请求完全一致。

• 执行：php -r "echo phpversion() . \"\\n\";"
• 对比该输出与 phpenv version 显示的版本号是否完全一致（包括补丁号，如 8.3.13 ≠ 8.3.12）
• 若不一致，大概率是 ~/.phpenv/shims 没进 PATH，或 shim 文件权限异常（可试 ls -l $(which php) 看是否指向 shim）
• 注意：不要依赖 PHP_VERSION 常量做判断，它在编译时固化，无法反映 phpenv 的运行时切换

phpenv shell 切换后退出终端就失效，怎么留痕排查

phpenv shell 是临时会话级设置，只影响当前终端进程，关闭即丢。但它会在当前 shell 环境变量中写入 PHPENV_VERSION，这个变量可以被用来诊断。

• 运行 echo $PHPENV_VERSION，有输出说明 shell 级设置存在；为空则未生效或已被覆盖
• 该变量优先级高于 local 和 global，一旦设了，phpenv version 就会标出它
• 容易踩的坑：脚本中用 bash -c "phpenv shell 8.3.13; php -v" 不生效——因为 bash -c 启动的是子 shell，变量不继承；应改用 phpenv shell 8.3.13 && php -v
• 调试时建议统一用 phpenv version + php -r "echo phpversion();" 组合，绕过所有中间变量干扰

文中关于phpenv的知识介绍，希望对你的学习有所帮助！若是受益匪浅，那就动动鼠标收藏这篇《查看PHP版本的命令行方法》文章吧，也可关注golang学习网公众号了解相关技术文章。