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 连接 MySQL（面向对象写法）
这是目前最常用、推荐的连接方式，语法清晰、支持预处理、错误提示明确。
- 确保 PHP 已启用
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('utf8mb4'); // 强烈建议设为 utf8mb4，避免 emoji 和生僻字乱码
怎么用 PDO 连接 MySQL（更灵活、支持多种数据库）
PDO 更适合需要切换数据库类型（如从 MySQL 换到 PostgreSQL）或强调统一错误处理的项目。它默认不开启异常模式，这点容易被忽略。
- DSN 字符串格式为
mysql:host=localhost;dbname=testdb;charset=utf8mb4，charset必须写在 DSN 里才生效，单独调setCharset无效 - 必须设置
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION，否则 SQL 错误只会返回false，难以调试 - 密码等敏感信息建议从环境变量读取，而不是硬编码在 DSN 中
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());
}
为什么连不上？常见卡点排查
不是代码写错，而是环境或权限问题占八成。先看这些再改代码：
立即学习“PHP免费学习笔记（深入）”；
- MySQL 服务没启动：运行
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'; -
防火墙/SELinux 拦截：Linux 下确认
3306端口未被屏蔽；Mac M1 用户注意 MySQL 是否跑在 Rosetta 模式下导致 socket 路径异常 - PHP 和 MySQL 版本不兼容：MySQL 8.0 默认用
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等非常规标志，除非你清楚它们对连接池和事务的影响
真正麻烦的从来不是“怎么连”，而是“连上之后怎么不出错”——字符集、权限粒度、连接生命周期、错误传播方式，每个都得按实际部署环境校准，而不是照抄教程里的四行代码。
