phpEnv 默认不启用 mysqli 扩展,需手动取消 php.ini 中 extension=mysqli(Linux/macOS)或 extension=php_mysqli.dll(Windows)的注释,确认 extension_dir 路径正确,重启 Web 服务或 PHP-FPM 后,通过 php -m、phpinfo() 和测试代码验证生效。

phpEnv 默认不自动启用 mysqli 扩展,必须手动修改配置并重启服务,否则调用 mysqli_connect() 或 new mysqli() 会直接报 Fatal error: Uncaught Error: Class "mysqli" not found 或类似连接函数未定义的错误。
确认 phpEnv 当前使用的 php.ini 路径
phpEnv 管理多个 PHP 版本,每个版本可能有独立的 php.ini。不能只改系统级或默认路径下的配置文件。
- 在命令行运行
php -i | grep "Loaded Configuration File",查看 CLI 模式加载的php.ini - 若通过 Apache/Nginx 访问 Web 页面,需额外创建一个
info.php文件,内容为,在浏览器中打开后搜索 “Loaded Configuration File”,确认 Web 服务器实际读取的是哪个php.ini - 常见路径示例:
C:\phpenv\versions\8.2.12\php.ini(Windows)或/home/user/.phpenv/versions/8.2.12/etc/php.ini(Linux/macOS)
启用 mysqli 扩展的三步操作
phpEnv 下的 mysqli 通常已编译进 PHP,但默认被注释掉,只需取消注释并验证。
解析 MySQL 8.0 的 DDL 脚本,并将表结构导出为 Excel 格式。适用于用户需将 MySQL 的 `CREATE TABLE` 语句转换为结构化的 Excel 文件场景,导出内容包含字段名、数据类型、长度及精度等信息。支持多张表的批量处理,每张表对应 Excel 中的一个独立工作表。适用于数据库文档编写、数据字典生成及模式分析等任务。
- 用文本编辑器打开上一步确认的
php.ini文件 - 搜索
extension=mysqli(Linux/macOS)或extension=php_mysqli.dll(Windows),确保该行**未被分号;注释**,且前面无空格;若看到的是;extension=mysqli,删掉开头的; - 检查
extension_dir是否指向正确目录(如extension_dir = "ext"或绝对路径),该目录下应存在mysqli.so(Linux/macOS)或php_mysqli.dll(Windows) - 保存文件后,**必须重启 phpEnv 对应的 Web 服务或 PHP-FPM 进程**:比如在 Windows 上重启 Apache,或在 Linux/macOS 上执行
phpenv restart(若支持)或手动kill+ 重启 PHP-FPM
验证 mysqli 是否真正生效
仅靠修改配置不等于扩展可用,常见“以为开了实则没开”的情况多发生在 CLI 与 Web 环境配置不一致、或扩展依赖未满足时。
- 命令行验证:
php -m | grep mysqli应输出mysqli;若无,说明 CLI 的php.ini没改对 - Web 验证:访问
info.php页面,搜索 “mysqli”,应看到完整模块信息,包括 client API 版本和 mysqlnd 支持状态 - 写一段最小测试代码:
<?php $conn = @new mysqli('localhost', 'root', '', 'mysql'); if ($conn->connect_error) { die('mysqli 扩展已加载,但连接失败:' . $conn->connect_error); } echo '✅ mysqli 可用且能连通'; ?>—— 若提示类未找到,说明扩展根本没加载;若提示连接拒绝,说明扩展已启用但 MySQL 服务未运行或凭据错
最容易被忽略的是:phpEnv 切换 PHP 版本后,php.ini 不会自动同步修改,每次换版本都得重新检查并启用 mysqli;另外,某些精简版 phpEnv 构建可能默认禁用 mysqlnd,导致即使 mysqli 加载了也无法处理 utf8mb4 字符集或预处理语句,这时需要确认 mysqlnd 是否作为客户端库被编译进当前 PHP 二进制中。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!










