PDOStatement::debugDumpParams

PHP PDO 参考手册Manuel de référence PHP PDO

PDOStatement::debugDumpParams — Affiche une commande préparée SQL (PHP 5 >= 5.1.0, PECL pdo >= 0.9.0)

Description

Syntaxe

bool PDOStatement::debugDumpParams ( void )

Affiche directement les informations contenues dans une requête préparée. Fournit la requête SQL utilisée, le nombre de paramètres (Params) utilisés, la liste des paramètres, le nom du paramètre, le type du paramètre (paramtype) exprimé sous forme d'entier, le nom ou la position de la clé, la valeur, et la position dans la requête (ou -1 si non supporté par le pilote PDO courant).

Il s'agit d'une fonctionnalité de débogage qui affiche les données directement sur la sortie normale.

Astuce :Tout comme l'affichage direct du résultat dans le navigateur, vous pouvez utiliser les fonctions de contrôle de sortie pour capturer la sortie de cette fonction, puis (par exemple) l'enregistrer dans une chaîne de caractères.

Seuls les paramètres présents dans la requête au moment courant sont affichés. Les paramètres supplémentaires ne sont pas stockés dans la requête et ne seront donc pas affichés.

Valeurs de retour

Aucune valeur de retour.

Exemples

Exemple de PDOStatement::debugDumpParams() avec des paramètres nommés

<?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();

?>

L'exemple ci-dessus affichera :

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

Exemple de PDOStatement::debugDumpParams() avec des paramètres non nommés

<?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();

?>

L'exemple ci-dessus affichera :

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 参考手册Manuel de référence PHP PDO

Autres extensions