将 mysqli_result 封装成通用数据访问层

M66 2025-05-17

在开发 PHP 应用时，mysqli 扩展是与 MySQL 数据库进行交互的常用方式。随着项目的不断扩展，直接使用 mysqli 函数可能会导致代码的重复、耦合性高、难以维护。为了提升代码复用性和可维护性，我们可以将 mysqli_result 函数封装成一个通用的数据访问层。

本文将介绍如何封装 mysqli_result 函数，并提供代码示例，帮助你构建一个高效、易于维护的数据访问层。

1. 数据访问层的设计目标

数据访问层的设计目的是使得数据库操作与业务逻辑分离，使得数据库的访问逻辑不直接出现在应用的业务代码中。通过封装数据库操作，可以提高代码的复用性、可维护性，并降低后期更换数据库的难度。

以下是设计数据访问层时需要考虑的几点：

封装数据库连接：避免每次操作数据库时都需要重复编写连接代码。
简化查询结果处理：将 mysqli_result 的操作封装，统一处理查询结果。
支持 CRUD 操作：支持常见的增、删、改、查操作。
提高代码复用性：通过封装，使得数据库操作代码复用性更高，减少代码冗余。

2. 创建数据库类

首先，我们需要创建一个数据库类来管理数据库的连接和查询操作。

class Database {
    private $connection;
    
    // 构造函数初始化数据库连接
    public function __construct($host, $user, $password, $dbname) {
        $this->connection = new mysqli($host, $user, $password, $dbname);
        
        if ($this->connection->connect_error) {
            die("连接失败: " . $this->connection->connect_error);
        }
    }

    // 执行查询，返回结果集
    public function query($sql) {
        $result = $this->connection->query($sql);
        if (!$result) {
            die("查询失败: " . $this->connection->error);
        }
        return $result;
    }

    // 关闭数据库连接
    public function close() {
        $this->connection->close();
    }
}

上述代码中，我们封装了一个 Database 类，该类具有一个构造函数用于初始化数据库连接，以及一个 query 方法用于执行 SQL 查询并返回结果集。

3. 封装 mysqli_result 结果集

mysqli_result 是 mysqli 中用于存储查询结果的一个对象。在我们构建数据访问层时，通常需要封装 mysqli_result，使得结果集的操作更加简洁。

以下是如何封装 mysqli_result 的代码示例：

class DbResult {
    private $result;

    // 构造函数接收查询结果
    public function __construct($result) {
        $this->result = $result;
    }

    // 获取所有结果
    public function fetchAll() {
        $rows = [];
        while ($row = $this->result->fetch_assoc()) {
            $rows[] = $row;
        }
        return $rows;
    }

    // 获取单行结果
    public function fetchOne() {
        return $this->result->fetch_assoc();
    }

    // 获取结果的行数
    public function numRows() {
        return $this->result->num_rows;
    }
}

在上述代码中，DbResult 类封装了 mysqli_result 对象，并提供了以下方法：

fetchAll()：获取所有查询结果。
fetchOne()：获取单条查询结果。
numRows()：返回查询结果的行数。

4. 完整的数据访问层示例

将数据库类和结果集封装类结合，我们可以创建一个功能完整的数据访问层，如下所示：

class DataAccessLayer {
    private $db;

    // 构造函数初始化数据库连接
    public function __construct($host, $user, $password, $dbname) {
        $this->db = new Database($host, $user, $password, $dbname);
    }

    // 查询数据并返回封装后的结果集
    public function fetchData($sql) {
        $result = $this->db->query($sql);
        $dbResult = new DbResult($result);
        return $dbResult;
    }

    // 插入数据
    public function insertData($sql) {
        return $this->db->query($sql);
    }

    // 更新数据
    public function updateData($sql) {
        return $this->db->query($sql);
    }

    // 删除数据
    public function deleteData($sql) {
        return $this->db->query($sql);
    }

    // 关闭连接
    public function close() {
        $this->db->close();
    }
}

在这个例子中，DataAccessLayer 类封装了常见的数据库操作，如查询、插入、更新和删除。我们使用 DbResult 类来封装查询结果，使得结果的操作更加方便。

5. 使用数据访问层

现在我们可以在业务代码中使用封装好的数据访问层：

// 创建数据库访问对象
$dal = new DataAccessLayer('localhost', 'root', '', 'test_db');

// 查询数据
$sql = "SELECT * FROM users";
$dbResult = $dal->fetchData($sql);

// 获取查询结果
$users = $dbResult->fetchAll();
foreach ($users as $user) {
    echo $user['username'] . "<br>";
}

// 关闭数据库连接
$dal->close();

这样，我们就能方便地执行数据库操作，而不需要在每个页面中重复编写连接、查询结果处理等逻辑。

6. 总结

通过封装 mysqli_result 结果集和数据库连接，我们创建了一个通用的数据访问层。这个数据访问层使得数据库操作更加简洁、可复用，并且提高了代码的可维护性。你可以根据自己的业务需求进一步扩展这个数据访问层，支持更多的数据库操作，如事务管理、批量插入等。

如果你希望更加灵活的管理数据库连接，可以引入单例模式来避免多次创建数据库连接。

希望本篇文章能够帮助你构建更为高效、可维护的数据库操作层，提高你的开发效率。