PDO 準備済みステートメント PDOStatement オブジェクトの使用法の概要、pdopdostatement

PDO プリペアドステートメント PDOStatement オブジェクトの使用法の概要、pdopdostatement

PDO のプリペアドステートメントのサポートには PDOStatement クラスオブジェクトの使用が必要ですが、このクラスオブジェクトは NEW キーワードによってインスタンス化されず、SQL ステートメントの直後に返される PDO オブジェクトの prepare() メソッドを通じてデータベースサーバーで準備されます。。以前に PDO オブジェクトで query() メソッドを実行することによって返された PDOStatement クラスオブジェクトが結果セットオブジェクトのみを表す場合。また、PDO オブジェクト内の prepare() メソッドを実行して生成される PDOStatement クラスオブジェクトがクエリオブジェクトの場合、パラメータ化された SQL コマンドを定義して実行できます。 PDOStatement クラスのすべてのメンバーメソッドは次のとおりです:

コードをコピーしますコードは次のとおりです:

PDOStatement::bindColumn — 列を PHP 変数にバインドする
PDOStatement::bindParam — パラメーターを指定された変数名にバインドします
PDOStatement::bindValue — 値をパラメータにバインドする
PDOStatement::closeCursor — ステートメントを再度実行できるようにカーソルを閉じます。
PDOStatement::columnCount — 結果セット内の列の数を返す
PDOStatement::debugDumpParams — SQL 前処理コマンドを出力する
PDOStatement::errorCode — 最後のステートメントハンドル操作に関連付けられた SQLSTATE を取得します
PDOStatement::errorInfo — 最後のステートメントハンドル操作に関連する拡張エラー情報を取得します
PDOStatement::execute — 準備されたステートメントを実行します
PDOStatement::fetch — 結果セットから次の行を取得します
PDOStatement::fetchAll — 結果セット内のすべての行を含む配列を返す
PDOStatement::fetchColumn — 結果セットの次の行から 1 つの列を返します。
PDOStatement::fetchObject — 次の行を取得し、オブジェクトとして返します。
PDOStatement::getAttribute — ステートメント属性を取得する
PDOStatement::getColumnMeta — 結果セット内の列のメタデータを返す
PDOStatement::nextRowset — 複数行セットステートメントハンドルの次の行セットに進みます
PDOStatement::rowCount — 前の SQL ステートメントの影響を受けた行数を返します
PDOStatement::setAttribute — ステートメント属性を設定する
PDOStatement::setFetchMode — ステートメントのデフォルトのフェッチモードを設定します。

1. 明細書を準備します

反復ごとに異なるパラメータを使用して SQL クエリを繰り返し実行する場合、準備されたステートメントが最も効率的です。プリペアドステートメントを使用するには、まずデータベースサーバーに「SQL ステートメント」を準備する必要がありますが、すぐに実行する必要はありません。 PDO は、この前処理された SQL ステートメントに変数をバインドするための「プレースホルダー」構文の使用をサポートしています。準備された SQL ステートメントの場合、実行のたびに一部の列の値を変更する必要がある場合は、特定の列の値の代わりに「プレースホルダー」を使用する必要があります。 PDO でプレースホルダーを使用するには、「名前付きパラメータ」と「疑問符パラメータ」の 2 つの構文があります。どちらの構文を使用するかは個人の好みによって異なります。

名前付きパラメータをプレースホルダーとして使用する INSERT ステートメント:

コードをコピーしますコードは次のとおりです:

$dbh->prepare(“連絡先情報(名前,住所,電話)の値(:名前,:住所,:電話)に挿入”);

文字列を「名前付きパラメータ」としてカスタマイズする必要があります。各名前付きパラメータはコロン (:) で始まる必要があり、対応するフィールド名と同じ名前にするのが最善です。
疑問符 (?) パラメーターをプレースホルダーとして使用する INSERT ステートメント:

コードをコピーしますコードは次のとおりです:

$dbh->prepare(“連絡先情報(名前,住所,電話)の値(?,?,?)に挿入”);

疑問符パラメータは、フィールドの位置順序に対応している必要があります。どのパラメータがプレースホルダで構成されるクエリとして使用されるか、ステートメントでプレースホルダが使用されないかに関係なく、PDO オブジェクトの prepare() メソッドを使用して、反復実行に使用されるクエリを準備する必要があります。 PDOStatement クラスのオブジェクト。

2. バインドパラメータ

SQL ステートメントが PDO オブジェクトの prepare() メソッドを通じてデータベースサーバー上で準備される場合、プレースホルダーが使用されている場合、入力パラメーターは実行されるたびに置き換える必要があります。 PDOStatement オブジェクトのbindParam() メソッドを使用して、パラメーター変数を準備されたプレースホルダーにバインドできます (位置または名前が対応している必要があります)。メソッドbindParame()のプロトタイプは次のとおりです:

コードをコピーしますコードは次のとおりです:

bool PDOStatement::bindParam (mixed $parameter ,mixed &$variable [, int $data_type = PDO::PARAM_STR [, int $length [,mixed $driver_options ]]] )

