phpEnv连接本地数据库失败的解决办法 phpEnv数据库连接报错排查-php教程-PHP中文网

mysqli_connect()返回false时必须立即调用mysqli_connect_error()获取具体错误信息，否则无法定位connection refused、access denied或unknown host等失败原因。

phpenv连接本地数据库失败的解决办法 phpenv数据库连接报错排查

mysqli_connect() 返回 false 时必须立刻查 `mysqli_connect_error()`

PHP 脚本里只写 mysqli_connect() 却不检查返回值，是本地连接失败却看不到原因的最常见操作。它失败时返回 false，但错误细节全藏在 mysqli_connect_error() 里。

直接加这三行就能定位问题：

$conn = mysqli_connect($host, $user, $pass, $db, $port);
if (!$conn) {
    echo "连接失败：" . mysqli_connect_error(); // 必须有这一句
    exit;
}

常见输出包括：

Connection refused → 数据库服务没起来，或端口不对
Access denied for user 'xxx'@'localhost' → 用户名密码错，或用户 host 不匹配（比如你用 'localhost' 连，但 MySQL 里只有 'xxx'@'127.0.0.1'）
Unknown MySQL server host 'xxx' → 主机名拼错，或 DNS 解析失败（本地开发慎用域名，优先试 'localhost'）

phpEnv 默认不启用 `mysqli` 扩展，需手动开启

phpEnv 是 Windows 下的便携式 PHP 环境，它的 php.ini 通常默认禁用数据库扩展。报错 Class "mysqli" not found 或 Call to undefined function mysqli_connect() 就是这个原因。

操作步骤：

找到 phpEnv 对应版本的 php.ini（一般在 phpenv\versions\{version}\conf\php.ini）
搜索 ;extension=mysqli，去掉前面的分号，改为 extension=mysqli
同样检查 ;extension=openssl 和 ;extension=pdo_mysql 是否已启用（PDO 连接也需要）
重启 phpEnv 的 Apache/Nginx 服务（不是仅刷新页面）

改完后运行 php -m | findstr mysqli（Windows 命令行），确认输出含 mysqli。

btpanel phpsite 宝塔面板PHP网站

宝塔面板 PHP 网站管理：站点创建、删除、启停、PHP 版本切换、域名管理、SSL证书管理、伪静态管理、数据库管理

下载

本地连接用 `'localhost'`，别用 `'127.0.0.1'`

phpEnv 下 MySQL 默认监听 socket 文件而非 TCP 端口，此时用 '127.0.0.1' 会强制走 TCP，而 MySQL 可能没开网络监听，导致 Connection refused。

正确做法：

连接参数中 host 写 'localhost'（触发 Unix socket 连接）
如果非要用 IP，先确认 MySQL 配置：打开 my.ini 或 my.cnf，检查是否有 bind-address = 127.0.0.1；若注释掉或改为 0.0.0.0，再配合 port=3306 才能稳定走 TCP
命令行验证：mysql -u root -p -h localhost 能进，但 -h 127.0.0.1 报错，就坐实是 socket/TCP 切换问题

用户权限只认 `'root'@'localhost'`，不是 `'root'@'%'`

phpEnv 自带的 MySQL 初始化用户常只授权了 'root'@'localhost'。如果你在代码里连的是 '127.0.0.1'，MySQL 会按 'root'@'127.0.0.1' 匹配权限——而该记录往往不存在。

SELECT User, Host FROM mysql.user WHERE User = 'root';
-- 若只看到 'root'@'localhost'，就补一条：
CREATE USER 'root'@'127.0.0.1' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON *.* TO 'root'@'127.0.0.1' WITH GRANT OPTION;
FLUSH PRIVILEGES;

更稳妥的做法是统一用 'localhost' 作为 host，并确保用户存在且密码正确——别依赖 '%'，它在本地环境下反而容易因解析顺序失效。

真正卡住人的地方，往往不是配置多复杂，而是错误信息没打出来、扩展没开、host 字符串看着一样其实语义不同。每一步都得靠实际输出验证，不能靠“应该可以”。