phpenv install 8.x 失败主因是缺构建依赖、网络问题或 autoconf 版本过低；global/local/shell 切换逻辑不同，需配合 rehash 和 which 确认生效；Composer 需绑定 phpenv 的 PHP 路径。
phpenv install 安装 PHP 8.x 失败的常见原因
直接运行 phpenv install 8.2.8 很可能卡在编译阶段或报错退出，不是命令写错了，而是缺依赖或路径没配对。
- 必须提前安装系统级构建依赖：
build-essential（Ubuntu/Debian）、gcc make autoconf（CentOS/RHEL）、libssl-dev libxml2-dev libsqlite3-dev libcurl4-openssl-dev等 —— 少一个都可能让 configure 阶段失败 - 如果用的是 macOS，
xcode-select --install和brew install openssl@3 libxml2 sqlite3也得先跑一遍 -
phpenv install默认从 php.net 下源码编译，不走包管理器；若网络不稳定，可手动下载 tar.gz 到$(phpenv root)/cache/目录再重试 - 某些 PHP 8.x 版本（如 8.3.0）对
autoconf版本敏感，低于 2.70 会报错 —— 检查用autoconf --version
phpenv local 与 phpenv global 的行为差异
两者都改 php -v 输出，但生效范围和触发时机完全不同，混用容易导致“进目录版本没变”或“退出后还残留旧版本”。
-
phpenv global 8.2.8：写入~/.phpenv/version，影响所有新打开的 shell，但不会覆盖当前 shell 已激活的shell版本 -
phpenv local 8.2.8：在当前目录生成.php-version文件，只对该目录及其子目录生效；进入时自动触发，但前提是该目录下没有同名的.php-version被 gitignore 或权限阻止读取 -
phpenv shell 8.1.17：仅当前终端会话有效，关闭终端即失效；适合临时测试，但和local冲突时优先级最高 —— 即使进了带.php-version的项目，shell设置仍会压倒它
phpenv version 显示 “system” 而不是预期版本
这不是 bug，是明确提示：当前没命中任何 global / local / shell 规则，正在使用系统自带的 /usr/bin/php。
PHP 8.5.12
下载
修复 Core bailout 状态损坏安全问题，以及 BZ2、DOM、PDO、Opcache/JIT 内存与执行错误，改进 Unicode 字素处理、URL 解析、TLS 流状态、信号分发及会话错误处理。
- 运行
phpenv versions确认目标版本是否真的已安装成功（已编译完成并出现在列表里） - 检查当前目录是否存在
.php-version，内容是否为纯版本号（如8.2.8），不能带空格或注释 - 确认
~/.phpenv/version文件存在且内容正确；若不存在，global未设置，phpenv version就会回落到 system - 执行
phpenv rehash—— 这一步常被跳过，但它负责刷新~/.phpenv/shims/php符号链接，没它，新装的版本根本不会被调用
切换后 php -v 正确但 composer install 报错
Composer 本身是 PHP 脚本，但它默认绑定的是启动时解析出的 PHP 解释器路径。即使 php -v 显示 8.2.8，Composer 可能仍在用旧版本执行。
立即学习“PHP免费学习笔记（深入）”；
- 先运行
which php和which composer，看两者是否都落在~/.phpenv/shims/下；如果不是，说明 Composer 是独立安装的二进制（如通过curl -sS https://getcomposer.org/installer），它不随 phpenv 切换 - 推荐用
phpenv which php查真实路径，再用该路径显式调用：$(phpenv which php) /path/to/composer.phar install - 更彻底的解法：卸载全局 Composer，改用
curl -sS https://getcomposer.org/installer | php在项目内生成composer.phar，然后始终用php composer.phar install - 注意：PHP 8.2+ 默认禁用
ext-zip，而 Composer 依赖它；安装 PHP 时加--with-zip参数，或装完后手动启用扩展
phpenv rehash 和 phpenv which php 这两个动作 —— 它们不显眼，但一旦跳过，整个切换链就断在 shim 层，后面所有操作都像在调试幻觉。 
