プリペアドクエリを実行する

# mysqli_stmt::execute

# mysqli_stmt_execute

(PHP 5, PHP 7)

mysqli_stmt::execute -- mysqli_stmt_execute — プリペアドクエリを実行する

### 説明

オブジェクト指向型

mysqli_stmt::execute ( void ) : bool

手続き型

mysqli_stmt_execute ( mysqli_stmt `$stmt` ) : bool

事前に mysqli_prepare() 関数で用意されたクエリを実行します。 パラメータマーカが存在する場合、その内容は自動的に適切なデータに置き換えられます。

ステートメントが UPDATE、DELETE あるいは INSERT であった場合、 変更された行の総数は mysqli_stmt_affected_rows() 関数を使用することで取得可能です。同様に、クエリが結果セットを返す場合は mysqli_stmt_fetch() 関数を使用できます。

> 注意:

> mysqli_stmt_execute() を使用した際には、 他のクエリを実行する前に mysqli_stmt_fetch() 関数を使用する必要があります。

### パラメータ

`stmt`

  手続き型のみ: mysqli_stmt_init() が返すステートメント ID。

### 返り値

成功した場合に `TRUE` を、失敗した場合に `FALSE` を返します。

### 例

例1 オブジェクト指向型

`<?php
$mysqli = new mysqli("localhost", "my_user", "my_password", "world");
/* 接続状況をチェックします */
if (mysqli_connect_errno()) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
$mysqli->query("CREATE TABLE myCity LIKE City");
/* insert ステートメントを準備します */
$query = "INSERT INTO myCity (Name, CountryCode, District) VALUES (?,?,?)";
$stmt = $mysqli->prepare($query);
$stmt->bind_param("sss", $val1, $val2, $val3);
$val1 = 'Stuttgart';
$val2 = 'DEU';
$val3 = 'Baden-Wuerttemberg';
/* ステートメントを実行します */
$stmt->execute();
$val1 = 'Bordeaux';
$val2 = 'FRA';
$val3 = 'Aquitaine';
/* ステートメントを実行します */
$stmt->execute();
/* ステートメントを閉じます */
$stmt->close();
/* myCity からすべての行を取得します */
$query = "SELECT Name, CountryCode, District FROM myCity";
if ($result = $mysqli->query($query)) {
while ($row = $result->fetch_row()) {
printf("%s (%s,%s)\n", $row[0], $row[1], $row[2]);
}
/* 結果セットを開放します */
$result->close();
}
/* テーブルを削除します */
$mysqli->query("DROP TABLE myCity");
/* 接続を閉じます */
$mysqli->close();
?>`

例2 手続き型

`<?php
$link = mysqli_connect("localhost", "my_user", "my_password", "world");
/* 接続状況をチェックします */
if (mysqli_connect_errno()) {
printf("Connect failed: %s\n", mysqli_connect_error());
exit();
}
mysqli_query($link, "CREATE TABLE myCity LIKE City");
/* insert ステートメントを準備します */
$query = "INSERT INTO myCity (Name, CountryCode, District) VALUES (?,?,?)";
$stmt = mysqli_prepare($link, $query);
mysqli_stmt_bind_param($stmt, "sss", $val1, $val2, $val3);
$val1 = 'Stuttgart';
$val2 = 'DEU';
$val3 = 'Baden-Wuerttemberg';
/* ステートメントを実行します */
mysqli_stmt_execute($stmt);
$val1 = 'Bordeaux';
$val2 = 'FRA';
$val3 = 'Aquitaine';
/* ステートメントを実行します */
mysqli_stmt_execute($stmt);
/* ステートメントを閉じます */
mysqli_stmt_close($stmt);
/* myCity からすべての行を取得します */
$query = "SELECT Name, CountryCode, District FROM myCity";
if ($result = mysqli_query($link, $query)) {
while ($row = mysqli_fetch_row($result)) {
printf("%s (%s,%s)\n", $row[0], $row[1], $row[2]);
}
/* 結果セットを開放します */
mysqli_free_result($result);
}
/* テーブルを削除します */
mysqli_query($link, "DROP TABLE myCity");
/* 接続を閉じます */
mysqli_close($link);
?>`

上の例の出力は以下となります。

    Stuttgart (DEU,Baden-Wuerttemberg)
    Bordeaux (FRA,Aquitaine)

### 参考

- mysqli_prepare() - 実行するための SQL ステートメントを準備する
- mysqli_stmt_bind_param() - プリペアドステートメントのパラメータに変数をバインドする
- mysqli_stmt_get_result() - プリペアード・ステートメントから結果セットを取得