PHP MySQLi 编程风格解析:从面向对象到过程化及最佳实践

心靈之曲
发布: 2025-11-08 12:56:10
原创
738人浏览过

PHP MySQLi 编程风格解析:从面向对象到过程化及最佳实践

本文深入探讨了 php mysqli 扩展的两种编程风格:面向对象(oo)和过程化。我们将对比这两种风格的语法差异,演示如何正确地在它们之间进行转换,并强调在现代 php 开发中,面向对象风格是更推荐的选择,因为它提供了更清晰、更易维护的代码结构。同时,文章也介绍了优化 mysqli 使用的技巧,并推荐了更强大的数据库抽象层 pdo。

MySQLi 编程风格概述

PHP 的 MySQLi 扩展提供了两种主要的方式来与 MySQL 数据库进行交互:面向对象(Object-Oriented, OO)风格和过程化(Procedural)风格。虽然面向对象风格的名称中包含“面向对象”,但它并不要求开发者完全掌握面向对象编程(OOP)范式,它更多地是提供了一种更现代、更直观的 API 接口。过程化风格则更接近于传统的 PHP MySQL 函数,通常需要将连接对象作为第一个参数传递给函数。

对于新的项目和代码库,强烈建议使用面向对象风格。过程化风格最初设计的主要目的是帮助开发者从旧的 mysql_* 函数迁移到 MySQLi,而不是作为新代码的首选。

理解面向对象与过程化风格的差异

两种风格的核心功能是相同的,主要区别在于函数调用的语法和参数传递方式。在面向对象风格中,方法通过对象实例调用;而在过程化风格中,函数直接调用,并将连接或语句对象作为第一个参数。

以下是两种风格中等效操作的对比:

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

功能 面向对象风格 过程化风格
准备语句 $stmt = $mysqli->prepare($query); $stmt = mysqli_prepare($mysqli, $query);
绑定参数 $stmt->bind_param($types, ...$params); mysqli_stmt_bind_param($stmt, $types, ...$params);
执行语句 $stmt->execute(); mysqli_stmt_execute($stmt);
获取结果集 $result = $stmt->get_result(); $result = mysqli_stmt_get_result($stmt);
获取行数 $result->num_rows; mysqli_num_rows($result);
获取关联数组 $row = $result->fetch_assoc(); $row = mysqli_fetch_assoc($result);
关闭语句 $stmt->close(); mysqli_stmt_close($stmt);

从上面的对比可以看出,过程化风格的函数名通常以 mysqli_ 开头,并且需要显式地传递 MySQLi 对象(如 $mysqli 或 $stmt)作为其第一个参数。

将面向对象代码转换为过程化风格

假设我们有一个使用面向对象风格编写的函数,用于从数据库中获取预订日期:

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_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);
        }
    } else {
        die("语句执行失败: " . mysqli_stmt_error($stmt));
    }

    // 关闭语句和连接
    mysqli_stmt_close($stmt);
    mysqli_close($mysqli);

    return $bookings;
}
登录后复制

错误解析:

用户在尝试转换时遇到了 Fatal error: Uncaught TypeError: mysqli_fetch_assoc(): Argument #1 ($result) must be of type mysqli_result 错误。这是因为用户尝试将 mysqli_query 与占位符(?)一起使用,这是不正确的。mysqli_query 不支持预处理语句中的占位符。它用于执行简单的 SQL 查询,或者已经完全构建好的 SQL 字符串。当使用预处理语句时,必须通过 mysqli_prepare、mysqli_stmt_bind_param 和 mysqli_stmt_execute 等函数来处理。mysqli_fetch_assoc 期望的是一个 mysqli_result 对象,而直接使用 mysqli_query 配合占位符并不会返回一个有效的 mysqli_result 对象供预处理语句使用。

豆包AI编程
豆包AI编程

豆包推出的AI编程助手

豆包AI编程 483
查看详情 豆包AI编程

推荐的 MySQLi 实践与简化

无论选择哪种风格,都应遵循一些最佳实践来提高代码的健壮性和可维护性。

1. 错误报告

为了更好地调试和处理错误,建议在脚本开始时启用 MySQLi 的错误报告:

mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
登录后复制

这会在发生 MySQLi 错误时抛出 mysqli_sql_exception 异常,而不是默默失败或只返回 false,从而更容易捕获和处理错误。

2. 简化面向对象风格的代码

使用面向对象风格时,可以通过一些方法进一步简化代码,例如使用 fetch_all 来一次性获取所有结果:

// 启用错误报告
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);

// 建立数据库连接
$mysqli = new mysqli('localhost', 'root', '', 'ems');

/**
 * 构建日历预订日期数组
 *
 * @param mysqli $mysqli 数据库连接对象
 * @param int $month 月份
 * @param int $year 年份
 * @return array 预订日期数组
 */
function build_calendar_simplified(mysqli $mysqli, int $month, int $year): array
{
    $stmt = $mysqli->prepare("SELECT event_date FROM bookings WHERE MONTH(event_date) = ? AND YEAR(event_date)=?");
    $stmt->bind_param('ii', $month, $year); // 注意:如果月份和年份是整数,应使用 'ii'
    $stmt->execute();

    // 获取所有结果并以关联数组形式返回
    $result = $stmt->get_result();
    return $result->fetch_all(MYSQLI_ASSOC);
}

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

// 关闭连接
$mysqli->close();
登录后复制

在这个简化版本中:

  • 我们将 $mysqli 连接对象作为参数传递给函数,这是一种更好的实践,避免了在函数内部重复创建连接。
  • 使用 fetch_all(MYSQLI_ASSOC) 一次性获取所有结果行,并以关联数组的形式返回,大大简化了结果集的处理。
  • 参数类型 bind_param 从 ss 改为 ii,因为月份和年份通常是整数类型。

推荐:使用 PDO 扩展

尽管 MySQLi 的面向对象风格是一个不错的选择,但更推荐的 PHP 数据库抽象层是 PDO (PHP Data Objects)。PDO 提供了一个轻量级、一致的接口来访问多种数据库,而不仅仅是 MySQL。它的主要优势包括:

  • 数据库无关性: 相同的 API 可以用于 MySQL, PostgreSQL, SQLite 等多种数据库。
  • 更好的错误处理: 通过异常机制提供更健壮的错误报告。
  • 更简洁的 API: 通常比 MySQLi 提供更直观和简洁的代码。
  • 命名参数支持: 除了位置参数,还支持命名参数,使查询更具可读性。

如果您正在开始一个新的项目,或者有机会重构现有代码,学习和使用 PDO 将是一个非常有益的投资。

总结

在 PHP 中进行数据库操作时,理解 MySQLi 的面向对象和过程化风格至关重要。尽管过程化风格可以实现相同的功能,但面向对象风格因其更清晰的语法、更好的可读性和维护性而成为现代 PHP 开发的首选。始终使用预处理语句来防止 SQL 注入,并考虑启用 MySQLi 的错误报告。对于追求更高灵活性和一致性的开发者,PDO 是一个更强大、更推荐的数据库抽象层。

以上就是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号