PHP 连接MySQL数据库实战详解（2026最新整理）

最近在项目里重度用到了连接MySQL数据库，踩过一些坑，也总结出一些心得。趁记忆还新鲜，整理成文，供同样在用PHP的朋友参考。

从一个真实场景说起：连接MySQL数据库

提到连接MySQL数据库，不少人的第一反应是「这个我熟」。可真要细问几个细节，能答上来的人并不多。不妨跟着本文自查一下，你对连接MySQL数据库的掌握能打几分。

掌握连接MySQL数据库的几个关键

1. 连接MySQL数据库的文档注释写清楚参数含义和返回值，降低别人（和未来的自己）的理解成本。
2. 涉及连接MySQL数据库的配置项要集中管理，不要散落在代码各个角落。
3. 连接MySQL数据库在循环中使用时要留意重复开销，能提到循环外的就提出来。
4. 团队里推广连接MySQL数据库的正确用法，比一个人用得好更有价值。

接下来用代码实际演示一下连接MySQL数据库。

连接MySQL数据库代码示例

直接上代码，PDO 预处理防止 SQL 注入：

<?php
$pdo = new PDO('mysql:host=127.0.0.1;dbname=test;charset=utf8mb4', 'root', '123456', [
    PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
]);
$stmt = $pdo->prepare('SELECT * FROM user WHERE id = ?');
$stmt->execute([$id]);
$row = $stmt->fetch(PDO::FETCH_ASSOC);

避坑指南

• 遇到问题先看日志，日志看不懂再把关键报错贴到搜索引擎，命中率很高。
• 日志要有关键信息但别太啰嗦，既要能排查问题又不能泄露隐私。
• 学会用二分法排查：注释掉一半代码，问题范围立刻减半。
• 修改配置后记得重启或重载服务，很多人调半天发现是配置没生效。

写在最后

写到这里，关于连接MySQL数据库的主要内容就齐了。如果你身边有正在学习PHP的朋友，不妨把这篇文章转给他。

---

遇见问题加 QQ23979811 协助处理