mysqli_connect()连接失败主因非PHP版本(如虚构的8.5.5),而是主机地址配置、MySQL监听设置、用户权限、防火墙拦截及端口未显式指定;需用mysqli_set_charset($conn, 'utf8mb4')防乱码,并优先通过telnet和SQL命令排查网络与权限问题。

mysqli_connect() 连接指定主机时常见失败原因
PHP 8.5.5 并不存在——目前(截至 2024 年)PHP 最高稳定版是 8.3.x,8.4.0 已发布 RC 版,但官方从未发布过 8.5.5。如果你看到这个版本号,大概率是误读、拼写错误,或是某定制编译包的非标命名。实际操作请以你 php -v 输出的真实版本为准,不影响 mysqli 的用法逻辑。
连接指定主机数据库失败,90% 情况不是 PHP 版本问题,而是以下几点没对齐:
-
mysqli_connect()第一个参数填的是 IP 或域名,不是localhost(它会走 Unix socket,绕过 TCP) - 目标 MySQL 服务必须监听
0.0.0.0:3306(或对应端口),而非仅127.0.0.1 - MySQL 用户权限未授权从该主机(如
'user'@'192.168.1.100')连接,'user'@'%'才支持任意远程 IP - 防火墙(服务器端或中间网络设备)拦截了 3306 端口
用 mysqli_connect() 连远程主机的最小可行代码
不依赖配置文件、不封装类,直接调用函数验证连通性:
<?php
$host = '192.168.1.50'; // 或域名,如 db.example.com
$username = 'myuser';
$password = 'mypass';
$database = 'mydb';
$port = 3306; // 可省略,默认 3306
$conn = mysqli_connect($host, $username, $password, $database, $port);
if (!$conn) {
die('连接失败:' . mysqli_connect_error());
}
echo '已连接到 ' . mysqli_get_host_info($conn);
?>
注意:mysqli_connect() 第 5 个参数 $port 必须显式传入才能覆盖默认值;如果 MySQL 在非标端口(如 3307),漏掉它就会连错。
立即学习“PHP免费学习笔记(深入)”;
mysqli_real_connect() 更适合需要 SSL 或超时控制的场景
当你需要启用 TLS、设置连接超时、或复用已创建的连接资源时,mysqli_real_connect() 是更底层且可控的选择:
<?php
$mysqli = mysqli_init();
if (!$mysqli) {
die('mysqli_init 失败');
}
// 设置选项(必须在 real_connect 前)
mysqli_options($mysqli, MYSQLI_OPT_CONNECT_TIMEOUT, 5);
mysqli_options($mysqli, MYSQLI_OPT_READ_TIMEOUT, 10);
mysqli_options($mysqli, MYSQLI_OPT_SSL_VERIFY_SERVER_CERT, false);
// 启用 SSL(若服务端支持)
mysqli_ssl_set($mysqli, null, null, null, null, 'TLSv1.2');
if (!mysqli_real_connect($mysqli, 'db.example.com', 'user', 'pass', 'db', 3306)) {
die('real_connect 失败:' . mysqli_error($mysqli));
}
?>
关键点:
-
mysqli_init()创建空连接对象,后续才配置和连接 -
mysqli_options()必须在mysqli_real_connect()之前调用,顺序错了无效 -
mysqli_ssl_set()的第 5 个参数指定 TLS 协议版本,MySQL 8.0+ 默认要求TLSv1.2或更高
连接后立刻检查字符集,否则中文可能乱码
即使连接成功,如果没设字符集,INSERT 中文可能存成 ????,查询也返回乱码。这不是编码转换问题,而是连接层协议协商缺失:
- 用
mysqli_set_charset($conn, 'utf8mb4')(推荐)——它发送SET NAMES utf8mb4并影响后续所有查询 - 不要只改
my.cnf里的default-character-set,客户端连接时不声明,照样无效 -
utf8mb4是 MySQL 对完整 Unicode(含 emoji)的支持方案,utf8是阉割版,别再用
建议把字符集设置紧接在连接语句之后:
$conn = mysqli_connect('10.0.2.10', 'app', 'pwd', 'shop');
if ($conn) {
mysqli_set_charset($conn, 'utf8mb4'); // 这行不能少
}
真实环境里,主机名解析失败、DNS 缓存、SELinux 限制、MySQL 的 skip-networking 开关,都比函数调用本身更容易卡住。先 telnet 192.168.1.50 3306 确认端口通,再查 MySQL 的 SHOW VARIABLES LIKE 'bind_address'; 和 SELECT host FROM mysql.user WHERE user='youruser';,比反复改 PHP 代码快得多。



















