PDO プリペアドステートメント PDOStatement オブジェクト-PHPチュートリアル-php.cn

この記事では、主に 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 サイトに注目してください。