本文深入探讨了 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 对象供预处理语句使用。
推荐的 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 是一个更强大、更推荐的数据库抽象层。
