在PHP应用中，数据库连接的稳定性直接影响系统可用性。为确保服务正常运行，需要定期检查数据库连接状态并及时发现异常。以下是几种常见的PHP数据库健康检查实现方式。
使用PDO检测连接状态
通过PDO可以尝试执行一个轻量级查询（如SELECT 1）来判断数据库是否可访问：
- 创建PDO实例时设置错误模式为异常模式，便于捕获连接失败
- 执行
SELECT 1验证连接有效性 - 使用try-catch处理可能的异常
示例代码：
$pdo = null;
try {
$pdo = new PDO("mysql:host=localhost;dbname=test", $user, $pass);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
// 执行健康检查
$stmt = $pdo->query("SELECT 1");
if ($stmt->fetchColumn() == 1) {
echo "数据库连接正常";
}
} catch (PDOException $e) {
error_log("数据库连接失败: " . $e->getMessage());
echo "数据库不可用";
}
利用MySQL原生扩展mysqli_ping()
如果使用mysqli扩展，可以直接调用mysqli_ping()方法检测连接是否存活：
立即学习“PHP免费学习笔记（深入）”；
- 该方法会自动重连已断开的连接（取决于配置）
- 适合长生命周期的脚本或常驻进程
- 返回true表示连接有效，false表示无效
示例代码：
$mysqli = new mysqli("localhost", "user", "password", "database");
if (!$mysqli->ping()) {
error_log("数据库连接已断开");
echo "数据库异常";
} else {
echo "连接正常";
}
集成到Web健康检查接口
将数据库检查嵌入一个专用的健康检查路由（如/health），供监控系统轮询：
- 返回JSON格式状态信息，便于自动化监控解析
- 可同时检查多个依赖项（缓存、文件系统等）
- 避免输出敏感信息
简单实现：
header('Content-Type: application/json');
try {
$pdo = new PDO("mysql:host=localhost;dbname=test", $user, $pass);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
$pdo->query("SELECT 1");
echo json_encode(['status' => 'ok', 'db' => 'connected']);
} catch (Exception $e) {
http_response_code(500);
echo json_encode(['status' => 'error', 'db' => 'disconnected']);
}
定时任务与日志告警
结合Linux cron或消息队列消费者等场景，定期执行连接测试并记录结果：
- 每隔一定时间运行检查脚本
- 将异常写入日志或发送通知（邮件、短信、钉钉等）
- 可用于恢复性操作，比如尝试重建连接池
基本上就这些实用方法，关键是根据实际架构选择合适的检测机制。
