MySQLi操作实战与风格转换解析

本文深入解析了 PHP 中 `mysqli` 数据库扩展的对象式与过程式两种编程风格的转换与数据库操作实践。针对 `mysqli` 对象式编程并非完全面向对象的特点，文章通过代码示例，详细阐述了如何将对象式代码转换为过程式，并指出了初学者常犯的错误。为了提升代码的健壮性和可维护性，强烈推荐使用 PDO 或简化版对象式 `mysqli`。此外，文章强调了错误报告的重要性，建议启用错误报告以便更好地捕获和处理错误，并推荐使用 `fetch_all` 简化结果集处理，从而提高开发效率和代码质量。

本文深入探讨了 `mysqli` 数据库扩展中对象式与过程式两种编程风格的转换与应用，并指出对象式 `mysqli` 并非真正的面向对象编程，但仍是推荐的现代实践。文章通过具体代码示例演示了如何将对象式 `mysqli` 转换为过程式，并剖析了常见错误。同时，强烈建议采用 PDO 或简化版对象式 `mysqli`，以提升代码的健壮性和可维护性，强调了错误报告的重要性，并推荐使用 `fetch_all` 简化结果集处理。

mysqli 数据库扩展的两种编程风格

mysqli 扩展提供了两种与 MySQL 数据库交互的编程风格：对象式（Object-Oriented Style）和过程式（Procedural Style）。这两种风格在功能上是等价的，主要区别在于函数的调用方式和参数传递。

• 对象式风格：通过创建 mysqli 类的实例，然后调用该实例的方法来执行数据库操作。例如：$mysqli->prepare()。
• 过程式风格：直接调用以 mysqli_ 或 mysqli_stmt_ 开头的函数，通常需要将 mysqli 连接对象或 mysqli_stmt 语句对象作为第一个参数传入。例如：mysqli_prepare($mysqli, ...)。

值得注意的是，使用对象式 mysqli 并不意味着您的代码就是完全面向对象的。它仅仅是提供了一种更现代、更结构化的 API 调用方式，而无需深入理解完整的 OOP 范式。

对象式 mysqli 到过程式的转换

将对象式 mysqli 代码转换为过程式风格，核心在于将对象方法调用替换为对应的全局函数，并确保将 mysqli 连接对象或语句对象作为第一个参数传递。

以下是常见的对象式 mysqli 方法及其对应的过程式函数：

根据上述映射规则，将以下对象式 mysqli 代码：

function build_calendar($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();
        }
    }
    // ... 其他逻辑
}

转换为过程式风格，其代码如下：

function build_calendar_procedural($month, $year)
{
    $mysqli = mysqli_connect('localhost', 'root', '', 'ems');
    // 检查连接是否成功
    if (mysqli_connect_errno()) {
        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_query() 函数，例如：

$connection = mysqli_connect('localhost', 'root', '', 'ems');
$query = "SELECT * FROM bookings WHERE MONTH(event_date) = ? AND YEAR(event_date)=?";
$get_dates = mysqli_query($connection, $query); // 错误用法！

这会导致 mysqli_fetch_assoc() 接收到的 $result 参数类型不正确，从而抛出 TypeError。mysqli_query() 函数适用于执行简单的、非预处理的 SQL 语句，或者已经将参数直接嵌入到 SQL 字符串中的语句（但这容易导致 SQL 注入）。对于带有占位符（?）的参数化查询，必须使用预处理语句（mysqli_prepare、mysqli_stmt_bind_param、mysqli_stmt_execute 等）来安全地执行。

推荐的现代数据库操作实践

尽管 mysqli 提供了两种风格，但为了代码的健壮性、可维护性和安全性，我们强烈推荐以下实践：

1. 优先使用 PDO

PHP Data Objects (PDO) 是一个更通用、更灵活的数据库抽象层，它支持多种数据库系统（如 MySQL, PostgreSQL, SQLite 等）。PDO 提供了统一的 API，使得在不同数据库之间切换更加容易，并且在预处理语句方面提供了更简洁、更强大的功能。

以下是使用 PDO 实现相同功能的示例：

function build_calendar_pdo(PDO $pdo, $month, $year): array
{
    $stmt = $pdo->prepare("SELECT event_date FROM bookings WHERE MONTH(event_date) = :month AND YEAR(event_date) = :year");
    $stmt->bindParam(':month', $month, PDO::PARAM_INT);
    $stmt->bindParam(':year', $year, PDO::PARAM_INT);
    $stmt->execute();
    return $stmt->fetchAll(PDO::FETCH_COLUMN); // 直接获取所有event_date列的值
}

// 示例连接和调用
try {
    $pdo = new PDO('mysql:host=localhost;dbname=ems;charset=utf8mb4', 'root', '');
    $pdo->setAttribute(PDO::ATTR_ERRMODE, PDO::ERRMODE_EXCEPTION); // 设置错误模式为抛出异常
    $bookings = build_calendar_pdo($pdo, 1, 2020);
    // var_dump($bookings);
} catch (PDOException $e) {
    die("数据库操作失败: " . $e->getMessage());
}

PDO 的优势在于其统一的接口、更强大的错误处理机制和更好的灵活性。

2. 简化和优化对象式 mysqli

如果您确实需要使用 mysqli 且不打算转向 PDO，可以通过以下方式简化和优化对象式 mysqli 代码：

a. 启用错误报告

默认情况下，mysqli 的错误处理可能不够直观。通过设置 mysqli_report，可以让 mysqli 在发生错误时抛出异常，从而更好地捕获和处理错误。

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli('localhost', 'root', '', 'ems');
// 此时如果连接失败，将直接抛出异常，无需手动检查 mysqli_connect_errno()

MYSQLI_REPORT_ERROR 会报告操作错误，而 MYSQLI_REPORT_STRICT 会将警告转换为异常，这使得错误处理更加一致和可靠。

b. 使用 fetch_all 简化结果集处理

对于需要获取所有结果集的场景，mysqli_result::fetch_all() 方法可以大大简化代码，避免手动循环 fetch_assoc()。

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli('localhost', 'root', '', 'ems');

function build_calendar_simplified(mysqli $mysqli, $month, $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();
    return $result->fetch_all(MYSQLI_ASSOC); // 获取所有行作为关联数组
}

// 示例调用
$bookings = build_calendar_simplified($mysqli, 1, 2020);
// var_dump($bookings);

在这个简化版本中，函数签名中明确了 $mysqli 参数的类型为 mysqli 对象，这增加了代码的可读性和健壮性。fetch_all(MYSQLI_ASSOC) 会直接返回一个包含所有结果行的二维关联数组，省去了手动循环和构建数组的步骤。

总结

在 mysqli 的对象式和过程式风格之间，虽然过程式风格可以实现相同的功能，但对象式风格通常被认为是更现代、更易于维护的选择。然而，无论选择哪种风格，都应遵循预处理语句的最佳实践来防止 SQL 注入。更进一步，我们强烈推荐使用 PDO 进行数据库操作，因为它提供了更高级的抽象、更统一的接口和更强大的错误处理机制。如果坚持使用 mysqli，请务必启用错误报告并利用 fetch_all 等功能来简化代码，提升开发效率和代码质量。

终于介绍完啦！小伙伴们，这篇关于《MySQLi操作实战与风格转换解析》的介绍应该让你收获多多了吧！欢迎大家收藏或分享给更多需要学习的朋友吧~golang学习网公众号也会发布文章相关知识，快来关注吧！