mysqli_stmt::execute
mysqli_stmt_execute
(PHP 5, PHP 7)
mysqli_stmt::execute -- mysqli_stmt_execute — プリペアドクエリを実行する
説明
オブジェクト指向型
public mysqli_stmt::execute ( ) : 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() 関数を使用する必要があります。
返り値
成功した場合に 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() - プリペアード・ステートメントから結果セットを取得