PHP PDO プリペアドステートメントとストアドプロシージャ

PHP PDO 参考手册PHP PDO リファレンスマニュアル

多くの成熟したデータベースは、プリペアドステートメントの概念をサポートしています。

プリペアドステートメントとは何でしょうか?これは、実行したい SQL のコンパイル済みテンプレートのようなもので、変数パラメータを使用してカスタマイズできます。プリペアドステートメントには大きな利点が2つあります:

  • クエリは一度解析(または準備)されるだけで、同じまたは異なるパラメータで複数回実行できます。クエリが準備されると、データベースはそのクエリを実行する計画を分析、コンパイル、最適化します。複雑なクエリの場合、この処理には長い時間がかかり、異なるパラメータで同じクエリを何度も繰り返す必要がある場合、この処理によってアプリケーションの速度が大幅に低下します。プリペアドステートメントを使用することで、解析/コンパイル/最適化のサイクルを繰り返すことを回避できます。要するに、プリペアドステートメントは使用するリソースが少なく、実行がより高速です。
  • プリペアドステートメントに提供されるパラメータは引用符で囲む必要はなく、ドライバが自動的に処理します。アプリケーションがプリペアドステートメントのみを使用する場合、SQL インジェクションが発生しないことを保証できます。(ただし、クエリの他の部分がエスケープされていない入力から構築されている場合は、SQL インジェクションのリスクが依然として存在します)。

プリペアドステートメントは非常に便利なため、ドライバがサポートしていない場合に PDO がエミュレーション処理を行う唯一の機能です。これにより、データベースがそのような機能を持つかどうかに関係なく、アプリケーションが同じデータアクセスパターンを使用できることが保証されます。

プリペアドステートメントを使用した繰り返し挿入

次の例では、name と value を対応する名前付きプレースホルダーに置き換えて、挿入クエリを実行します。

<?php
$stmt = $dbh->prepare("INSERT INTO REGISTRY (name, value) VALUES (:name, :value)");
$stmt->bindParam(':name', $name);
$stmt->bindParam(':value', $value);

// 插入一行
$name = 'one';
$value = 1;
$stmt->execute();

//  用不同的值插入另一行
$name = 'two';
$value = 2;
$stmt->execute();
?>

プリペアドステートメントを使用した繰り返し挿入

次の例では、name と value を ? プレースホルダーの位置に置き換えて、挿入クエリを実行します。

<?php
$stmt = $dbh->prepare("INSERT INTO REGISTRY (name, value) VALUES (?, ?)");
$stmt->bindParam(1, $name);
$stmt->bindParam(2, $value);

// 插入一行
$name = 'one';
$value = 1;
$stmt->execute();

// 用不同的值插入另一行
$name = 'two';
$value = 2;
$stmt->execute();
?>

プリペアドステートメントを使用したデータ取得

次の例では、フォームから提供されたキー値に基づいてデータを取得します。ユーザーの入力は自動的に引用符で囲まれるため、SQL インジェクション攻撃の危険性はありません。

<?php
$stmt = $dbh->prepare("SELECT * FROM REGISTRY where name = ?");
if ($stmt->execute(array($_GET['name']))) {
  while ($row = $stmt->fetch()) {
    print_r($row);
  }
}
?>

データベースドライバがサポートしていれば、アプリケーションは出力パラメータと入力パラメータをバインドすることもできます。出力パラメータは通常、ストアドプロシージャから値を取得するために使用されます。出力パラメータの使用は入力パラメータよりも少し複雑です。出力パラメータをバインドするときは、指定されたパラメータの長さを知っている必要があるからです。パラメータにバインドされた値が推奨される長さより大きい場合、エラーが発生します。

出力パラメータを指定してストアドプロシージャを呼び出す

<?php
$stmt = $dbh->prepare("CALL sp_returns_string(?)");
$stmt->bindParam(1, $return_value, PDO::PARAM_STR, 4000); 

// 调用存储过程
$stmt->execute();

print "procedure returned $return_value\n";
?>

入力と出力の両方の値を持つパラメータを指定することもでき、その構文は出力パラメータに似ています。次の例では、文字列 "hello" がストアドプロシージャに渡され、ストアドプロシージャが戻るとき、hello はストアドプロシージャが返した値に置き換えられます。

入力/出力パラメータを指定してストアドプロシージャを呼び出す

<?php
$stmt = $dbh->prepare("CALL sp_takes_string_returns_string(?)");
$value = 'hello';
$stmt->bindParam(1, $value, PDO::PARAM_STR|PDO::PARAM_INPUT_OUTPUT, 4000); 

// 调用存储过程
$stmt->execute();

print "procedure returned $value\n";
?>

プレースホルダーの無効な使用

<?php
$stmt = $dbh->prepare("SELECT * FROM REGISTRY where name LIKE '%?%'");
$stmt->execute(array($_GET['name']));

// 占位符必须被用在整个值的位置
$stmt = $dbh->prepare("SELECT * FROM REGISTRY where name LIKE ?");
$stmt->execute(array("%$_GET[name]%"));
?>

PHP PDO 参考手册PHP PDO リファレンスマニュアル

その他の拡張モジュール