phpEnv开启MySQLi扩展及数据库连接教程

本文详细讲解了在phpEnv多版本PHP环境管理工具中启用MySQLi扩展并成功连接MySQL数据库的完整流程，涵盖如何准确找到对应PHP版本的php.ini路径、正确配置extension=mysqli（注意TS版DLL文件存在性与extension_dir指向）、启动phpEnv内置MySQL服务、排查常见连接错误（如Connection refused或Access denied），以及强调CLI与Web环境配置差异、必须通过phpinfo()验证而非php -m等易错细节，帮助开发者避开默认不启用扩展、改错配置文件、忘记重启服务等高频陷阱，快速实现稳定可靠的PHP+MySQL开发环境搭建。

phpEnv 默认不启用 MySQLi 扩展，必须手动修改 php.ini 并重启服务才能使用 mysqli_connect() 等函数；否则会报错 Call to undefined function mysqli_connect()。

确认 phpEnv 当前 PHP 版本和 php.ini 路径

phpEnv 是多版本 PHP 环境管理工具，不同 PHP 版本对应独立的 php.ini 文件，不能改错路径：

• 打开终端，执行 phpenv version 查看当前激活的 PHP 版本（如 8.1.28）
• 执行 php --ini，输出类似：
  Loaded Configuration File: C:\phpenv\versions\8.1.28\etc\php.ini
• 该路径下的 php.ini 才是你要编辑的配置文件

启用 MySQLi 扩展（Windows 下常见操作）

phpEnv 在 Windows 上默认分发的是线程安全（TS）版 PHP，扩展名带 ts 后缀，且需确保 DLL 文件存在：

• 检查 C:\phpenv\versions\8.1.28\ext\ 目录下是否存在 php_mysqli.dll（不是 php_mysql.dll，后者已废弃）
• 用文本编辑器打开 php.ini，搜索 ;extension=mysqli
• 去掉前面的分号，改为：extension=mysqli（PHP 7.4+ 可省略 .dll 后缀；若报错可试 extension=php_mysqli.dll）
• 确保 extension_dir 指向正确：extension_dir = "C:\phpenv\versions\8.1.28\ext"
• 保存后，**必须重启 phpEnv 服务或 Web 服务器（如 Apache/Nginx）**，仅重启 PHP 进程无效

验证 MySQLi 是否生效及连接测试

启用后不等于能连上数据库——phpEnv 自带的 MySQL 服务默认未启动，且连接参数易错：

• 运行 phpenv mysql start 启动内置 MySQL（若未安装，先 phpenv install mysql）
• 默认账号为 root，密码为空，端口通常是 3306，但部分版本可能用 3307（查 phpenv mysql status 输出）
• 写个最小测试脚本：

  <?php
  $mysqli = mysqli_connect('127.0.0.1', 'root', '', 'test', 3306);
  if (!$mysqli) {
      die('Connect Error: ' . mysqli_connect_error());
  }
  echo 'MySQLi OK, version: ' . mysqli_get_server_info($mysqli);
  ?>

• 若提示 Connection refused，说明 MySQL 服务没起来；若提示 Access denied，检查用户名/密码/权限，phpEnv 的 root 默认无密码，但某些版本初始化后会设随机密码（见 %USERPROFILE%\.phpenv\mysql\8.0.x\error.log）

phpEnv 核心配置文件位置与影响范围

phpEnv 的行为由多个配置文件控制，改错地方会导致扩展启用无效或服务无法启动：

• %USERPROFILE%\.phpenv\version：记录当前全局 PHP 版本，修改后需 phpenv rehash
• %USERPROFILE%\.phpenv\versions\{ver}\etc\php.ini：该版本 PHP 唯一生效的主配置，extension=mysqli 必须写在这里
• %USERPROFILE%\.phpenv\mysql\{ver}\my.ini：MySQL 配置，若修改了 port 或 bind-address，PHP 连接时必须同步调整
• 注意：phpEnv 不读取系统级 php.ini（如 C:\Windows\php.ini），改那里完全无效

最容易被忽略的是：改完 php.ini 后忘记重启 MySQL 服务，或误以为 php -m | findstr mysqli 能反映 Web 环境状态——CLI 和 Web SAPI 加载的配置可能不同，务必用 phpinfo() 页面验证 mysqli 是否出现在“Registered PHP Streams”或扩展列表中。

今天关于《phpEnv开启MySQLi扩展及数据库连接教程》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于phpenv的内容请关注golang学习网公众号！