当前位置:

首页 > 编程开发 > PHP mysqli:面向对象与过程式转换指南

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

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

本文目录

    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应用程序。

    本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系bd@zhengruan.com
    作者最新文章
    编程开发
    相关文章 更多
    Ducter 0.0.56继续手机任务时工具怎样恢复,回复语言为何不再错位
    Ducter 0.0.56继续手机任务时工具怎样恢复,回复语言为何不再错位

    Ducter 0.0.56修复已结束手机任务续跑时的工具缺失,并避免点击其他Agent请求卡片后回复语言错位。

    Plannotator 0.28.65的账号限制和Inbox存储变化怎样理解
    Plannotator 0.28.65的账号限制和Inbox存储变化怎样理解

    Plannotator 0.28.65收紧Tailscale所有者账号访问、迁回文件存储,Take back只适用于尚未交付回复。

    WorkBuddy怎么用API接口?有开发文档吗
    WorkBuddy怎么用API接口?有开发文档吗

    WorkBuddy 目前没有面向普通用户的公开 REST API 接口文档,扩展与集成走四条官方路径:接入 MCP 服务扩展工具能力、用连接器打通外部应用(支持公共/个人授权)、编写技能(Skill)与专家包定制工作流、在开放平台发布 Buddy 应用。另支持接入 OpenAI 兼容的自定义模型。本文含 4 张真实界面截图并如实说明现状。

    Google Workspace MCP OAuth 2.0迁移节点已过,旧客户端、普通REST与服务账户分别适用什么规则
    Google Workspace MCP OAuth 2.0迁移节点已过,旧客户端、普通REST与服务账户分别适用什么规则

    解释Google Workspace MCP 11月11日与12日的agentic OAuth客户端迁移节点,区分普通REST应用、混合客户端、预览资格、用户权限和服务账户、Apps Script边界。

    OpenAI Agents SDK v0.24.0-alpha.8升级前为何要备份状态?
    OpenAI Agents SDK v0.24.0-alpha.8升级前为何要备份状态?

    OpenAI Agents SDK v0.24.0-alpha.8预览版新增执行前审批、自有模型客户端、Realtime与预算检查点恢复,说明alpha.7回退、Linux运行及工具认证边界。

    Claude Trading Skills六项诊断修复覆盖哪些密钥泄漏路径?
    Claude Trading Skills六项诊断修复覆盖哪些密钥泄漏路径?

    Claude Trading Skills六项技能已修复API密钥异常日志泄漏路径;not_verified保留完整安全审核缺口,离线回归通过不等于实盘验收或全面认证。

    Microsoft C++ Language Server内置MSBuild提取器后,自动化范围和使用资格怎样理解
    Microsoft C++ Language Server内置MSBuild提取器后,自动化范围和使用资格怎样理解

    解释Microsoft C++ Language Server预览版的MSBuild编译数据库自动提取,区分CMake、自定义构建、有效Copilot订阅和CLI能力,避免把测试预发布版本当最低稳定版。

    LibreOffice宏怎么用?Python脚本能调用吗
    LibreOffice宏怎么用?Python脚本能调用吗

    LibreOffice可通过“工具→宏”创建和运行Basic宏,也支持由Python脚本提供程序运行Python宏。两种方式都可以使用UNO接口操作文档;Excel VBA只有有限兼容支持,不能把所有Excel宏直接复制过来当作LibreOffice原生宏执行。

    GitHub企业Copilot席位API开放应用调用后,读取和席位变更有什么区别
    GitHub企业Copilot席位API开放应用调用后,读取和席位变更有什么区别

    说明Enterprise GitHub Apps的Copilot席位管理权限,提供第一页只读GET示例,区分total_seats、授权明细、遥测活动和待取消计费条件。

    GitHub网页仪表盘默认视图、单行标题和六项列表分别改变什么
    GitHub网页仪表盘默认视图、单行标题和六项列表分别改变什么

    解释GitHub网页仪表盘Feed或Home默认视图、六项列表、自定义选择保留和Agent sessions隐藏条件,区分布局、数据与权限。

    查看更多
    精品专题 更多
    装机必备
    装机必备

    正软商城装机必备专区,精选办公、浏览器、安全防护、影音播放、压缩解压、设计创作和系统工具等电脑常用正版软件,帮助用户快速完成新电脑软件配置。

    Windows
    Windows

    正软商城Windows软件专区,汇集适用于Windows电脑的办公、设计、安全防护、影音播放、开发工具和系统优化软件,提供软件介绍、系统要求、正版授权及购买下载服务。

    PDF教程
    PDF教程

    正软商城PDF教程频道提供PDF编辑、转换、合并、拆分、压缩及格式处理方法,同时介绍常用PDF软件和工具的使用技巧。

    Mac软件 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    Aperty macOS版
    Aperty macOS版
    macOS

    Aperty 是 Skylum 推出的 AI 人像修图软件,支持自然肤质修饰、瑕疵处理、面部与身体调整、预设及批量同步。

    WINDOWS 更多
    讯飞智作 网页版
    讯飞智作 网页版
    Windows/ macOS/ Linux

    讯飞智作是一款基于语音合成技术、虚拟人驱动技术与数字人形象声音构建能力的 AI 数字人音视频创作平台。

    火山引擎 网页版
    火山引擎 网页版
    Windows/ macOS/ Linux

    火山引擎是字节跳动旗下企业级云与AI服务平台。聚焦大模型核心能力,依托字节自研豆包多模态大模型,凭借火山方舟一站式平台,提供模型精调、推理部署、智能应用搭建等全链路服务,结合高性能AI算力,助力各行业快速落地大模型数字化与智能化应用。

    PixTV 网页版
    PixTV 网页版
    Windows

    PixTV 是一款在浏览器中使用的 AI 视觉内容创作平台,提供图片、视频、音频、文字生成、AI 分镜、局部重绘、提示词反推和无限画布等工具,适合短剧、漫剧、广告及社交媒体内容制作。