李涛自留地
回到顶部
首页 > php学习 > php如何连接mysql?两种扩展写法与连接失败排查

php如何连接mysql?两种扩展写法与连接失败排查

文章目录

手上这台跑业务的老机器是 CentOS 7,PHP 7.4,另有一台 8.2 的测试机做对照;数据库只有一台 MySQL 8.0,3306 只对内网开放。这两个版本都已停更,新项目直接上 8.2 以上,这里只说兼容写法。在这个代码库里,php如何连接mysql从来没有统一答案——十几个文件里 mysqli 和 PDO 各占一半,还有两个文件留着 mysql_ 开头的老函数,一调就是 Fatal error,属于待删的死代码,整套代码是从 PHP 5 时代一路改过来的。三种写法、三套错误处理,字符集和超时各写各的。要收口,先把两条能用的路径走通,再谈排查。

第一步:先选扩展,再确认开没开

两条路都能连上,差别在接口层。mysqli 是 MySQL 专用扩展,过程和面向对象两套写法都行;PDO 是数据库抽象层,MySQL 只是它的一个驱动 pdo_mysql。手上只有 MySQL 一种库,mysqli 改动最小;后面可能换库,或者想让错误统一走异常,PDO 的边界更清楚。

两个扩展汇入 mysqlnd 再连数据库的结构图

这次要改的是新写的那批接口文件,统一换成 PDO:同一份代码在 CLI 脚本和 FPM 里都要跑,异常比返回值好统一处理,换库也只改 DSN。后台那几个导出脚本继续用 mysqli,函数式写法改动量小,回归只要跑一遍导出的行数对不对。老文件里还有 mysqli_connect 这种过程写法,出错返回 false,错误码得去 mysqli_connect_errno() 取,和面向对象的异常路径不是一套。

确认扩展只花一条命令:php -m | grep -i mysql。输出里要有 mysqli 和 pdo_mysql 两行,只有 pdo_mysql 说明 mysqli 没编进去。Debian 系补 php7.4-mysql 这个包,RHEL 系补 php-mysqlnd,装完重启 php-fpm。

CLI 里通了、网页上还是 Call to undefined function mysqli_connect(),是 CLI 和 FPM 读了两份不同的 php.ini。php --ini 看 CLI 读哪一份,再去 FPM 池配置里确认路径,然后在对应文件里搜 ;extension=mysqli 和 ;extension=pdo_mysql,删掉行首的分号。行号每个发行版都不一样,照抄别人的行号,改错文件是常事。这一步做完,php如何连接mysql的第一道门才算开。

第二步:mysqli扩展的连接写法

先看 mysqli。它没有 DSN 这一层,php如何连接mysql要用的地址、账号、密码、库名直接进构造函数,端口放第五个。host 写 127.0.0.1,不用 localhost 去赌 socket 路径。下面这段 7.4 和 8.2 都能跑,密码换成自己的。

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);

$mysqli = new mysqli('127.0.0.1', 'app', 'YOUR_PASSWORD', 'shop', 3306);
$mysqli->set_charset('utf8mb4');

$id = 1;
$stmt = $mysqli->prepare('SELECT id, name FROM goods WHERE id = ?');
$stmt->bind_param('i', $id);
$stmt->execute();

$res = $stmt->get_result();
while ($row = $res->fetch_assoc()) {
    echo $row['name'], PHP_EOL;
}

mysqli_report() 这一行是给 7.4 补的。8.1 起 mysqli 默认就抛 mysqli_sql_exception,7.4 上不写,new mysqli() 失败只返回 false 加一条 warning,老代码里除了 if (!$link) 之外的分支都接不住。补上这行,两个版本的错误路径才一致。

set_charset('utf8mb4') 不能换成 query('SET NAMES utf8mb4')。前者会同时改掉 real_escape_string 用的字符集,后者只改服务端会话变量,转义和实际编码对不上,拼接 SQL 时会出现半截乱码。

get_result() 依赖 mysqlnd。发行版把 mysqli 编到 libmysqlclient 上的话,这个方法不存在,只能退回 bind_result() 加 fetch(),php -i | grep mysqlnd 有输出才是 mysqlnd。

mysqli 也能设连接超时,只是不能在 new 的时候传。得先 mysqli_init(),再 mysqli_options($link, MYSQLI_OPT_CONNECT_TIMEOUT, 3),最后 real_connect();顺序反了,参数不生效,照样按默认值等下去。

构造函数的第六个参数是 socket 路径,不传或者传 null 就走 php.ini 里的默认值。容器化部署时这个默认值经常指向一个不存在的文件,host 写 localhost 报 2002,原因就在这儿。

prepare 那一步要盯返回值。没开 strict 时 prepare() 失败返回 false,错误在 $mysqli->error 上,不在 $stmt 上。判断写成 if ($stmt === false) 再取错误文本,比等后面 bind_param() 报 call on bool 好定位。