最初のパラメータパラメータは必須です。プレースホルダ構文が準備されたクエリで名前付きパラメータを使用する場合、名前付きパラメータ文字列は、bindParam() メソッドの最初のパラメータとして提供されます。プレースホルダー構文で疑問符引数を使用する場合、準備されたクエリ内の列値プレースホルダーのインデックスオフセットが最初の引数としてメソッドに渡されます。

2 番目のパラメーター変数もオプションであり、最初のパラメーターで指定されたプレースホルダーの値を提供します。パラメーターは参照によって渡されるため、値を直接指定することはできず、変数のみをパラメーターとして指定できます。

3 番目のパラメーター data_type はオプションで、現在バインドされているパラメーターのデータ型を設定します。次の値を指定できます。

PDO::PARAM_BOOL はブールデータ型を表します。
PDO::PARAM_NULL は SQL の NULL 型を表します。
PDO::PARAM_INT は、SQL の INTEGER データ型を表します。
PDO::PARAM_STR は、SQL の CHAR、VARCHAR、およびその他の文字列データ型を表します。
PDO::PARAM_LOB は、SQL のラージオブジェクトデータ型を表します。

4 番目のパラメーターの長さはオプションであり、データ型の長さを指定するために使用されます。

5 番目のパラメータ driver_options はオプションであり、データベースドライバ固有のオプションが指定されます。
名前付きパラメーターをプレースホルダーとして使用したパラメーターバインディングの例:

コードをコピーしますコードは次のとおりです:

//...PDO 接続データベースコードを省略します
$query = "連絡先情報 (名前,住所,電話) の値(:名前,:住所,:電話)に挿入";
$stmt = $dbh->prepare($query); //PDO オブジェクトの prepare() メソッドを呼び出します

$stmt->blinparam(':name',$name); //変数 $name の参照を、準備されたクエリ名パラメーター ":name" にバインドします
$stmt->blinparam(':アドレス',$アドレス);
$stmt->blinparam(':phone',phone);
//...
?>

疑問符 (?) をプレースホルダーとして使用したパラメーターバインディングの例:

コードをコピーしますコードは次のとおりです:

//...PDO 接続データベースコードを省略します
$query = "連絡先情報 (名前、住所、電話番号) の値 (?,?,?) に挿入";
$stmt = $dbh->prepare($query); //PDO オブジェクトの prepare() メソッドを呼び出します

$stmt->blinparam(1,$name,PDO::PARAM_STR); //変数 $name の参照を、準備されたクエリ名パラメーター ":name" にバインドします
$stmt->blinparam(2,$address,PDO::PARAM_STR);
$stmt->blinparam(3,phone,PDO::PARAM_STR,20);
//...
?>

3. 準備されたステートメントを実行します

準備されたステートメントが完了し、対応するパラメーターがバインドされたら、PDOStatement クラスオブジェクトのexecute() メソッドを呼び出すことで、データベースキャッシュに準備されたステートメントを繰り返し実行できます。次の例では、前処理を使用して、前に提供した contactinfo テーブルで同じ INSERT ステートメントを継続的に実行し、異なるパラメーターを変更することで 2 つのレコードを追加します。以下に示すように:

コードをコピーしますコードは次のとおりです:

試してみてください{
$dbh = 新しい PDO('mysql:dbname=testdb;host=localhost', $username, $passwd);
}キャッチ (PDOException $e){
echo 'データベース接続に失敗しました:'.$e->getMessage();
終了します;
}

$query = "連絡先情報 (名前、住所、電話番号) の値 (?,?,?) に挿入";
$stmt = $dbh->prepare($query);

$stmt->blinparam(1,$name); $stmt->blinparam(2,$address);
$stmt->blinparam(3,phone);

$name = "趙 XX";
$address = "海淀区中関村";
$phone = "15801688348";

$stmt->execute(); //実行パラメータがバインドされた後の準備されたステートメント
?>

入力パラメーターを渡すだけで、渡すパラメーターが多数ある場合は、以下に示すショートカット構文が非常に役立つことがわかります。これは、実行中に前処理されたクエリの入力パラメータを置き換える 2 番目の方法です。execute() メソッドにオプションのパラメータを指定します。これは、準備されたクエリ内の名前付きパラメータプレースホルダの配列です。この構文を使用すると、$stmt->bindParam() の呼び出しを省略できます。上記の例を次のように変更します:

コードをコピーしますコードは次のとおりです:

//...PDO 接続データベースコードを省略します
$query = "連絡先情報 (名前、住所、電話番号) の値 (?,?,?) に挿入";
$stmt = $dbh->準備($query);
// 配列を渡して、前処理されたクエリ内の名前付きパラメータに値をバインドし、1 回実行します。
$stmt->execute(array("趙 XX","海淀区","15801688348"));
?>

さらに、INSERT ステートメントが実行され、データテーブルに自動的に増加する ID フィールドがある場合は、PDO オブジェクトの lastinsertId() メソッドを使用して、データテーブルに最後に挿入されたレコードの ID を取得できます。他の DML ステートメントが正常に実行されたかどうかを確認する必要がある場合は、PDOStatement クラスオブジェクトの rowCount() メソッドを使用して、レコードに影響を与える行数を取得できます。