最稳妥推荐的PHP连MySQL方式是PDO，需启用pdo和pdo_mysql扩展，连接时必须设置charset=utf8mb4和PDO::ATTR_ERRMODE=>PDO::ERRMODE_EXCEPTION，排查连接失败要依次检查MySQL服务状态、用户权限和host/port配置。
PHP 连 MySQL 最稳妥、推荐的方式是用 PDO，不是 mysql_connect()（已彻底废弃），也不是 mysqli_connect()（虽可用但面向过程写法易出错）。PDO 支持预处理、多数据库切换、错误模式可控，初学者从它起步反而更少踩坑。
确认 PHP 环境已启用 PDO 和 pdo_mysql 扩展
很多新手本地跑不起来，根本原因是扩展没开。执行以下命令检查：
php -m | grep -i pdo
应看到 pdo 和 pdo_mysql。若没有：
- Windows（XAMPP/WAMP）：打开
php.ini，取消注释这两行：;extension=php_pdo.dll→ 改为extension=php_pdo.dll;extension=php_pdo_mysql.dll→ 改为extension=php_pdo_mysql.dll - macOS（Homebrew + php@8.2）：
brew install php@8.2默认已含，检查/opt/homebrew/etc/php/8.2/php.ini中是否有extension=pdo_mysql - Linux（Ubuntu）：
sudo apt install php-mysql，然后确认/etc/php/*/apache2/conf.d/10-pdo.ini和20-mysqlnd.ini存在且未被注释
用 PDO 连接 MySQL 的最小可运行代码
别抄网上带 try-catch 但没设 PDO::ATTR_ERRMODE 的“半残”示例——那会静默失败。下面这段能立刻暴露连接问题：
立即学习“PHP免费学习笔记（深入）”；
PHP高级开发技巧与范例
下载
PHP是一种功能强大的网络程序设计语言，而且易学易用，移植性和可扩展性也都非常优秀，本书将为读者详细介绍PHP编程。 全书分为预备篇、开始篇和加速篇三大部分，共9章。预备篇主要介绍一些学习PHP语言的预备知识以及PHP运行平台的架设；开始篇则较为详细地向读者介绍PKP语言的基本语法和常用函数，以及用PHP如何对MySQL数据库进行操作；加速篇则通过对典型实例的介绍来使读者全面掌握PHP。 本书
try {
$pdo = new PDO("mysql:host=$host;dbname=$dbname;charset=utf8mb4", $username, $password, [
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
]);
echo "✅ 连接成功";
} catch (PDOException $e) {
echo "❌ 连接失败：" . $e->getMessage();
}
?>关键点：
-
charset=utf8mb4必须显式声明，否则中文存入可能变问号或乱码 -
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION是核心，没它就等于“把错误吞掉” - 密码为空时不要传
null或省略，必须传空字符串'' - 如果报
SQLSTATE[HY000] [1045] Access denied，先用命令行验证账号密码：mysql -u root -p
连接失败的三个高频原因和对应检查项
90% 的“连不上”问题集中在这三处，按顺序排查：
-
MySQL 服务根本没运行：Mac 执行
brew services list | grep mysql，Linux 执行sudo systemctl status mysql，Windows 检查 XAMPP 控制面板里 MySQL 是否显示 “Running” -
用户权限不足：默认
root@localhost可能只允许 socket 连接。用命令行登录后执行：CREATE USER 'phpuser'@'localhost' IDENTIFIED BY 'pass123';
，然后代码里改用这个新用户
GRANT ALL ON testdb.* TO 'phpuser'@'localhost';
FLUSH PRIVILEGES; -
端口或 host 写错：Docker 环境常见问题。若 MySQL 在容器中，
host不能写localhost（它指向 PHP 容器自身），得写宿主机 IP 或 Docker 网络别名如mysql；本地 MAMP 用户注意端口是否被改成8889，则 DSN 要写成mysql:host=localhost;port=8889;dbname=...
真正难的不是写那几行连接代码，而是当页面只显示空白或 500 错误时，你能否快速定位是 PHP 配置、MySQL 服务、网络通路，还是权限策略的问题。建议第一次成功后，立刻在代码里加一句 var_dump($pdo->getAttribute(PDO::ATTR_SERVER_VERSION));，亲眼看到版本号，才算真正“握住了手”。
