phpEnv安装多版本数据库教程

phpEnv 仅用于管理多版本 PHP 解释器，完全不涉及 MySQL、PostgreSQL 等数据库服务的安装与切换；真正需要关注的是：不同 PHP 版本下数据库扩展（如 pdo_mysql、mysqli、pgsql）是否已正确编译、启用且 ABI 兼容——切换 PHP 后连接失败往往不是数据库没装好，而是对应扩展缺失或配置错误；若需本地并行运行多个数据库版本（如 MySQL 5.7 和 8.0），推荐使用 Docker 容器方案，既与 phpenv 解耦，又干净可靠。

phpenv 不管理数据库，它只管理 PHP 二进制版本。你不能用 phpenv 安装 MySQL、PostgreSQL 或 SQLite —— 那些是独立的数据库服务，和 PHP 版本无关。

如果你看到“phpEnv 多版本数据库”这种说法，基本是混淆了概念，或是误把 PHP 扩展（如 pdo_mysql、pgsql）当成了数据库本身。

为什么 phpenv install 不能装 MySQL 或 Redis？

phpenv install 调用的是 php-build 插件，它只编译安装 PHP 解释器及其内置扩展（比如 openssl、zlib）。数据库服务需要单独部署：

• MySQL / MariaDB：通过系统包管理器（apt install mysql-server、brew install mysql）或 Docker 启动
• PostgreSQL：同理，apt install postgresql 或 brew install postgresql
• Redis：apt install redis-server 或 brew install redis
• SQLite：通常已随系统自带，无需额外安装

但 PHP 的数据库扩展可以随版本变化 —— 这才是 phpenv 相关的部分

不同 PHP 版本默认启用的扩展不同，比如：

• PHP 7.4 默认带 mysqlnd 和 pdo_mysql，但不带 pgsql（除非编译时加 --with-pgsql）
• PHP 8.2+ 移除了 ext/mysql（早已废弃），只保留 mysqli 和 PDO 系列
• 某些扩展（如 sqlsrv、pdo_sqlsrv）需手动用 pecl install 安装，且必须匹配当前激活的 PHP 版本

所以真正要关注的是：切换 PHP 版本后，对应扩展是否可用。

验证方式：

php -m | grep -E "(pdo|mysql|pgsql|sqlite)"

如果没输出，说明该扩展未启用 —— 此时你需要：

• 确认扩展是否已编译进当前 PHP（查 php -i | grep configure 中的 --with-xxx 参数）
• 检查 php.ini 是否加载了对应 extension= 行（路径在 php --ini 输出里）
• 若用 pecl 安装，必须先 phpenv shell 8.3.13 再运行 pecl install pdo_sqlsrv，否则会装到错误版本上

常见错误：切换 PHP 后数据库连接失败

典型现象：Class 'PDO' not found 或 Call to undefined function mysqli_connect()。

原因不是数据库没装，而是当前 PHP 版本没启用对应扩展。排查步骤：

• 运行 phpenv version 确认当前生效的是哪个版本
• 运行 php --ini 查看加载的配置文件路径
• 打开那个 php.ini，确认有类似 extension=pdo.so、extension=mysqli.so 的行（Linux/macOS）或 php_pdo.dll（Windows）
• 如果扩展名对但报错“unable to load”，大概率是 PHP 版本和扩展 ABI 不兼容 —— 比如用 PHP 8.2 编译的 pdo_pgsql.so 无法在 PHP 8.3 下运行

想真正在本地跑多版本数据库？用容器更靠谱

如果你确实需要多个 MySQL 版本（比如 MySQL 5.7 和 8.0 并存），phpenv 做不到，但可以用：

• docker run --name mysql57 -e MYSQL_ROOT_PASSWORD=123 -p 3307:3306 -d mysql:5.7
• docker run --name mysql80 -e MYSQL_ROOT_PASSWORD=123 -p 3308:3306 -d mysql:8.0

然后在 PHP 代码里连不同端口即可。这样和 phpenv 切换 PHP 版本完全解耦，也更干净。

真正的难点从来不在“怎么装”，而在于“装完之后扩展是否对得上、配置是否加载成功、ABI 是否兼容”——这些细节不验证，光装一堆版本也没用。

以上就是《phpEnv安装多版本数据库教程》的详细内容，更多关于phpenv的资料请关注golang学习网公众号！