mysqli_connect()连接失败主因是服务、网络或权限问题,需先用mysql命令行验证;pdo须在dsn中指定charset=utf8mb4并启用pdo::errmode_exception;预处理时mysqli需显式类型绑定且传引用,pdo支持命名占位符并自动推断类型;两者均无自动重连,超时需手动配置。

mysqli_connect() 连接失败的常见报错和直连检查
直接用 mysqli_connect() 失败,八成不是代码写错,而是底层连接条件没满足。先确认 MySQL 服务在运行、端口(默认 3306)没被防火墙拦、用户有远程/本地访问权限。
典型错误如:Connection refused → 检查 MySQL 是否启动;Access denied for user → 看用户是否用 localhost 还是 127.0.0.1(Unix socket 和 TCP 行为不同);Unknown MySQL server host → DNS 或 hosts 配置问题。
最简验证方式:
mysql -h 127.0.0.1 -P 3306 -u testuser -p
能进命令行,说明服务、网络、账号都通——再回 PHP 查代码。
-
mysqli_connect()第一个参数别写空字符串,用'127.0.0.1'明确走 TCP,避免 Unix socket 权限干扰 - 密码为空时传
null或空字符串均可,但不要省略参数位 - 连接后立刻用
mysqli_connect_error()检查,别等执行 SQL 才发现连不上
PDO 构造时如何正确设置 charset 和错误模式
PDO 默认不设字符集,即使数据库是 utf8mb4,PHP 插入中文也可能变 ???。关键在 DSN 后加 ;charset=utf8mb4,且必须配合 PDO::ATTR_ERRMODE 启用异常抛出,否则 SQL 错误静默失败。
错误写法:$pdo = new PDO("mysql:host=localhost;dbname=test", $u, $p); —— 缺少 charset,也没开错误捕获。
推荐初始化:
$dsn = "mysql:host=localhost;dbname=test;charset=utf8mb4";
$options = [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
];
$pdo = new PDO($dsn, $username, $password, $options);
- DSN 中的
charset是必需项,不能靠后续exec("SET NAMES ...")补救(有竞态风险) -
PDO::ERRMODE_EXCEPTION让所有错误变成可捕获的PDOException,比手动检查errorCode()更可靠 - 如果用长连接,加上
PDO::ATTR_PERSISTENT => true,但注意它会复用连接状态(比如事务未提交、临时表残留)
mysqli 和 PDO 在预处理语句上的关键差异
两者都支持预处理防注入,但绑定变量的方式和类型推断逻辑不同,容易在迁移或混用时出错。
mysqli 要求显式声明参数类型(i/s/d/b),且 bind_param() 必须传变量引用(&$var);PDO 可用命名占位符(:name)或问号,并自动推断类型(除非强制用 PDO::PARAM_INT 等)。
例如插入一条带整数和字符串的记录:
// mysqli 写法(注意 & 引用和类型字母)
$stmt = $mysqli->prepare("INSERT INTO users(name, age) VALUES(?, ?)");
$stmt->bind_param("si", $name, $age);
$name = "张三"; $age = 25;
$stmt->execute();
// PDO 写法(更宽松)
$stmt = $pdo->prepare("INSERT INTO users(name, age) VALUES(:name, :age)");
$stmt->execute(['name' => "张三", 'age' => 25]);
- mysqli 的
bind_param()类型字符串长度必须和参数个数一致,多一个少一个都会警告或静默失败 - PDO 的
execute()接收数组时,键名必须和命名占位符完全匹配(区分大小写) - 两者都不建议把用户输入拼进 SQL 字符串里——哪怕只是表名或排序字段,要用白名单校验代替
连接超时与重连机制不能依赖扩展自带行为
PHP 的 mysqli 和 PDO 都不会自动重连断开的连接。所谓“连接池”是 MySQL Server 层概念,PHP 进程每次请求都是新连接(除非用持久连接 + Web 服务器复用进程)。
超时控制分散在多个地方:MySQL 服务端有 wait_timeout(默认 28800 秒),PHP 有 mysqli_options($link, MYSQLI_OPT_CONNECT_TIMEOUT, 5) 控制建立连接阶段,但执行查询的超时得靠 mysqli_options($link, MYSQLI_OPT_READ_TIMEOUT, 10) 和 MYSQLI_OPT_WRITE_TIMEOUT 单独设。
- PDO 没有内置读写超时设置,只能靠 MySQL 服务端配置或在 DSN 加
connect_timeout=5;read_timeout=10 - 持久连接(
mysql:...;persistant=true或mysqli::OPT_PERSISTENT)在 CLI 下无效,在 Apache mod_php 下可能引发连接状态污染 - 真正健壮的做法:封装一个带重试的查询函数,捕获
mysqli_connect_errno() === 2006(MySQL server has gone away)后重新 connect + prepare
字符集、错误模式、预处理绑定、连接生命周期——这四点没对齐,再短的代码也容易在线上突然失效。尤其注意本地开发用 localhost,上线改成了域名或内网 IP,socket 路径和 DNS 解析行为就全变了。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











