PHP连接数据库服务器，核心答案是使用mysqli扩展或PDO扩展，通过主机地址、用户名、密码和数据库名四个参数建立连接，推荐使用面向对象的PDO方式，因为它支持更多数据库且预编译语句能有效防止SQL注入。
很多朋友在搭建网站时，都卡在了PHP连接数据库这一步，看着报错信息一头雾水，别急，今天咱们就把这个事彻底讲明白，我会从最基础的连接方式讲起，带你排查常见的坑,再聊聊性能优化那些事。
PHP连接MySQL数据库的两种主流方式
PHP连接数据库服务器，业界主流方案就是MySQLi和PDO，你可以把它们想象成两位性格不同的助手,帮你把PHP代码和MySQL数据库之间的桥梁搭起来。
MySQLi扩展：MySQL专属的“老伙计”
MySQLi是PHP官方为MySQL数据库量身定制的扩展，它的特点就是专一且高效，如果你确定项目一直使用MySQL,选它准没错。
- 面向对象风格：代码结构清晰,推荐新手使用。
- 面向过程风格：像函数调用一样直接,老代码里很常见。
下面是一段最基础的面向对象连接代码，把它保存为test.php运行,就能看到效果。
<?php
$host = '127.0.0.1'; // 数据库服务器地址
$user = 'root'; // 数据库用户名
$pass = 'your_password'; // 数据库密码
$dbname = 'test_db'; // 数据库名
// 创建连接
$conn = new mysqli($host, $user, $pass, $dbname);
// 检查连接
if ($conn->connect_error) {
die("连接失败: " . $conn->connect_error);
}
echo "连接成功";
$conn->close();
?>
注意：0.0.1通常比localhost更快，因为它绕过了DNS解析直接使用TCP/IP协议。
PDO扩展：全能型的“瑞士军刀”
PDO（PHP Data Objects）是一个数据库抽象层，它定义了一套统一的API来访问各种数据库，这意味着你写的连接代码，几乎可以无缝切换到PostgreSQL、SQLite等其他数据库。
- 跨数据库支持：这是相比MySQLi最大的优势。
- 预编译语句：这是防御SQL注入攻击的标准配置,强烈推荐。
PDO连接代码同样简洁明了：
<?php $dsn = 'mysql:host=127.0.0.1;dbname=test_db;charset=utf8mb4'; $user = 'root'; $pass = 'your_password'; try { $pdo = new PDO($dsn, $user, $pass); // 设置错误模式为异常，方便调试 $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); echo "PDO连接成功"; } catch (PDOException $e) { die("连接失败: " . $e->getMessage()); } ?>
业内专家指出，在现代PHP开发中，PDO已经是事实上的标准，因为它让代码更健壮、更安全。
排查php连接数据库失败怎么办
很多人在第一步就栽了跟头，连接失败的原因千奇百怪，别慌，我们按图索骥,一步步来。
检查PHP环境是否开启了扩展
在php.ini配置文件中，确保extension=mysqli或extension=pdo_mysql前面的分号（）被去掉了，修改后务必重启Web服务器（如Apache、Nginx）或PHP-FPM服务,配置才会生效。
你可以在项目目录下创建一个phpinfo.php就一行<?php phpinfo(); ?>，然后在浏览器里访问它，在输出页面里搜索mysqli或pdo_mysql，如果能看到对应的扩展信息,就说明扩展已成功加载。
核对连接参数和权限
- 主机地址：检查是
localhost还是0.0.1，或是远程服务器的IP地址，虚拟主机用户通常使用localhost,而云服务器用户可能需要填写公网或内网IP。 - 端口号：默认是
3306，如果数据库服务器改了端口，需要在连接时加上端口参数，比如$conn = new mysqli("127.0.0.1:3307", $user, $pass, $dbname);。 - 账号权限：你使用的数据库账号必须拥有从当前主机访问目标数据库的权限，在MySQL命令行里执行
GRANT ALL PRIVILEGES ON test_db. TO 'user'@'host';可以授权。
排查网络与防火墙问题
如果PHP和MySQL不在同一台机器上，网络因素就很重要了，检查云服务器的安全组规则是否放行了3306端口，以及服务器本机的防火墙（如firewalld或iptables）是否拦截了该端口，在服务器上执行telnet 数据库IP 3306，如果可以连接,说明网络是通的。
| 排查点 | 操作路径 | 预期结果 |
|---|---|---|
| PHP扩展 | php.ini -> 搜索extension |
无前置分号 |
| 账号权限 | MySQL命令行 -> SHOW GRANTS FOR 'user'@'host'; |
有目标库权限 |
| 网络连通 | 命令行 -> telnet 数据库IP 3306 |
连接成功 |
| 服务状态 | 命令行 -> systemctl status mysqld |
状态为active (running) |
php连接数据库代码怎么写更安全
连接上数据库只是第一步，真正的挑战在于安全地操作数据，使用PDO的预编译语句（Prepared Statements）是保障安全的关键。
使用PDO预处理执行插入操作
预处理将SQL语句的结构和数据分离开，数据库先编译SQL模板，再把参数值安全地传递进去,从而彻底杜绝了SQL注入的可能。
<?php // 假设已经通过 $pdo 对象建立了连接 $sql = "INSERT INTO users (username, email) VALUES (?, ?)"; $stmt = $pdo->prepare($sql); $username = "张三"; $email = "zhangsan@example.com"; // 执行预编译语句 $stmt->execute([$username, $email]); echo "新用户ID: " . $pdo->lastInsertId(); ?>
处理数据库连接异常
在连接数据库时，使用try...catch块是必须的，它能捕获连接过程中出现的异常，并给出友好的错误提示,而不是把一堆晦涩的堆栈信息直接抛给用户。
<?php
try {
$pdo = new PDO($dsn, $user, $pass);
// ... 执行数据库操作
} catch (PDOException $e) {
// 记录错误信息到日志文件，而不是直接显示给用户
error_log($e->getMessage());
echo "系统繁忙，请稍后再试";
}
?>
数据库连接性能优化实战
连接数据库本身是有开销的，每次连接都需要进行网络握手、身份验证等操作，对于高并发场景,优化连接能显著提升响应速度。
使用长连接减少连接开销
在PHP中，使用PDO::ATTR_PERSISTENT => true可以创建长连接，长连接在脚本执行完毕后不会关闭，而是被复用给下一个请求,省去了重复建立连接的时间。
<?php
$options = [
PDO::ATTR_PERSISTENT => true,
PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION
];
$pdo = new PDO($dsn, $user, $pass, $options);
?>
注意：长连接在并发高的场景下可能导致连接数超过MySQL上限，需要合理配置MySQL的max_connections参数。
采用连接池或中间件方案
对于大型应用，可以考虑使用数据库连接池或代理中间件，比如HikariCP（Java生态）或ProxySQL（MySQL中间件），这些工具能统一管理数据库连接，提升系统整体稳定性，不过对于PHP项目，更常见的做法是使用Swoole等常驻内存框架,在应用层面实现连接复用。
Q&A：php连接数据库常见问题
为什么php连接数据库服务器总是超时？
超时通常由网络不通、防火墙拦截或MySQL配置问题导致，首先检查网络连通性，然后用telnet命令测试端口，如果网络正常，检查MySQL的bind-address配置，确保它监听了正确的IP地址，如果数据库负载过高,也可能导致无法及时响应连接请求。
PDO和MySQLi应该选哪个？
对于新项目，行业共识推荐使用PDO，它提供了更统一的API，方便未来更换数据库，且预编译语句的默认行为更安全，如果你的项目已经用MySQLi稳定运行，且短期内没有更换数据库的打算，继续使用MySQLi也完全没问题，关键在于代码的规范性和对预编译语句的坚持，两者都能有效防止SQL注入,但PDO的写法更优雅。
如何修改MySQL数据库账号的密码？
这和处理PHP连接参数直接相关，你可以登录MySQL命令行，执行ALTER USER 'root'@'localhost' IDENTIFIED BY '新密码';，修改后，务必同步更新PHP代码中的数据库连接密码，如果使用PHPMyAdmin,也可以直接在用户账户页面里修改。
连接数据库是PHP开发的基石，掌握好mysqli和PDO这两种方式，并理解连接失败的排查思路，你的开发之路会顺畅很多，性能优化不是一蹴而就的，从合理使用长连接开始,逐步构建稳定高效的数据库访问层。
首发原创文章，作者：王坚，如若转载，请注明出处：https://idctop.com/php%e6%80%8e%e4%b9%88%e8%bf%9e%e6%8e%a5%e6%95%b0%e6%8d%ae%e5%ba%93%e6%9c%8d%e5%8a%a1%e5%99%a8%ef%bc%9f%ef%bc%8c%e6%95%b0%e6%8d%ae%e5%ba%93%e8%bf%9e%e6%8e%a5%e5%a4%b1%e8%b4%a5%e6%80%8e%e4%b9%88/
