本文深入探讨了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)，释放系统资源。
常见错误及原因分析
在尝试从面向对象风格转换为过程式风格时，一个常见的错误尝试如下：
// 错误的尝试
$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应用程序。
