PHP调用数据库是Web开发中的常见操作，当调用失败时，需要先梳理整个调用流程的各个环节，逐一排查可能的问题点。下面先介绍一个基础的PHP连接MySQL数据库的示例代码，方便后续对照分析。
一、常见失败原因及解决方法
1. 数据库连接参数错误
连接数据库时需要提供主机地址、端口、数据库名、用户名、密码等参数，任意一项配置错误都会导致连接失败。比如主机地址填写错误、密码输入有误、数据库名不存在等情况。
以下是使用PDO连接MySQL的基础代码示例：
<?php
// 数据库连接参数
$host = '127.0.0.1';
$port = 3306;
$dbname = 'test_db';
$username = 'root';
$password = '123456';
try {
// 创建PDO连接实例
$dsn = "mysql:host=$host;port=$port;dbname=$dbname;charset=utf8mb4";
$pdo = new PDO($dsn, $username, $password);
// 设置错误模式为异常模式，方便捕获错误
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
echo "数据库连接成功";
} catch (PDOException $e) {
echo "数据库连接失败，错误信息：" . $e->getMessage();
}
?>如果出现连接失败，首先检查$host、$port、$dbname、$username、$password这几个参数是否正确，确认数据库服务是否允许当前主机连接。
2. 数据库服务未启动
如果MySQL服务没有正常运行，PHP自然无法和数据库建立连接。可以通过命令行或者系统服务管理面板查看数据库服务的运行状态。
在Linux系统中可以使用以下命令查看MySQL服务状态：
systemctl status mysql
如果服务未启动，使用以下命令启动服务：
systemctl start mysql
3. 数据库用户权限不足
连接数据库的用户如果没有对应数据库的操作权限，也会导致调用失败。比如用户只有查询权限，却执行了插入操作，或者用户不允许从当前客户端主机连接数据库。
可以通过MySQL命令行登录后，查看用户权限：
-- 查看指定用户的权限 SHOW GRANTS FOR 'root'@'127.0.0.1';
如果权限不足，可以给用户授予对应权限：
-- 给root用户授予test_db数据库的所有权限，允许从127.0.0.1连接 GRANT ALL PRIVILEGES ON test_db.* TO 'root'@'127.0.0.1'; FLUSH PRIVILEGES;
4. SQL语句语法错误
即使数据库连接成功，如果执行的SQL语句存在语法错误，也会导致调用失败。比如表名、字段名拼写错误，SQL关键字使用不当，字符串没有正确闭合等。
以下是执行SQL语句的示例代码：
<?php
// 假设已经创建了上面的$pdo连接实例
try {
// 错误的SQL语句，表名拼写错误
$sql = "SELECT * FROM user_table";
$stmt = $pdo->query($sql);
$result = $stmt->fetchAll(PDO::FETCH_ASSOC);
print_r($result);
} catch (PDOException $e) {
echo "SQL执行失败，错误信息：" . $e->getMessage();
}
?>出现这类错误时，可以先将SQL语句打印出来，放到MySQL命令行中执行，确认语句是否正确。
5. PHP数据库扩展未安装
使用PDO或者mysqli扩展连接数据库时，如果对应的PHP扩展没有安装，会直接报错。可以通过phpinfo()函数查看已安装的扩展。
如果缺少PDO MySQL扩展，在PHP配置文件中开启对应扩展：
; 去掉前面的分号开启扩展 extension=pdo_mysql
修改后重启PHP服务即可生效。
二、排查流程总结
遇到PHP调用数据库失败时，可以按照以下流程逐一排查：
- 第一步：检查PHP错误提示，获取具体的错误信息
- 第二步：确认数据库连接参数是否正确
- 第三步：检查数据库服务是否正常运行
- 第四步：验证数据库用户权限是否足够
- 第五步：检查执行的SQL语句是否存在语法错误
- 第六步：确认PHP对应的数据库扩展是否安装并开启
按照上述流程排查，大部分PHP调用数据库失败的问题都可以快速定位并解决。