本教程旨在纠正php mysqli中对update等非select查询误用`mysqli_stmt_get_result`的常见错误。我们将探讨如何通过配置`mysqli_report`实现更健壮的错误报告机制，简化预处理语句的编写，并明确指出update操作无需获取结果集。同时，强调在重定向后使用`exit`的重要性，以确保代码逻辑的正确执行和安全性。
理解 MySQLi 预处理语句与结果集
在使用 PHP 的 MySQLi 扩展进行数据库操作时，预处理语句（Prepared Statements）是防止 SQL 注入的推荐方式。它将 SQL 查询的结构与数据分离，先准备查询模板，再绑定数据执行。然而，不同类型的 SQL 查询（如 SELECT、INSERT、UPDATE、DELETE）对结果的处理方式是不同的。
核心问题在于，mysqli_stmt_get_result() 函数专用于获取那些会返回结果集（Result Set）的查询，即 SELECT 语句。对于 UPDATE、INSERT 或 DELETE 这类数据操作语言（DML）语句，它们只返回受影响的行数或操作是否成功，并不会产生一个可遍历的结果集。因此，在 UPDATE 查询后尝试调用 mysqli_stmt_get_result() 将是无效的，并且会导致不必要的复杂性或错误。
优化错误报告机制
传统的 MySQLi 错误处理通常涉及在每个函数调用后手动检查返回值，例如 if (!mysqli_stmt_prepare($stmt, $sql))。这种方式不仅冗余，而且容易遗漏。通过配置 mysqli_report，我们可以让 MySQLi 在遇到错误时自动抛出异常，从而简化错误处理逻辑，并提高代码的健壮性。
在数据库连接之前，添加以下代码：
立即学习“PHP免费学习笔记（深入）”；
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
这行代码指示 MySQLi 在发生错误时抛出 mysqli_sql_exception 异常，并且以严格模式运行，这意味着所有警告也会被视为错误。启用此设置后，您将不再需要对每个 mysqli_ 函数调用进行手动错误检查，只需在更高级别的 try-catch 块中捕获异常即可。
重构 UPDATE 操作函数
基于上述理解和优化，我们可以对 updateAvatar 函数进行重构。原函数中存在以下问题：
- 在 UPDATE 查询后尝试使用 mysqli_stmt_get_result()、mysqli_fetch_assoc()。
- 冗余的错误检查（在启用 mysqli_report 后不再需要）。
- 在 header("location: ...") 后缺少 exit;。
以下是优化后的 updateAvatar 函数示例：
<?php
/**
* 更新用户头像功能
*
* @param mysqli $conn 数据库连接对象
* @param string $username 用户名
* @param string $avatar 头像JSON字符串 (包含文件信息)
* @return never 此函数通过重定向终止执行
*/
function updateAvatar(mysqli $conn, string $username, string $avatar): never
{
// 1. 定义 SQL UPDATE 查询语句
$sql = "UPDATE users SET avatar = ? WHERE username = ?;";
// 2. 直接准备语句，如果配置了 mysqli_report，错误将自动抛出异常
$stmt = mysqli_prepare($conn, $sql);
// 在这里，如果 $stmt 为 false，mysqli_report 会抛出异常，代码不会继续执行。
// 3. 绑定参数并执行语句
// "ss" 表示两个参数都是字符串类型
mysqli_stmt_bind_param($stmt, "ss", $avatar, $username);
mysqli_stmt_execute($stmt);
// 4. 处理文件上传（此部分与数据库操作逻辑分离）
// 假设 $avatar 是一个 JSON 字符串，包含文件上传的临时信息
$avatarData = json_decode($avatar, true);
if ($avatarData && isset($avatarData["tmp_name"][0]) && isset($avatarData["name"][0])) {
$uploadPath = '../assets/images/uploads/' . $avatarData["name"][0];
if (!move_uploaded_file($avatarData["tmp_name"][0], $uploadPath)) {
// 文件移动失败，可以记录日志或抛出自定义异常
// 为简化示例，此处不详细处理，但在实际应用中应妥善处理
error_log("Failed to move uploaded file: " . $avatarData["tmp_name"][0]);
}
} else {
// JSON 解析失败或缺少必要数据
error_log("Invalid avatar data provided: " . $avatar);
}
// 5. 关闭语句（可选，因为函数即将结束或通过异常处理）
// 对于 UPDATE/INSERT/DELETE 操作，通常在执行后即可关闭
mysqli_stmt_close($stmt);
// 6. 重定向用户并终止脚本执行
header("location: ../admin/account.php?success=update");
exit; // 必须在 header("location: ...") 之后调用 exit()
}
// 示例用法（假设 $conn, $username, $avatar 已定义）
// try {
// updateAvatar($conn, "testuser", '{"tmp_name":["/tmp/phpXYZ.tmp"],"name":["new_avatar.png"]}');
// } catch (mysqli_sql_exception $e) {
// // 处理数据库异常
// error_log("Database error: " . $e->getMessage());
// header("location: ../admin/account.php?error=db_error");
// exit;
// } catch (Exception $e) {
// // 处理其他异常
// error_log("Application error: " . $e->getMessage());
// header("location: ../admin/account.php?error=app_error");
// exit;
// }关键注意事项与最佳实践
- mysqli_stmt_get_result() 的适用性： 明确此函数仅用于 SELECT 查询。对于 UPDATE、INSERT、DELETE 等 DML 操作，您不需要获取结果集。如果您需要验证操作是否成功或获取受影响的行数，可以使用 mysqli_stmt_affected_rows($stmt)。
- mysqli_report 的重要性： 配置 mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT); 是现代 PHP MySQLi 开发的推荐做法。它将数据库错误转换为异常，使错误处理更加集中和高效，避免了分散的 if (!...) 检查。
- header("location: ...") 后跟 exit;： header() 函数仅仅是发送一个 HTTP 头给浏览器，它并不会停止脚本的执行。如果不在其后调用 exit;（或 die;），脚本会继续执行后续代码，这可能导致意外的行为、安全漏洞或双重重定向。
- 文件上传处理： 将文件上传逻辑与数据库操作逻辑适当分离，提高代码的可读性和可维护性。确保文件上传路径的安全性和权限设置。
- 类型声明： 在函数签名中使用类型声明（如 mysqli $conn, string $username, string $avatar, : never）可以提高代码的可读性、可维护性，并允许 IDE 进行更好的静态分析。never 返回类型提示表示函数永远不会返回，因为它总是通过 exit 终止脚本。
总结
通过理解 MySQLi 预处理语句的不同行为，并采用现代的错误报告机制，我们可以编写出更简洁、健壮且安全的数据库操作代码。对于 UPDATE、INSERT、DELETE 等非查询操作，避免使用 mysqli_stmt_get_result()，并始终记住在 HTTP 重定向后使用 exit; 来确保脚本的正确终止。
