PHP技术教程：PDO错误处理与调试技巧

引言

在使用PDO（PHP Data Objects）进行数据库操作时，良好的错误处理与调试技巧是确保程序稳定性和可维护性的关键。本文将详细介绍PHP中PDO的错误处理与调试方法，并通过详细案例加以说明。

PDO错误处理基础

PDO提供了多种错误处理方式，包括异常处理和错误代码/信息检查。

异常处理

通过设置PDO的异常模式，可以使PDO在出错时抛出异常，从而可以通过try-catch块进行捕获和处理。

<?php
try {
    $dsn = 'mysql:host=localhost;dbname=test;charset=utf8';
    $username = 'root';
    $password = 'password';

    $options = [
        PDO::ATTR_ERRMODE => PDO::ERRMODE_EXCEPTION,
        PDO::ATTR_DEFAULT_FETCH_MODE => PDO::FETCH_ASSOC,
        PDO::ATTR_EMULATE_PREPARES => false,
    ];

    $pdo = new PDO($dsn, $username, $password, $options);
} catch (PDOException $e) {
    echo '连接失败: ' . $e->getMessage();
}
?>

错误代码和信息检查

如果不使用异常模式，可以通过检查PDO对象的errorCode和errorInfo属性来获取错误信息。

<?php
$pdo = new PDO($dsn, $username, $password);
$pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_WARNING);

$stmt = $pdo->prepare("SELECT * FROM users WHERE id = ?");
$stmt->execute([1]);

if ($stmt->errorCode() !== '00000') {
    echo '执行失败: ' . $stmt->errorInfo()[2];
}
?>

日志记录

在生产环境中，将错误信息记录到日志文件而不是直接输出到页面通常是更好的做法。这可以通过自定义异常处理器或错误处理函数来实现。

<?php
function customExceptionHandler($exception) {
    file_put_contents('pdo_errors.log', date('Y-m-d H:i:s') . ' - ' . $exception->getMessage() . PHP_EOL, FILE_APPEND);
}
set_exception_handler('customExceptionHandler');

try {
    // PDO操作代码
} catch (PDOException $e) {
    throw $e;
}
?>

案例分析：处理复杂的SQL错误

假设我们有一个复杂的SQL语句需要进行多次尝试，并且需要捕获并记录每次失败的原因。

<?php
function executeComplexQuery($pdo, $query, $params) {
    $retries = 3;
    $errorLog = '';

    while ($retries--) {
        try {
            $stmt = $pdo->prepare($query);
            $stmt->execute($params);
            return $stmt;
        } catch (PDOException $e) {
            $errorLog .= date('Y-m-d H:i:s') . ' - ' . $e->getMessage() . PHP_EOL;
            // 可在此处添加其他处理逻辑，如等待后重试
        }
    }

    // 记录到日志文件
    file_put_contents('complex_query_errors.log', $errorLog, FILE_APPEND);
    throw new Exception('复杂查询执行失败，详情见日志文件');
}

try {
    $query = "INSERT INTO complex_table (col1, col2) VALUES (?, ?)";
    $params = ['value1', 'value2'];
    $stmt = executeComplexQuery($pdo, $query, $params);
} catch (Exception $e) {
    echo '操作失败: ' . $e->getMessage();
}
?>