PDO プリペアドステートメント PDOStatement オブジェクト

この記事では、主に PDO 前処理ステートメント PDOStatement オブジェクトの使用方法の概要を紹介します。この記事では、PDOStatement のメソッドと一般的なメソッドの例を紹介します。必要な方は、

PDO 前処理ステートメントのサポートを参照してください。 PDOStatement クラス オブジェクトを使用する必要がありますが、このクラス オブジェクトは NEW キーワードによってインスタンス化されず、PDO オブジェクトの prepare() メソッドを通じてデータベース サーバーで前処理された SQL ステートメントを準備した後に直接返されます。以前に 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 — 从结果集中的下一行返回单独的一列。
PDOStatement::fetchObject — 获取下一行并作为一个对象返回。
PDOStatement::getAttribute — 检索一个语句属性
PDOStatement::getColumnMeta — 返回结果集中一列的元数据
PDOStatement::nextRowset — 在一个多行集语句句柄中推进到下一个行集
PDOStatement::rowCount — 返回受上一个 SQL 语句影响的行数
PDOStatement::setAttribute — 设置一个语句属性
PDOStatement::setFetchMode — 为语句设置默认的获取模式。

1. ステートメントの準備

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

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

$dbh->prepare(“insert into contactinfo(name,address,phone) values(:name,:address,:phone)”);

文字列を「名前付きパラメーター」としてカスタマイズする必要があります。各名前付きパラメーターはコロン (:) で始まる必要があり、パラメーター名前は意味のあるものでなければならず、対応するフィールド名と同じであることが望ましいです。
疑問符 (?) パラメータをプレースホルダとして使用してステートメントを挿入します。

$dbh->prepare(“insert into contactinfo(name,address,phone) values(?,?,?)”);

疑問符パラメータはフィールドの位置順序に対応している必要があります。どのパラメータがプレースホルダで構成されるクエリとして使用されるか、ステートメントでプレースホルダが使用されないかに関係なく、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 はオプションであり、このパラメーターを通じてデータベース ドライバー固有のオプションを提供します。
名前付きパラメーターをプレースホルダーとして使用するパラメーター バインディングの例:

<?php
//...省略PDO连接数据库代码
$query = "insert into contactinfo (name,address,phone) values(:name,:address,:phone)";
$stmt = $dbh->prepare($query);          //调用PDO对象中的prepare()方法
 
$stmt->blinparam(&#39;:name&#39;,$name);        //将变量$name的引用绑定到准备好的查询名字参数":name"中
$stmt->blinparam(&#39;:address&#39;,$address);
$stmt->blinparam(&#39;:phone&#39;,phone);
//...
?>

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

<?php
//...省略PDO连接数据库代码
$query = "insert into contactinfo (name,address,phone) values(?,?,?)";
$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 つのレコードを追加します。以下に示すように:

<?php 
try {
     $dbh = new PDO(&#39;mysql:dbname=testdb;host=localhost&#39;, $username, $passwd);
}catch (PDOException $e){
    echo &#39;数据库连接失败：&#39;.$e->getMessage();
    exit;
}
 
$query = "insert into contactinfo (name,address,phone) values(?,?,?)";
$stmt = $dbh->prepare($query);
 
$stmt->blinparam(1,$name);      
$stmt->blinparam(2,$address);
$stmt->blinparam(3,phone);
 
$name = "赵某某";
$address = "海淀区中关村";
$phone = "15801688348";
 
$stmt->execute();           //执行参数被绑定后的准备语句
?>

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

<?php 
//...省略PDO连接数据库代码
$query = "insert into contactinfo (name,address,phone) values(?,?,?)";
$stmt = $dbh->prepare($query); 
 
//传递一个数组为预处理查询中的命名参数绑定值，并执行一次。
$stmt->execute(array("赵某某","海淀区","15801688348"));
?>

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

上記がこの記事の全内容です。皆様の学習に役立つことを願っています。その他の関連コンテンツについては、PHP 中国語 Web サイトに注目してください。

関連する推奨事項:

thinkPHP2.1 カスタム タグ ライブラリのインポート方法の紹介

pthreads を使用して実際の機能を実現するPHP マルチスレッド方式

以上がPDO プリペアドステートメント PDOStatement オブジェクトの詳細内容です。詳細については、PHP 中国語 Web サイトの他の関連記事を参照してください。