执行phpenv install 8.3.13后需三步验证：先运行phpenv rehash生成shims；再执行php -v确认输出匹配该版本；最后用phpenv which php检查路径是否为~/.phpenv/versions/8.3.13/bin/php。
phpenv install 命令执行后怎么确认 PHP 是否真正可用
安装完某个版本（比如 phpenv install 8.3.13）后，phpenv versions 只会显示它“已安装”，不代表能跑起来。必须手动验证解释器是否就绪。
- 先运行
phpenv rehash—— 这步常被跳过，但它是生成 shims 的关键，没它php命令根本不会指向新版本 - 再执行
php -v，看输出是否匹配你刚装的版本号；如果还是旧版或报错，说明 PATH 或 shim 没生效 - 用
phpenv which php查真实路径，应返回类似~/.phpenv/versions/8.3.13/bin/php，而不是/usr/bin/php或其他系统路径
为什么 phpenv versions 列出来的版本带 * 却 php -v 不变
带 * 表示该版本被“选中”，但不等于“已激活”。phpenv 的生效依赖 shell 层级的 shim 机制，而 shim 要求 phpenv init - 已正确注入当前 shell。
- 检查
which php输出：若仍是系统自带路径，说明~/.phpenv/shims没进PATH，或顺序靠后被覆盖 - 确认
~/.phpenv/shims在PATH中且位置靠前，例如export PATH="$HOME/.phpenv/shims:$PATH"（注意不是bin目录） - zsh 用户特别注意：
~/.zshrc和~/.zprofile加载顺序不同，eval "$(phpenv init -)"必须放在能被交互式登录 shell 执行的位置
phpenv local 不生效？检查 .php-version 文件格式和位置
phpenv local 7.4.33 实际只是往当前目录写一个 .php-version 文件，后续靠 phpenv 的 shim 自动读取。这个文件非常脆弱。
- 文件必须是纯文本、UTF-8 编码、无 BOM，内容仅一行：例如
7.4.33，不能有空格、注释或多余换行 - 必须位于你执行
php命令时的**当前工作目录**下（不是父目录，也不是子目录），且该目录不能有同名的.php-version被上层覆盖 - 若用 IDE 内置终端，可能未加载用户 shell 配置，导致 phpenv hook 未触发 —— 建议统一用系统终端 cd 进项目再操作
查看当前 PHP 完整信息：别只信 php -v
php -v 只显示版本号和 Zend 引擎信息，实际开发中更需要知道扩展、配置路径、编译参数等细节。
立即学习“PHP免费学习笔记（深入）”；
- 用
php --ini查看加载的php.ini路径，确认是不是你期望版本对应的配置文件 - 用
php -m看已启用的扩展，尤其注意opcache、mbstring等是否在列 - 用
php -i | grep "Configure Command"查编译参数，判断是否启用了你需要的选项（如--with-openssl） - 如果
php --ini显示 “Loaded Configuration File => (none)”，说明该版本没配php.ini，需从phpenv root下的share/php-build/模板复制一份过去
环境变量、shims 路径、配置文件位置这三处稍有偏差，就会让整个版本切换逻辑静默失效——它们不像 Web 服务那样报错明显，而是“看起来在跑，其实没走对路”。
