IBM DB2 関数
PHP Manual

db2_prepare

(PECL ibm_db2 >= 1.0.0)

db2_prepare 実行する SQL 文を準備する

説明

resource db2_prepare ( resource $connection , string $statement [, array $options ] )

db2_prepare() は、プリペアドステートメントを作成します。 このプリペアドステートメントには、入力パラメータ・出力パラメータ あるいは入出力パラメータを表すパラメータマーカ (?) を含めることができます。プリペアドステートメントにパラメータを渡すには db2_bind_param() を使用します。 入力パラメータの場合についてのみ、db2_execute() に渡す配列で指定することも可能です。

アプリケーション内でプリペアドステートメントを使用する利点は、 以下の 3 つです。

パラメータ

connection

db2_connect() あるいは db2_pconnect() が返した有効なデータベース接続リソース。

statement

ひとつ以上のパラメータマーカを含む SQL 文。

options

文のオプションを含む連想配列。 データベースサーバーがその機能をサポートしている場合に、 このパラメータを使用してスクロール可能なカーソルの使用を 要求することができます。

オプションについての説明は db2_set_option() を参照ください。

返り値

SQL 文のパースに成功し、データベースサーバー内で正しく準備された場合に ステートメントリソースを返します。データベースサーバーがエラーを返した場合に FALSE を返します。返されたエラーの詳細を調べるには、 db2_stmt_error() あるいは db2_stmt_errormsg() をコールします。

例1 パラメータマーカを使用した SQL 文の準備と実行

以下の例では、4 つのパラメータマーカを含む INSERT 文を準備し、 入力値の配列を含む配列を順に処理しながら db2_execute() に値を渡します。

<?php
$animals 
= array(
    array(
0'cat''Pook'3.2),
    array(
1'dog''Peaches'12.3),
    array(
2'horse''Smarty'350.0),
);

$insert 'INSERT INTO animals (id, breed, name, weight)
    VALUES (?, ?, ?, ?)'
;
$stmt db2_prepare($conn$insert);
if (
$stmt) {
    foreach (
$animals as $animal) {
        
$result db2_execute($stmt$animal);
    }
}
?>

参考


IBM DB2 関数
PHP Manual