phpEnv安装PHP8.x教程 phpEnv多版本快速切换技巧-php教程-PHP中文网

phpenv install 8.x 失败主因是缺构建依赖、网络问题或 autoconf 版本过低；global/local/shell 切换逻辑不同，需配合 rehash 和 which 确认生效；Composer 需绑定 phpenv 的 PHP 路径。

phpenv安装php8.x教程 phpenv多版本快速切换技巧

直接运行 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

两者都改 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 设置仍会压倒它

这不是 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 符号链接，没它，新装的版本根本不会被调用

Composer 本身是 PHP 脚本，但它默认绑定的是启动时解析出的 PHP 解释器路径。即使 php -v 显示 8.2.8，Composer 可能仍在用旧版本执行。

先运行 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 参数，或装完后手动启用扩展