第三步:PDO扩展的连接写法

PDO 用 DSN 传参,host、端口、库名、字符集一行写完,php如何连接mysql要给的几项都在这一条字符串里。charset 放在 DSN 里,pdo_mysql 握手时就把字符集设好,省掉连上之后再执行一次 SET NAMES。

<?php
$dsn = 'mysql:host=127.0.0.1;port=3306;dbname=shop;charset=utf8mb4';
$pdo = new PDO($dsn, 'app', 'YOUR_PASSWORD', [
    PDO::ATTR_ERRMODE            => PDO::ERRMODE_EXCEPTION,
    PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
    PDO::ATTR_EMULATE_PREPARES   => false,
    PDO::ATTR_TIMEOUT            => 3,
]);

$id = 1;
$stmt = $pdo->prepare('SELECT id, name FROM goods WHERE id = ?');
$stmt->execute([$id]);

foreach ($stmt as $row) {
    echo $row['name'], PHP_EOL;
}

四个参数各有原因。ERRMODE_EXCEPTION 让失败变成 PDOException,catch 一处就兜住;EMULATE_PREPARES 设 false,预处理交给 MySQL 做,占位符不会在客户端拼成字符串;ATTR_TIMEOUT 给 3 秒,不设就走 php.ini 的 default_socket_timeout,默认 60 秒,对端不回包时页面会一直挂着。

长连接要谨慎。ATTR_PERSISTENT 在 FPM 下跨请求复用同一条连接,上一个请求没提交的事务会挂到下一个请求身上,除非确认事务都包在 try/finally 里,否则别开。

超时报 SQLSTATE[HY000] [2002] Connection timed out,端口没开报 Connection refused。前者是包发出去没人应,后者是对方明确拒了。日志里这两条要分开看:一个查网络和防火墙,一个查服务起没起、是不是只监听了回环。

第四步:连接失败先读错误码

错误文本会骗人,括号里的错误码不会。连不上时,php如何连接mysql的答案就落在错误码上,后面那串英文只是注释。2002 是连不上服务端,1045 是账号密码,1049 是库名不对,1366 是字符集,这四条覆盖了大多数情况。

连接失败按四个错误码分流的排查流程

2002 又分两种。服务没起是 Connection refused;socket 路径不对是 No such file or directory,完整一行是 mysqli::__construct(): (HY000/2002): No such file or directory。第二种只在 host 写 localhost 时出现,mysqlnd 会去找编译时定死的 socket,MySQL 跑在容器里的话,宿主机上根本没有那个文件。把 host 改成 127.0.0.1 强制走 TCP,或者去改 mysqli.default_socket 和 pdo_mysql.default_socket。

1045 那行末尾带 using password: YES 或 NO。NO 说明密码没送到,参数顺序写错、密码取的环境变量是空串都会这样;YES 才是密码本身不对。这两个方向要改的东西完全不同。

左边走 socket、右边走 TCP 的对照图

MySQL 8 默认认证插件是 caching_sha2_password。客户端库太老会在握手阶段就断,报 SQLSTATE[HY000] [2054] The server requested authentication method unknown to the client,要么改这个用户的认证插件,要么换新版客户端库。

连接字符集和表对不上,中文会变成 ???? 或者 䏿–‡,看是哪一端先转了一次;四字节字符写进三字节的 utf8 列,直接报 1366,信息是 Incorrect string value。

线上先看 error_log 里的错误码前缀,两种扩展长得不一样:mysqli 是 mysqli::__construct(): (HY000/2002),PDO 是 PDOException: SQLSTATE[HY000] [2002],比的都是括号里的那段数字,比后面那串英文描述好认。FPM 的错误进 php-fpm 的 error_log,不在 nginx 的 access.log 里。

三条命令验一遍

改完不算完,三条都过才算接上。

第一条查扩展,后两条各开一次真实连接:一条只验证能不能连上并执行语句,一条把会话字符集打出来。哪条报错,就按上面的错误码往下分。

  • php -m | grep -i mysql 输出里 mysqli 和 pdo_mysql 都在。
  • php -r "var_dump((new PDO('mysql:host=127.0.0.1;dbname=shop;charset=utf8mb4','app','YOUR_PASSWORD'))->query('SELECT 1'));" 打印出 PDOStatement 对象,不是 false。
  • php -r "echo (new PDO('mysql:host=127.0.0.1;dbname=shop;charset=utf8mb4','app','YOUR_PASSWORD'))->query('SELECT @@character_set_client')->fetchColumn();" 输出 utf8mb4。

三条对上,说明扩展、TCP、字符集都没问题,往下就只剩 SQL 和权限。

若非作者标注皆为李涛自留地原创文章,转载或复制请以超链接形式并注明出处。