PHP mysqli：面向对象与过程式转换指南

本文深入探讨了PHP `mysqli`扩展的面向对象（OO）和过程式两种编程风格，分析了它们之间的转换方法及核心差异。文章指出，尽管可以进行过程式转换，但面向对象风格因其现代性和一致性而更受推荐。同时，文章强调了避免常见错误，并提供了优化后的 `mysqli` 示例，最终建议考虑考虑使用PDO以获得更灵活和强大的数据库操作体验。

在PHP数据库操作中，mysqli 扩展提供了两种主要的编程风格：面向对象（Object-Oriented, OO）和过程式（Procedural）。虽然这两种风格都能实现相同的功能，但在实际开发中，理解它们的差异以及何时使用哪种风格至关重要。本文将详细阐述这两种风格的转换方法、常见误区，并推荐更现代、更健壮的实践方式。

理解 mysqli 的面向对象与过程式风格

mysqli 扩展最初设计过程式风格是为了帮助从旧版 mysql 扩展迁移的用户，而面向对象风格则代表了更现代的PHP编程范式。尽管名称包含“面向对象”，但使用 mysqli 的OO风格并不意味着您的整个代码库必须是严格的面向对象编程（OOP）。它仅仅是调用 mysqli 功能的一种更结构化的方式。

两种风格的核心差异在于函数调用的方式：

• 面向对象风格：通过 mysqli 对象的方法来调用功能。例如：$mysqli->prepare()。
• 过程式风格：通过独立的函数来调用功能，并且通常需要将 mysqli 连接对象或语句对象作为第一个参数传入。例如：mysqli_prepare($mysqli, ...)。

以下是两种风格中 prepare 方法的等效示例：

// 面向对象风格
$stmt = $mysqli->prepare("SELECT * FROM bookings WHERE MONTH(event_date) = ? AND YEAR(event_date)=?");

// 过程式风格
$stmt = mysqli_prepare($mysqli, "SELECT * FROM bookings WHERE MONTH(event_date) = ? AND YEAR(event_date)=?");

可以看到，除了函数名称和参数顺序的微小差异外，它们在功能上是等价的。

从面向对象到过程式 mysqli 的正确转换

假设我们有以下使用面向对象风格的 mysqli 代码，用于从数据库中获取预订日期：

function build_calendar_oo($month, $year){
    $mysqli = new mysqli('localhost', 'root', '', 'ems');
    $stmt = $mysqli->prepare("SELECT * FROM bookings WHERE MONTH(event_date) = ? AND YEAR(event_date)=?");
    $stmt->bind_param('ss', $month, $year);
    $bookings = array();
    if($stmt->execute()){
        $result = $stmt->get_result();
        if($result->num_rows > 0){
            while($row = $result->fetch_assoc()){
                $bookings[] = $row['event_date'];
            }
            $stmt->close();
        }
    }
    return $bookings; // 添加返回值
}

将其转换为等价的过程式风格，需要将所有方法调用替换为相应的过程式函数，并传入连接对象或语句对象：

function build_calendar_procedural($month, $year)
{
    // 建立连接
    $mysqli = mysqli_connect('localhost', 'root', '', 'ems');
    if (!$mysqli) {
        die("连接失败: " . mysqli_connect_error());
    }

    // 准备语句
    $stmt = mysqli_prepare($mysqli, "SELECT * FROM bookings WHERE MONTH(event_date) = ? AND YEAR(event_date)=?");
    if (!$stmt) {
        die("语句准备失败: " . mysqli_error($mysqli));
    }

    // 绑定参数
    mysqli_stmt_bind_param($stmt, 'ss', $month, $year);

    $bookings = array();
    // 执行语句
    if (mysqli_stmt_execute($stmt)) {
        // 获取结果集
        $result = mysqli_stmt_get_result($stmt);
        if ($result && mysqli_num_rows($result) > 0) {
            // 遍历结果
            while ($row = mysqli_fetch_assoc($result)) {
                $bookings[] = $row['event_date'];
            }
            // 释放结果集
            mysqli_free_result($result);
        }
        // 关闭语句
        mysqli_stmt_close($stmt);
    } else {
        die("语句执行失败: " . mysqli_stmt_error($stmt));
    }

    // 关闭连接
    mysqli_close($mysqli);
    return $bookings;
}

注意事项：

• 错误处理： 在实际应用中，务必对 mysqli_connect、mysqli_prepare 和 mysqli_stmt_execute 等函数进行错误检查，以确保数据库操作的健壮性。
• 资源释放： 及时关闭语句 (mysqli_stmt_close) 和数据库连接 (mysqli_close)，释放系统资源。

常见错误及原因分析

在尝试从面向对象风格转换为过程式风格时，一个常见的错误尝试如下：

// 错误的尝试
$connection = mysqli_connect('localhost', 'root', '', 'ems');
$query = "SELECT * FROM bookings WHERE MONTH(event_date) = ? AND YEAR(event_date)=?";
$get_dates = mysqli_query($connection, $query); // 错误点
while($row = mysqli_fetch_assoc($get_dates)){ // 导致 Fatal error
    $booked_dates[] = $row['event_date'];
}

