PHP连接MySQL应使用mysqli或PDO,禁用已废弃的mysql_connect();mysqli面向对象写法需传入主机、用户、密码、库名四参数并设utf8mb4字符集;PDO需在DSN中指定charset并启用异常模式。
PHP 连接 MySQL 数据库,优先用 mysqli 或 PDO,别碰已废弃的 mysql_connect() —— 它在 PHP 7.0+ 中彻底消失,强行用会直接报错 Fatal error: Uncaught Error: Call to undefined function mysql_connect()。
这是目前最常用、推荐的连接方式,语法清晰、支持预处理、错误提示明确。
mysqli 扩展(检查 phpinfo() 中是否有 mysqli 模块,或运行 extension=php_mysqli.dll(Windows)/extension=mysqli.so(Linux)是否在 php.ini 中开启)$mysqli->connect_error 或用 @ 抑制警告后判断 $mysqli->connect_errno
$mysqli = new mysqli('localhost', 'root', 'password', 'testdb', 3306);
if ($mysqli->connect_error) {
die('连接失败:' . $mysqli->connect_error);
}
$mysqli->set_charset('utf8
mb4'); // 强烈建议设为 utf8mb4,避免 emoji 和生僻字乱码
PDO 更适合需要切换数据库类型(如从 MySQL 换到 PostgreSQL)或强调统一错误处理的项目。它默认不开启异常模式,这点容易被忽略。
mysql:host=localhost;dbname=testdb;charset=utf8mb4,charset 必须写在 DSN 里才生效,单独调 setCharset 无效PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,否则 SQL 错误只会返回 false,难以调试try {
$pdo = new PDO('mysql:host=localhost;dbname=testdb;charset=utf8mb4', 'root', 'password', [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);
} catch (PDOException $e) {
die('连接失败:' . $e->getMessage());
}
不是代码写错,而是环境或权限问题占八成。先看这些再改代码:
systemctl status mysql(Linux)或检查 Windows 服务列表里的 MySQL80
root@localhost 不能从 PHP(哪怕本机)用 127.0.0.1 连,得建用户 CREATE USER 'webuser'@'127.0.0.1' IDENTIFIED BY 'pwd'; GRANT ALL ON testdb.* TO 'webuser'@'127.0.0.1';
3306 端口未被屏蔽;Mac M1 用户注意 MySQL 是否跑在 Rosetta 模式下导致 socket 路径异常caching_sha2_password 认证插件,老版本 PHP(ALTER USER 'root'@'localhost' IDENTIFIED WITH mysql_native_password BY 'password';很多人连上就查数据,结果中文变问号、特殊符号报错、高并发下连接数爆满——都是因为漏了这几步。
$mysqli->ping() 或 $pdo->getAttribute(PDO::ATTR_CONNECTION_STATUS) 主动验证连接有效性,尤其在长生命周期脚本中utf8mb4 不是可选项,是必须项。MySQL 的 utf8 实际只支持 3 字节 UTF-8,存不了 emoji 和部分汉字(如 ?、?)PDO::ATTR_PERSISTENT 或 mysqli::real_connect() 的 MYSQLI_CLIENT_FOUND_ROWS 等非常规标志,除非你清楚它们对连接池和事务的影响真正麻烦的从来不是“怎么连”,而是“连上之后怎么不出错”——字符集、权限粒度、连接生命周期、错误传播方式,每个都得按实际部署环境校准,而不是照抄教程里的四行代码。