(PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.9.0)
PDOStatement::debugDumpParams —
Détaille une commande préparée SQL
Description
public
PDOStatement::debugDumpParams(): ?bool
Ceci est une fonction de débogage, qui affiche directement des informations
sur la sortie standard.
Astuce
Comme pour toutes les fonctions qui affichent directement des résultats au navigateur, les
fonctions de gestion des sorties peuvent être utilisées pour capturer la sortie
de cette fonction et l'enregistrer dans une chaîne de caractères (par exemple).
Les paramètres affichés sont ceux qui ont été ajoutés dans la requête
jusqu'au moment de l'appel. Les paramètres surnuméraires sont ignorés.
Liste de paramètres
Cette fonction ne contient aucun paramètre.
Valeurs de retour
Retourne null
, ou false
en cas d'erreur.
Historique
Exemples
Exemple #1 Exemple avec pdostatement::debugDumpParams() et des paramètres nommés
<?php
/* exécution d'une commande préparée avec liaison avec variables 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 va afficher :
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 #2 Exemple avec pdostatement::debugDumpParams() et des paramètres anonymes
<?php
/* exécution d'une commande préparée avec liaison avec variables 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 va afficher :
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
Voir aussi
- PDO::prepare() - Prépare une requête à l'exécution et retourne un objet
- PDOStatement::bindParam() - Lie un paramètre à un nom de variable spécifique
- PDOStatement::bindValue() - Associe une valeur à un paramètre