mysqli_stmt::get_result

    mysqli_stmt_get_result

    (PHP 5 >= 5.3.0, PHP 7, PHP 8)

    mysqli_stmt::get_result -- mysqli_stmt_get_result — Получает результат из подготовленного запроса в виде объекта mysqli_result

    Описание

    Объектно-ориентированный стиль

    publicmysqli_stmt::get_result(): mysqli_result|false

    Процедурный стиль

    mysqli_stmt_get_result(mysqli_stmt$statement): mysqli_result|false

    Извлекает набор результатов из подготовленного запроса в виде объекта mysqli_result. Данные будут загружены с сервера MySQL в PHP. Метод следует вызывать только для запросов, которые производят набор результатов.

    Замечание:

    Доступно только с модулем mysqlnd.

    Замечание:

    Эту функцию нельзя использовать совместно с mysqli_stmt_store_result(). Обе эти функции получают полный набор результатов с сервера MySQL.

    Список параметров

    stmt

    Только для процедурного стиля: объект mysqli_stmt, который вернула функция mysqli_stmt_init().

    Возвращаемые значения

    Возвращает false в случае возникновения ошибки. Для успешных запросов, которые производят набор результатов, таких как SELECT, SHOW, DESCRIBE или EXPLAINmysqli_stmt_get_result() вернёт объект mysqli_result. Для других успешных запросов mysqli_stmt_get_result() вернёт false. Функцию mysqli_stmt_errno() можно использовать, чтобы различать две причины появления false; из-за ошибки до PHP 7.4.13 для этой цели приходилось использовать mysqli_errno().

    Ошибки

    Если уведомления об ошибках mysqli включены (MYSQLI_REPORT_ERROR) и запрошенная операция не удалась, выдаётся предупреждение. Если, кроме того, установлен режим MYSQLI_REPORT_STRICT, вместо этого будет выброшено исключение mysqli_sql_exception.

    Примеры

    Пример #1 Объектно-ориентированный стиль

    <?php

    mysqli_report    (MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
    $mysqli = new mysqli("localhost", "my_user", "my_password", "world");

    $query = "SELECT Name, Population, Continent FROM Country WHERE Continent=? ORDER BY Name LIMIT 1";

    $stmt = $mysqli->prepare($query);
    $stmt->bind_param("s", $continent);

    $continentList = array('Europe', 'Africa', 'Asia', 'North America');

    foreach (    $continentList as $continent) {
    $stmt->execute();
    $result = $stmt->get_result();
    while (    $row = $result->fetch_array(MYSQLI_NUM)) {
    foreach (    $row as $r) {
    print     "$r ";
    }
    print     "\n";
    }
    }

    Пример #2 Процедурный стиль

    <?php

    mysqli_report    (MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);
    $link = mysqli_connect("localhost", "my_user", "my_password", "world");

    $query = "SELECT Name, Population, Continent FROM Country WHERE Continent=? ORDER BY Name LIMIT 1";

    $stmt = mysqli_prepare($link, $query);
    mysqli_stmt_bind_param($stmt, "s", $continent);

    $continentList= array('Europe', 'Africa', 'Asia', 'North America');

    foreach (    $continentList as $continent) {
    mysqli_stmt_execute($stmt);
    $result = mysqli_stmt_get_result($stmt);
    while (    $row = mysqli_fetch_array($result, MYSQLI_NUM)) {
    foreach (    $row as $r) {
    print     "$r ";
    }
    print     "\n";
    }
    }

    Вывод приведённых примеров будет похож на: 

    Albania 3401200 Europe Algeria 31471000 Africa Afghanistan 22720000 Asia Anguilla 8000 North America

    Смотрите также

    • mysqli_prepare() - Подготавливает SQL выражение к выполнению
    • mysqli_stmt_result_metadata() - Возвращает метаданные результирующей таблицы подготавливаемого запроса
    • mysqli_stmt_fetch() - Связывает результаты подготовленного выражения с переменными
    • mysqli_fetch_array() - Выбирает следующую строку из набора результатов и помещает её в ассоциативный массив, обычный массив или в оба
    • mysqli_stmt_store_result() - Сохраняет набор результатов во внутреннем буфере
    To Top