PDOStatement::debugDumpParams

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

PDOStatement::debugDumpParams — SQL プリペアドコマンドを出力する(PHP 5 >= 5.1.0, PECL pdo >= 0.9.0)


説明

構文

bool PDOStatement::debugDumpParams ( void )

プリペアドステートメントに含まれる情報を直接出力します。使用中の SQL クエリ、使用したパラメータ(Params)の数、パラメータのリスト、パラメータ名、整数で表されるパラメータタイプ(paramtype)、キー名または位置、値、およびクエリ内の位置(現在の POD ドライバがサポートしていない場合は -1)を提供します。

これはデバッグ用の機能で、通常の出力ではデータを直接出力します。

ヒント:結果をブラウザに直接出力するのと同じように、出力制御関数を使用して現在の関数の出力をキャプチャし、その後(例えば)string に保存することができます。

その時点のステートメント内のパラメータのみを出力します。追加のパラメータはステートメントに保存されないため、出力されません。


戻り値

戻り値はありません。


例

PDOStatement::debugDumpParams() 名前付きパラメータを使用する例

<?php
/* 通过绑定 PHP 变量执行一条预处理语句 */
$calories = 150;
$colour = 'red';
$sth = $dbh->prepare('SELECT name, colour, calories
    FROM fruit
    WHERE calories < :calories AND colour = :colour');
$sth->bindParam(':calories', $calories, PDO::PARAM_INT);
$sth->bindValue(':colour', $colour, PDO::PARAM_STR, 12);
$sth->execute();

$sth->debugDumpParams();

?>

上記の例は次のように出力します:

SQL: [96] SELECT name, colour, calories
    FROM fruit
    WHERE calories < :calories AND colour = :colour
Params:  2
Key: Name: [9] :calories
paramno=-1
name=[9] ":calories"
is_param=1
param_type=1
Key: Name: [7] :colour
paramno=-1
name=[7] ":colour"
is_param=1
param_type=2

PDOStatement::debugDumpParams() 名前なしパラメータを使用する例

<?php

/* 通过绑定 PHP 变量执行一条预处理语句 */
$calories = 150;
$colour = 'red';
$name = 'apple';

$sth = $dbh->prepare('SELECT name, colour, calories
    FROM fruit
    WHERE calories < ? AND colour = ?');
$sth->bindParam(1, $calories, PDO::PARAM_INT);
$sth->bindValue(2, $colour, PDO::PARAM_STR);
$sth->execute();

$sth->debugDumpParams();

?>

上記の例は次のように出力します:

SQL: [82] SELECT name, colour, calories
    FROM fruit
    WHERE calories < ? AND colour = ?
Params:  2
Key: Position #0:
paramno=0
name=[0] ""
is_param=1
param_type=1
Key: Position #1:
paramno=1
name=[0] ""
is_param=1
param_type=2

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

その他の拡張モジュール