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 オブジェクトとして取得する

説明

オブジェクト指向型

public mysqli_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_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() 関数を使わなければなりませんでした。

例

例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, result, stmt, 取得, プリペアドステートメント, オブジェクト, セット, 実行, 手続き, 関数