phpenv 本身不提供 PHP 5.6 预编译包，必须通过 php-build 插件从源码编译安装；需先安装插件、依赖及兼容性环境变量，再执行 phpenv install 5.6.40（唯一支持新系统的可行方式）。
phpenv 本身不直接提供 PHP 5.6 的预编译二进制包，但能通过 php-build 插件从源码编译安装 —— 这是目前在现代系统（如 Ubuntu 22.04+/macOS Sonoma+）上可靠运行 PHP 5.6 的唯一可行方式。
phpenv install 5.6.40 失败？先装 php-build 插件
默认的 phpenv 不带构建能力，phpenv install 命令依赖 php-build 插件。没装它时执行 phpenv install 5.6.40 会报错：command not found: phpenv-install 或直接卡在“no build definition found”。
- 运行
git clone https://github.com/php-build/php-build $(phpenv root)/plugins/php-build安装插件 - 确保已安装编译依赖：Ubuntu 上跑
sudo apt install -y build-essential libxml2-dev libssl-dev libcurl4-openssl-dev libjpeg-dev libpng-dev libfreetype6-dev autoconf pkg-config；macOS 用brew install autoconf automake openssl@1.1 libxml2 libpng jpeg freetype - PHP 5.6 已停止维护，部分新版 OpenSSL/ICU 会导致 configure 失败，建议加环境变量降级兼容：
export PHP_BUILD_CONFIGURE_OPTS="--with-openssl=/usr/lib/x86_64-linux-gnu --enable-opcache=no"（Ubuntu 路径需核对，可用find /usr -name openssl.pc确认）
编译安装 php 5.6.40 的实操要点
PHP 5.6 最后一个安全版本是 5.6.40（2019 年发布），必须用这个号，别试 5.6.0 或 5.6.30 —— 它们在新内核或 GCC 12+ 下大概率编译失败。
- 执行
phpenv install 5.6.40，全程约 8–15 分钟，期间不要中断终端 - 若中途报
error: ‘SSLv3_method’ undeclared，说明 OpenSSL 版本太高，需加--without-openssl（但会禁用 cURL/HTTPS，仅限离线调试） - 成功后运行
phpenv global 5.6.40，再执行php -v应输出PHP 5.6.40；若仍显示其他版本，运行phpenv rehash刷新 shim - 验证扩展是否就位：
php -m | grep -E 'mysql|mysqli|mcrypt'—— 注意：PHP 5.6 默认不带mcrypt，需手动编译启用（见下一条）
老旧项目常依赖的扩展怎么启用
很多 PHP 5.6 项目硬编码调用 mysql_connect() 或 mcrypt_encrypt()，而这些扩展在默认编译中已被移除或禁用。
立即学习“PHP免费学习笔记（深入）”；
-
mysql扩展：PHP 5.6 编译时默认不启用，且自 PHP 7.0 起彻底废弃。你**不能也不该**在 5.6 中重新启用它 —— 正确做法是用mysqli或PDO替换代码，或临时打补丁（风险极高） -
mcrypt：需额外下载源码并链接编译。先apt install libmcrypt-dev（Ubuntu）或brew install mcrypt（macOS），再设置export PHP_BUILD_CONFIGURE_OPTS="--with-mcrypt"，然后重装5.6.40 -
intl、gd等常见扩展：确保系统已装对应 dev 包（如libicu-dev、libfreetype6-dev），它们会在 configure 阶段自动检测并启用
项目级配置和容易忽略的坑
即使 PHP 5.6.40 装好了，旧项目仍可能报 Fatal error: Call to undefined function mysql_connect() 或 date.timezone not set —— 这些不是版本问题，而是运行时环境缺失。
- 在项目根目录创建
.php-version文件，内容仅一行：5.6.40，避免全局污染其他项目 - PHP 5.6 默认关闭
display_errors且error_reporting设为E_ALL & ~E_NOTICE & ~E_STRICT，老旧项目常靠ini_set('display_errors', 1)触发，务必检查php.ini路径：phpenv which php查二进制位置，再找同级etc/php.ini - 关键陷阱：
phpenv管理的是 CLI 模式下的 PHP，但 Web 服务器（Apache/Nginx）用的是自己加载的模块或 CGI。若你在浏览器访问出错，跟 phpenv 无关 —— 必须单独配置 Web 服务器指向~/.phpenv/versions/5.6.40/bin/php-cgi或使用php-fpm（需手动启停）
真正麻烦的从来不是装上 PHP 5.6，而是让它的扩展、时区、错误级别、Web 服务绑定全部对齐 —— 每个环节都可能静默失败。建议先用 php -S 启动内置服务器验证 CLI 环境，再动 Web 服务器配置。
