在PHP项目开发中，和数据库交互前首先需要确认数据库连接是否成功，这能避免后续执行查询、插入等操作时出现无意义的报错，提升调试效率。目前PHP主流的数据库连接方式有MySQLi和PDO两种，下面分别介绍对应的验证方法。
一、使用MySQLi扩展验证连接
MySQLi是PHP针对MySQL数据库提供的专用扩展，支持面向对象和过程化两种编程风格，下面是两种风格的验证示例。
1. 面向对象风格
面向对象风格下，创建MySQLi实例时如果连接失败，会直接抛出异常，我们可以通过捕获异常或者判断连接错误属性来验证。
<?php
// 数据库配置参数
$host = '127.0.0.1';
$username = 'root';
$password = 'root123';
$database = 'test_db';
$port = 3306;
// 创建MySQLi实例
$mysqli = new mysqli($host, $username, $password, $database, $port);
// 检查连接是否出错
if ($mysqli->connect_error) {
die('数据库连接失败，错误信息：' . $mysqli->connect_error);
} else {
echo 'MySQLi面向对象方式连接数据库成功';
// 关闭连接
$mysqli->close();
}
?>
2. 过程化风格
过程化风格使用mysqli_connect函数创建连接，连接失败时会返回false，我们可以通过判断返回值来验证。
<?php
// 数据库配置参数
$host = '127.0.0.1';
$username = 'root';
$password = 'root123';
$database = 'test_db';
$port = 3306;
// 建立连接
$conn = mysqli_connect($host, $username, $password, $database, $port);
// 验证连接结果
if (!$conn) {
die('数据库连接失败，错误信息：' . mysqli_connect_error());
} else {
echo 'MySQLi过程化方式连接数据库成功';
// 关闭连接
mysqli_close($conn);
}
?>
二、使用PDO扩展验证连接
PDO是PHP提供的数据访问抽象层，支持多种数据库，使用PDO连接数据库时，默认会在连接失败时抛出异常，我们可以通过try-catch结构捕获异常来验证连接状态。
<?php
// 数据库配置参数
$host = '127.0.0.1';
$username = 'root';
$password = 'root123';
$database = 'test_db';
$port = 3306;
$charset = 'utf8mb4';
// 构造DSN字符串
$dsn = "mysql:host=$host;port=$port;dbname=$database;charset=$charset";
try {
// 创建PDO实例
$pdo = new PDO($dsn, $username, $password);
// 设置错误模式为异常模式，方便捕获错误
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
echo 'PDO方式连接数据库成功';
// 关闭连接，将实例设为null即可
$pdo = null;
} catch (PDOException $e) {
die('数据库连接失败，错误信息：' . $e->getMessage());
}
?>
三、常见连接失败原因排查
如果验证时发现连接失败，可以从以下几个方面排查问题：
- 检查数据库服务是否启动，比如MySQL服务是否正常运行
- 核对连接参数是否正确，包括主机地址、端口、账号、密码、数据库名称
- 检查数据库用户是否有对应主机的访问权限，比如root用户是否允许从当前客户端IP登录
- 检查防火墙是否拦截了数据库端口，比如3306端口是否被防火墙屏蔽
- 确认数据库名称是否存在，避免填写了未创建的数据库名
四、连接状态二次验证
有些场景下，初始连接成功不代表后续操作一定可用，比如连接长时间闲置后被服务端断开，此时可以执行简单的查询语句验证连接是否仍然有效。
<?php
// 以PDO连接为例，验证连接是否可用
function checkDbConnection($pdo) {
try {
// 执行简单查询，检查连接状态
$pdo->query('SELECT 1');
return true;
} catch (PDOException $e) {
return false;
}
}
// 调用验证函数
if (checkDbConnection($pdo)) {
echo '数据库连接状态正常，可以执行后续操作';
} else {
echo '数据库连接已断开，需要重新建立连接';
}
?>
PHPMySQLiPDOdatabase_connectionerror_handling修改时间：2026-07-08 05:48:20