php怎么连接mysql数据库_mysqli与pdo连接方法【指南】

星夢妙者

星夢妙者

2026-04-06

142人浏览

原创

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

php怎么连接mysql数据库_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,也没开错误捕获。

推荐初始化:

PHP 8.5.5
PHP 8.5.5

PHP 8.5.5 是 PHP 8.5 分支的维护更新版本。该版本延续了“小步快跑”的迭代逻辑,通过深度错误修复、底层性能微调以及安全加固,旨在为开发者提供一个更健壮、更高效的运行环境。该版本严格遵守语义化版本规范,不包含破坏性变更。

下载
$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=truemysqli::OPT_PERSISTENT)在 CLI 下无效,在 Apache mod_php 下可能引发连接状态污染
  • 真正健壮的做法:封装一个带重试的查询函数,捕获 mysqli_connect_errno() === 2006(MySQL server has gone away)后重新 connect + prepare

字符集、错误模式、预处理绑定、连接生命周期——这四点没对齐,再短的代码也容易在线上突然失效。尤其注意本地开发用 localhost,上线改成了域名或内网 IP,socket 路径和 DNS 解析行为就全变了。

php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!

相关专题

更多
php文件怎么打开
php文件怎么打开

打开php文件步骤:1、选择文本编辑器;2、在选择的文本编辑器中,创建一个新的文件,并将其保存为.php文件;3、在创建的PHP文件中,编写PHP代码;4、要在本地计算机上运行PHP文件,需要设置一个服务器环境;5、安装服务器环境后,需要将PHP文件放入服务器目录中;6、一旦将PHP文件放入服务器目录中,就可以通过浏览器来运行它。

2023.09.01

5504

6

php怎么取出数组的前几个元素
php怎么取出数组的前几个元素

取出php数组的前几个元素的方法有使用array_slice()函数、使用array_splice()函数、使用循环遍历、使用array_slice()函数和array_values()函数等。本专题为大家提供php数组相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

3610

5

php反序列化失败怎么办
php反序列化失败怎么办

php反序列化失败的解决办法检查序列化数据。检查类定义、检查错误日志、更新PHP版本和应用安全措施等。本专题为大家提供php反序列化相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.11

1786

5

php怎么连接mssql数据库
php怎么连接mssql数据库

连接方法:1、通过mssql_系列函数;2、通过sqlsrv_系列函数;3、通过odbc方式连接;4、通过PDO方式;5、通过COM方式连接。想了解php怎么连接mssql数据库的详细内容,可以访问下面的文章。

2023.10.23

2293

4

php连接mssql数据库的方法
php连接mssql数据库的方法

php连接mssql数据库的方法有使用PHP的MSSQL扩展、使用PDO等。想了解更多php连接mssql数据库相关内容,可以阅读本专题下面的文章。

2023.10.23

2810

6

html怎么上传
html怎么上传

html通过使用HTML表单、JavaScript和PHP上传。更多关于html的问题详细请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.03

2019

9

PHP出现乱码怎么解决
PHP出现乱码怎么解决

PHP出现乱码可以通过修改PHP文件头部的字符编码设置、检查PHP文件的编码格式、检查数据库连接设置和检查HTML页面的字符编码设置来解决。更多关于php乱码的问题详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.09

3053

8

php文件怎么在手机上打开
php文件怎么在手机上打开

php文件在手机上打开需要在手机上搭建一个能够运行php的服务器环境,并将php文件上传到服务器上。再在手机上的浏览器中输入服务器的IP地址或域名,加上php文件的路径,即可打开php文件并查看其内容。更多关于php相关问题,详情请看本专题下面的文章。php中文网欢迎大家前来学习。

2023.11.13

2337

8

sprintf函数用法详解
sprintf函数用法详解

sprintf函数的用法:1、格式化字符串;2、指定输出宽度和精度;3、返回值。更多关于sprintf函数用法详解的内容,大家可以阅读下面的文章。

2023.11.27

10931

4

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
墨刀帮助中心
墨刀帮助中心

共0课时 | 0人学习

MyEclipse学习中心
MyEclipse学习中心

共0课时 | 0人学习

Apache Subversion 官方手册
Apache Subversion 官方手册

共0课时 | 0人学习