简体中文
简体中文
在使用 PHP 的 MySQLi 扩展进行数据库操作时，UPDATE 语句是最常用的 SQL 操作之一。然而，许多开发者在执行 UPDATE 操作时，常常忽略了一个关键细节：在执行更新之前，并未验证是否确实有匹配的记录。这种忽略，会直接影响到 mysqli::$affected_rows 属性的值，进而可能导致程序逻辑错误或异常行为。
在 MySQLi 中，每次执行数据修改操作（如 INSERT、UPDATE 或 DELETE）后，$mysqli->affected_rows 会返回受影响的行数。这个值在很多应用场景中被用于判断操作是否成功，或用于记录操作日志等。
例如：
<code> $mysqli = new mysqli("localhost", "user", "pass", "database");$mysqli->query("UPDATE users SET status = 'active' WHERE last_login < NOW() - INTERVAL 30 DAY");
echo $mysqli->affected_rows;
</code>
该代码会输出受影响的行数，即成功更新状态的用户数量。
当执行的 UPDATE 语句没有匹配任何记录时，$mysqli->affected_rows 会返回 0。这是因为没有任何记录被修改，无论语法是否正确、SQL 是否成功执行，受影响行数仍为 0。
注意：即使 SQL 语句语法完全正确，如果 WHERE 条件没有命中任何数据，affected_rows 依然为 0。这并不代表 SQL 执行失败。
例如：
<code> $mysqli = new mysqli("localhost", "user", "pass", "database");$mysqli->query("UPDATE users SET status = 'active' WHERE id = 999999");
echo $mysqli->affected_rows;
</code>
假设 id = 999999 的用户不存在，则输出将是 0，说明没有记录被更新。
此外，还有一种情况容易被误解：即使有记录被匹配，如果更新后的值与原值相同，也不会计入受影响的行数。
例如：
<code> $mysqli = new mysqli("localhost", "user", "pass", "database");$mysqli->query("UPDATE users SET status = 'active' WHERE status = 'active'");
echo $mysqli->affected_rows;
</code>
这段代码中，虽然可能匹配了许多行，但由于 status 字段原本就已经是 'active'，所以没有实际的数据修改动作发生，MySQL 会认为没有任何行被“影响”，返回 0。
如果你依赖 affected_rows 来判断操作是否成功，务必考虑以下两点：
SQL 执行是否成功（可通过 $mysqli->errno 或 $mysqli->error 判断）
affected_rows 是否为正值，表示确实有数据被修改
完整示例：
<code> $mysqli = new mysqli("localhost", "user", "pass", "database");$result = $mysqli->query("UPDATE users SET status = 'inactive' WHERE last_login < NOW() - INTERVAL 1 YEAR");
if ($result === false) {
die("SQL 错误：" . $mysqli->error);
} elseif ($mysqli->affected_rows > 0) {
echo "成功更新了 {$mysqli->affected_rows} 条记录。";
} else {
echo "没有记录被更新。";
}
</code>
在构建管理系统或接口时，开发者可能希望通过返回 affected_rows 来验证客户端传入的条件是否命中任何数据。如果没有事先提醒这一机制，可能会导致客户端错误地认为更新失败或服务端出错。
例如，一个接口：
<code> POST /api/update-status.php?user_id=123 HTTP/1.1 Host: m66.net </code>如果用户 ID 不存在，而接口代码仅根据 affected_rows 判断操作是否成功，客户端可能误认为系统出错。应通过更明确的响应信息告知是“无匹配记录”，而非“操作失败”。
在 PHP 的 MySQLi 操作中，$mysqli->affected_rows 是判断数据是否实际发生变动的重要手段。但需要注意的是：
没有匹配记录时，值为 0
匹配了记录但更新前后数据相同，也返回 0
SQL 执行错误不会反映在 affected_rows，需额外判断
开发者在使用这一属性时，应全面理解其行为，避免逻辑漏洞或误判更新结果。
