PHP如何输出MySQL错误

在使用PHP与MySQL进行数据库操作时，难免会遇到一些错误。为了快速定位和解决问题，我们需要在代码中捕获并输出这些错误信息。本文将介绍几种常见的PHP输出MySQL错误的方法。

1. 使用 mysqli_error() 函数

mysqli_error() 函数用于返回最近一次MySQL操作的错误信息。它通常与 mysqli_connect_error() 和 mysqli_connect_errno() 一起使用，以捕获连接错误。

<?php
$mysqli = new mysqli("localhost", "user", "password", "database");

// 检查连接是否成功
if ($mysqli->connect_error) {
    die("连接失败: " . $mysqli->connect_error);
}

// 执行SQL查询
$sql = "SELECT * FROM non_existent_table";
if (!$mysqli->query($sql)) {
    echo "错误: " . $mysqli->error;
}

$mysqli->close();
?>

在上面的代码中，如果查询失败，mysqli_error() 会返回错误信息并输出。

2. 使用 PDO::errorInfo() 方法

如果你使用的是PDO（PHP Data Objects）扩展来连接MySQL数据库，可以使用 PDO::errorInfo() 方法来获取错误信息。

<?php
try {
    $pdo = new PDO("mysql:host=localhost;dbname=database", "user", "password");
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);

    // 执行SQL查询
    $sql = "SELECT * FROM non_existent_table";
    $pdo->query($sql);
} catch (PDOException $e) {
    echo "错误: " . $e->getMessage();
}
?>

在这个例子中，PDO::errorInfo() 返回一个数组，包含错误代码和错误信息。PDOException 异常类提供了 getMessage() 方法来获取错误信息。

3. 使用 mysql_error() 函数（已弃用）

在早期的PHP版本中，mysql_error() 函数用于返回最近一次MySQL操作的错误信息。然而，这个扩展已经在PHP 5.5.0中被弃用，并在PHP 7.0.0中被移除。因此，不建议在新项目中使用。

<?php
$link = mysql_connect("localhost", "user", "password");

if (!$link) {
    die('连接失败: ' . mysql_error());
}

mysql_select_db("database", $link);

$result = mysql_query("SELECT * FROM non_existent_table", $link);

if (!$result) {
    echo "错误: " . mysql_error();
}

mysql_close($link);
?>

4. 使用 mysqli_report() 函数

mysqli_report() 函数可以配置MySQLi扩展的错误报告行为。通过设置不同的模式，可以控制错误报告的详细程度。

<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);

try {
    $mysqli = new mysqli("localhost", "user", "password", "database");

    // 执行SQL查询
    $sql = "SELECT * FROM non_existent_table";
    $mysqli->query($sql);
} catch (mysqli_sql_exception $e) {
    echo "错误: " . $e->getMessage();
}

$mysqli->close();
?>

在这个例子中，mysqli_report() 配置为报告所有错误，并在发生错误时抛出异常。

5. 使用 error_log() 函数记录错误

除了直接在页面上输出错误信息，还可以使用 error_log() 函数将错误信息记录到服务器的错误日志中。

<?php
$mysqli = new mysqli("localhost", "user", "password", "database");

if ($mysqli->connect_error) {
    error_log("连接失败: " . $mysqli->connect_error);
    die("连接失败，请查看错误日志。");
}

$sql = "SELECT * FROM non_existent_table";
if (!$mysqli->query($sql)) {
    error_log("MySQL错误: " . $mysqli->error);
    echo "查询失败，请查看错误日志。";
}

$mysqli->close();
?>

结论

在PHP中输出MySQL错误信息是调试和排查问题的重要手段。根据使用的数据库扩展（MySQLi或PDO），可以选择不同的方法来捕获和输出错误信息。建议使用最新的MySQLi或PDO扩展，并避免使用已弃用的 mysql_* 函数。通过合理配置错误报告和记录错误日志，可以更高效地解决数据库操作中的问题。