
本文深入探讨了 php mysqli 扩展的两种编程风格:面向对象(oo)和过程化。我们将对比这两种风格的语法差异,演示如何正确地在它们之间进行转换,并强调在现代 php 开发中,面向对象风格是更推荐的选择,因为它提供了更清晰、更易维护的代码结构。同时,文章也介绍了优化 mysqli 使用的技巧,并推荐了更强大的数据库抽象层 pdo。
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 的错误报告:
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
这会在发生 MySQLi 错误时抛出 mysqli_sql_exception 异常,而不是默默失败或只返回 false,从而更容易捕获和处理错误。
使用面向对象风格时,可以通过一些方法进一步简化代码,例如使用 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 的面向对象风格是一个不错的选择,但更推荐的 PHP 数据库抽象层是 PDO (PHP Data Objects)。PDO 提供了一个轻量级、一致的接口来访问多种数据库,而不仅仅是 MySQL。它的主要优势包括:
如果您正在开始一个新的项目,或者有机会重构现有代码,学习和使用 PDO 将是一个非常有益的投资。
在 PHP 中进行数据库操作时,理解 MySQLi 的面向对象和过程化风格至关重要。尽管过程化风格可以实现相同的功能,但面向对象风格因其更清晰的语法、更好的可读性和维护性而成为现代 PHP 开发的首选。始终使用预处理语句来防止 SQL 注入,并考虑启用 MySQLi 的错误报告。对于追求更高灵活性和一致性的开发者,PDO 是一个更强大、更推荐的数据库抽象层。
以上就是PHP MySQLi 编程风格解析:从面向对象到过程化及最佳实践的详细内容,更多请关注php中文网其它相关文章!
PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!
Copyright 2014-2025 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号