(PHP 5, PHP 7, PHP 8)
mysqli_stmt::$affected_rows -- mysqli_stmt_affected_rows — Возвращает общее количество строк, изменённых, удалённых, вставленных или сопоставленных последним выполненным выражением
Объектно-ориентированный стиль
Процедурный стиль
Возвращает количество строк, изменённых запросом INSERT,
UPDATE или DELETE.
Работает аналогично mysqli_stmt_num_rows() для выражений SELECT.
stmtТолько для процедурного стиля: объект mysqli_stmt, полученный с помощью mysqli_stmt_init().
Целое число больше нуля указывает количество затронутых или извлечённых строк.
Ноль означает, что записи для оператора UPDATE не обновлялись,
ни одна строка не соответствовала выражению WHERE в запросе
или что ни один запрос ещё не был выполнен.
-1 означает, что во время выполнения запроса произошла ошибка
или что для запроса SELECT, mysqli_stmt_affected_rows()
была вызваны до вызова mysqli_stmt_store_result().
Замечание:
Если количество изменённых строк больше, чем максимальное значение для целого числа в PHP, то это количество будет возвращено в виде строкового значения.
Пример #1 Пример использования mysqli_stmt_affected_rows()
Объектно-ориентированный стиль
<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* создание временной таблицы */
$mysqli->query("CREATE TEMPORARY TABLE myCountry LIKE Country");
$query = "INSERT INTO myCountry SELECT * FROM Country WHERE Code LIKE ?";
/* подготовка выражения */
$stmt = $mysqli->prepare($query);
/* связывание переменных */
$code = 'A%';
$stmt->bind_param("s", $code);
/* выполнение выражения */
$stmt->execute();
printf("Добавлено строк: %d\n", $stmt->affected_rows);
?>
Процедурный стиль
<?php
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
/* создание временной таблицы */
mysqli_query($link, "CREATE TEMPORARY TABLE myCountry LIKE Country");
$query = "INSERT INTO myCountry SELECT * FROM Country WHERE Code LIKE ?";
/* подготовка выражения */
$stmt = mysqli_prepare($link, $query);
/* связывание переменных */
$code = 'A%';
mysqli_stmt_bind_param($stmt, "s", $code);
/* выполнение выражения */
mysqli_stmt_execute($stmt);
printf("Добавлено строк: %d\n", mysqli_stmt_affected_rows($stmt));
?>
Результат выполнения данных примеров:
Добавлено строк: 17
It appears that an UPDATE prepared statement which contains the same data as that already in the database returns 0 for affected_rows. I was expecting it to return 1, but it must be comparing the input values with the existing values and determining that no UPDATE has occurred.
I'm not sure whether or not this is the intended behavior, but I noticed through testing that if you were to use transactions and prepared statements together and you added a single record to a database using a prepared statement, but later rolled it back, mysqli_stmt_affected_rows will still return 1.
