(PHP 5, PHP 7)
mysqli_stmt::store_result -- mysqli_stmt_store_result — Передает результирующий набор запроса на клиента
Объектно-ориентированный стиль
Процедурный стиль
Функцию mysqli_stmt_store_result() нужно вызывать после выполнения запросов, возвращающих результирующий набор (SELECT, SHOW, DESCRIBE, EXPLAIN), и только если требуется сохранить результирующий набор целиком на клиенте. Далее, последовательные вызовы mysqli_stmt_fetch() будут возвращать уже буферизованные данные.
Замечание:
В остальных случаях вызывать mysqli_stmt_store_result() нет необходимости. Но если такой вызов совершен, ничего страшного не случится, это не повлияет на производительность и целостность данных. Чтобы убедиться, что запрос вернул результирующий набор, можно воспользоваться функцией mysqli_stmt_result_metadata(), которая в этом случае вернет NULL.
stmtТолько для процедурного стиля: Идентификатор выражения, полученный с помощью mysqli_stmt_init().
Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.
Пример #1 Объектно-ориентированный стиль
<?php
/* Открываем соединение */
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* Проверяем соединение */
if (mysqli_connect_errno()) {
printf("Не удалось подключиться: %s\n", mysqli_connect_error());
exit();
}
$query = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20";
if ($stmt = $mysqli->prepare($query)) {
/* выполняем запрос */
$stmt->execute();
/* передаем результат */
$stmt->store_result();
printf("Количество строк: %d.\n", $stmt->num_rows);
/* очищаем результат */
$stmt->free_result();
/* закрываем запрос */
$stmt->close();
}
/* закрываем соединение */
$mysqli->close();
?>
Пример #2 Процедурный стиль
<?php
/* Открываем соединение */
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
/* Проверяем соединение */
if (mysqli_connect_errno()) {
printf("Не удалось подключиться: %s\n", mysqli_connect_error());
exit();
}
$query = "SELECT Name, CountryCode FROM City ORDER BY Name LIMIT 20";
if ($stmt = mysqli_prepare($link, $query)) {
/* выполняем запрос */
mysqli_stmt_execute($stmt);
/* передаем результат */
mysqli_stmt_store_result($stmt);
printf("Количество строк: %d.\n", mysqli_stmt_num_rows($stmt));
/* очищаем результат */
mysqli_stmt_free_result($stmt);
/* закрываем запрос */
mysqli_stmt_close($stmt);
}
/* закрываем соединение */
mysqli_close($link);
?>
Результат выполнения данных примеров:
Количество строк: 20.