编辑“︁PHP数据库错误处理”︁（章节）

= PHP数据库错误处理 =

在PHP中与数据库交互时，错误处理是确保应用程序健壮性和安全性的关键环节。本指南将详细介绍如何在PHP中捕获、记录和处理数据库操作中的错误，适合从初学者到高级开发者的所有用户。

== 概述 ==
数据库错误处理是指在执行数据库操作（如连接、查询、更新等）时，检测并响应可能出现的错误。PHP提供了多种机制来处理这些错误，包括：
* 内置的错误报告
* 异常处理
* 自定义错误处理函数

良好的错误处理可以帮助开发者快速定位问题，避免敏感信息泄露，并提升用户体验。

== 错误处理机制 ==

=== 1. 基本错误检测 ===
PHP的MySQLi和PDO扩展都提供了基本的错误检测方法。

'''MySQLi示例：'''
<syntaxhighlight lang="php">
<?php
$conn = new mysqli("localhost", "user", "password", "database");

// 检查连接错误
if ($conn->connect_error) {
    die("连接失败: " . $conn->connect_error);
}

$sql = "SELECT * FROM non_existent_table";
$result = $conn->query($sql);

// 检查查询错误
if (!$result) {
    echo "查询错误: " . $conn->error;
}

$conn->close();
?>
</syntaxhighlight>

'''输出可能为：'''
<pre>
查询错误: Table 'database.non_existent_table' doesn't exist
</pre>

=== 2. 异常处理 ===
PDO支持异常处理模式，可以更优雅地处理错误。

'''PDO异常处理示例：'''
<syntaxhighlight lang="php">
<?php
try {
    $pdo = new PDO("mysql:host=localhost;dbname=database", "user", "password");
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
    
    $stmt = $pdo->query("SELECT * FROM non_existent_table");
} catch (PDOException $e) {
    echo "数据库错误: " . $e->getMessage();
    // 记录错误到日志文件
    error_log($e->getMessage(), 3, "/var/log/php_db_errors.log");
}
?>
</syntaxhighlight>

'''输出可能为：'''
<pre>
数据库错误: SQLSTATE[42S02]: Base table or view not found: 1146 Table 'database.non_existent_table' doesn't exist
</pre>

=== 3. 错误级别与报告 ===
PHP定义了不同的错误级别，可以通过<code>error_reporting()</code>函数控制：

<mermaid>
pie
    title 常见数据库错误级别
    "E_WARNING" : 35
    "E_NOTICE" : 15
    "E_ERROR" : 25
    "E_USER_ERROR" : 25
</mermaid>

数学公式示例（错误概率计算）：
<math>
P(error) = \frac{错误次数}{总操作次数}
</math>

== 实际应用场景 ==

=== 场景1：用户注册系统 ===
处理用户注册时可能出现的数据库错误：

<syntaxhighlight lang="php">
<?php
function registerUser($username, $password) {
    try {
        $pdo = new PDO("mysql:host=localhost;dbname=users", "admin", "securepass");
        $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION);
        
        $hashedPassword = password_hash($password, PASSWORD_DEFAULT);
        $stmt = $pdo->prepare("INSERT INTO users (username, password) VALUES (?, ?)");
        $stmt->execute([$username, $hashedPassword]);
        
        return true;
    } catch (PDOException $e) {
        // 用户名重复错误
        if ($e->errorInfo[1] == 1062) {
            return "用户名已存在";
        }
        // 其他数据库错误
        error_log("注册错误: " . $e->getMessage());
        return "系统错误，请稍后再试";
    }
}
?>
</syntaxhighlight>

=== 场景2：电子商务库存管理 ===
处理并发更新时的错误：

<syntaxhighlight lang="php">
<?php
function updateInventory($productId, $quantity) {
    $conn = new mysqli("localhost", "user", "pass", "shop");
    
    // 开启事务
    $conn->autocommit(FALSE);
    
    try {
        // 检查当前库存
        $result = $conn->query("SELECT stock FROM products WHERE id = $productId FOR UPDATE");
        $row = $result->fetch_assoc();
        
        if ($row['stock'] < $quantity) {
            throw new Exception("库存不足");
        }
        
        // 更新库存
        $conn->query("UPDATE products SET stock = stock - $quantity WHERE id = $productId");
        $conn->commit();
        return true;
    } catch (Exception $e) {
        $conn->rollback();
        error_log("库存更新失败: " . $e->getMessage());
        return false;
    } finally {
        $conn->autocommit(TRUE);
        $conn->close();
    }
}
?>
</syntaxhighlight>

== 最佳实践 ==
1. '''始终检查返回值'''：不要假设数据库操作总会成功
2. '''使用预处理语句'''：防止SQL注入
3. '''适当记录错误'''：但不要向用户显示敏感信息
4. '''实现回退机制'''：特别是对于关键操作
5. '''分类处理错误'''：区分不同类型的错误（连接错误、查询错误等）

== 高级主题 ==
对于高级开发者，可以考虑：
* 实现自定义错误处理器
* 使用数据库连接池和重试机制
* 分析错误模式进行系统优化
* 实现监控和报警系统

通过以上方法，您可以构建健壮的PHP数据库应用程序，能够妥善处理各种错误情况，同时保持良好的用户体验和系统稳定性。

[[Category:编程语言]]
[[Category:PHP]]
[[Category:PHP数据库操作]]