这个代码片段会抛出 Fatal error: Uncaught TypeError: mysqli_fetch_assoc(): Argument #1 ($result) must be of type mysqli_result 错误。

错误原因：mysqli_query() 函数用于执行简单的SQL查询，它不支持带占位符（?）的预处理语句。当 mysqli_query() 遇到占位符时，它无法正确解析和执行查询，通常会返回 false（表示查询失败）或一个非 mysqli_result 类型的资源。 而 mysqli_fetch_assoc() 函数期望的第一个参数是一个有效的 mysqli_result 对象（由 mysqli_query 成功执行 SELECT 语句后返回，或者由 mysqli_stmt_get_result 返回）。当 mysqli_query 失败或返回非 mysqli_result 类型时，mysqli_fetch_assoc() 就会因为类型不匹配而报错。

对于带参数的查询，必须使用预处理语句（Prepared Statements），无论是面向对象风格的 $mysqli->prepare() 还是过程式风格的 mysqli_prepare()。

推荐的 mysqli 实践：优化与简化

尽管过程式风格可行，但面向对象风格通常被认为是更现代、更易于阅读和维护的选择。此外，我们可以通过一些优化来进一步简化 mysqli 的使用。

1. 启用错误报告： 在开发环境中，启用 mysqli 的错误报告可以帮助我们及时发现并解决问题，而不是依赖 if 语句手动检查每个操作。

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);

这行代码会配置 mysqli 在发生错误时抛出 mysqli_sql_exception 异常，而不是仅仅返回 false。

2. 简化代码： 结合错误报告和面向对象风格，我们可以编写更简洁高效的代码。例如，使用 fetch_all(MYSQLI_ASSOC) 可以一次性获取所有结果，避免循环。

// 在代码的早期执行此配置，例如在连接数据库之前
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);

// 建立连接，通常在应用启动时一次性完成
$mysqli = new mysqli('localhost', 'root', '', 'ems');

/**
 * 从数据库中获取指定月份和年份的预订日期
 *
 * @param mysqli $mysqli 数据库连接对象
 * @param string $month 月份
 * @param string $year 年份
 * @return array 预订日期数组
 */
function build_calendar_optimized(mysqli $mysqli, string $month, string $year): array
{
    $stmt = $mysqli->prepare("SELECT event_date FROM bookings WHERE MONTH(event_date) = ? AND YEAR(event_date)=?");
    $stmt->bind_param('ss', $month, $year);
    $stmt->execute();
    $result = $stmt->get_result();
    // 使用 fetch_all(MYSQLI_ASSOC) 一次性获取所有结果
    // 注意：如果只需要 event_date 字段，可以只选择该字段
    $rows = $result->fetch_all(MYSQLI_ASSOC);

    // 从结果中提取 event_date 字段
    $bookings = array_column($rows, 'event_date');

    $stmt->close(); // 关闭语句
    return $bookings;
}

// 示例调用
try {
    $currentMonthBookings = build_calendar_optimized($mysqli, '01', '2023');
    print_r($currentMonthBookings);
} catch (mysqli_sql_exception $e) {
    echo "数据库操作失败: " . $e->getMessage();
} finally {
    // 确保在所有操作完成后关闭数据库连接
    if ($mysqli) {
        $mysqli->close();
    }
}

在这个优化后的版本中：

• 函数接受 mysqli 对象作为参数，避免在函数内部重复创建连接。
• 利用 mysqli_report 简化了错误处理。
• 使用 fetch_all(MYSQLI_ASSOC) 简化了结果集的获取，返回一个关联数组的数组。
• array_column 函数可以方便地从多维数组中提取指定列的值。
• 增加了 try-catch-finally 结构来优雅地处理异常和关闭连接。

进一步推荐：PDO

虽然 mysqli 的面向对象风格已经相当不错，但PHP还提供了另一个更强大、更通用的数据库抽象层：PDO (PHP Data Objects)。

PDO 的优势在于：

• 统一接口： 它为多种数据库（MySQL, PostgreSQL, SQLite, SQL Server等）提供了一个统一的接口，这意味着您可以在不改变太多代码的情况下切换数据库。
• 更简洁的预处理语句： PDO 的预处理语句API通常比 mysqli 更简洁、更直观。
• 更强大的错误处理： PDO 默认以抛出异常的方式处理错误，这与现代PHP的错误处理实践更加吻合。

如果您正在开始一个新项目，或者希望将数据库操作提升到一个新的水平，强烈建议学习和使用PDO。

总结

在PHP mysqli 的两种编程风格中，面向对象风格因其现代性、一致性和更简洁的API而成为首选。虽然可以将面向对象代码转换为过程式风格，但必须遵循正确的预处理语句流程，避免使用 mysqli_query() 处理带参数的查询。通过启用 mysqli_report 和使用 fetch_all 等功能，可以进一步优化 mysqli 代码。最终，为了更灵活、更强大的数据库操作，建议考虑采用PDO。选择合适的风格和工具，将有助于编写出更健壮、更易于维护的PHP应用程序。