PHP mysqli:从面向对象到过程式风格的转换与最佳实践

聖光之護
发布: 2025-11-05 13:37:35
原创
856人浏览过

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 方法的等效示例:

立即学习PHP免费学习笔记(深入)”;

// 面向对象风格
$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),释放系统资源。

常见错误及原因分析

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

吉卜力风格图片在线生成
吉卜力风格图片在线生成

将图片转换为吉卜力艺术风格的作品

吉卜力风格图片在线生成 121
查看详情 吉卜力风格图片在线生成
// 错误的尝试
$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应用程序。

以上就是PHP mysqli:从面向对象到过程式风格的转换与最佳实践的详细内容,更多请关注php中文网其它相关文章!

PHP速学教程(入门到精通)
PHP速学教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载
来源:php中文网
本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn
最新问题
开源免费商场系统广告
热门教程
更多>
最新下载
更多>
网站特效
网站源码
网站素材
前端模板
关于我们 免责申明 意见反馈 讲师合作 广告合作 最新更新 English
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送
PHP中文网APP
随时随地碎片化学习

Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号