mysqli_stmt::get_result

mysqli_stmt_get_result

プリペアドステートメントから結果を mysqli_result オブジェクトとして取得する

説明

オブジェクト指向型

public mysqli_resultfalse mysqli_stmt::get_result()

手続き型

mysqli_resultfalse mysqli_stmt_get_result(mysqli_stmt $statement)

プリペアドステートメントから結果を mysqli_result オブジェクトとして取得します。データは MySQLサーバーからPHPへ転送されます。このメソッドは結果セットを生成するクエリの場合にだけコールされるべきです。

注意:
mysqlnd でのみ使用可能です。

注意:
この関数は、 mysqli_stmt_store_result と一緒に使うことはできません。これらの関数は両方、MySQLサーバーから完全な結果セットを取得します。

パラメータ

stmt: 手続き型のみ: mysqli_stmt_init が返す mysqli_stmt オブジェクト。

戻り値

失敗した場合に false を返します。結果セットを生成するクエリ、つまり SELECT, SHOW, DESCRIBE あるいは EXPLAIN が成功した場合は、mysqli_stmt_get_result は mysqli_result オブジェクトを返します。それ以外のクエリが成功した場合は、 mysqli_stmt_get_result は false を返します。 PHP 7.4.13 より前のバージョンでは、その他の DML クエリを実行したのかクエリの実行に失敗したのかを区別するのに、 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
mysqli_stmt_result_metadata
mysqli_stmt_fetch
mysqli_fetch_array
mysqli_stmt_store_result