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 リファレンスマニュアル