PHP连接MySQL数据库入门教程

本文为PHP初学者量身打造，系统讲解如何安全、可靠地使用PDO连接MySQL数据库——这是当前最推荐且不易踩坑的方式，远胜已废弃的mysql_connect()和易出错的mysqli过程式写法；文章不仅提供最小可运行代码（强调必须设置charset=utf8mb4和PDO::ATTR_ERRMODE=>PDO::ERRMODE_EXCEPTION），还手把手指导如何检查并启用pdo/pdo_mysql扩展、排查三大高频连接失败原因（MySQL服务未启动、用户权限不足、host/port配置错误），并给出跨平台（Windows/macOS/Linux/Docker）的实操解决方案，助你从“页面空白”“500错误”的迷茫中快速定位问题，真正实现稳定握手、自信入门。

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 的“半残”示例——那会静默失败。下面这段能立刻暴露连接问题：

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));，亲眼看到版本号，才算真正“握住了手”。

终于介绍完啦！小伙伴们，这篇关于《PHP连接MySQL数据库入门教程》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！