PHP 8.4.2 Released!

    PDOStatement::debugDumpParams

    (PHP 5 >= 5.1.0, PHP 7, PHP 8, PECL pdo >= 0.9.0)

    PDOStatement::debugDumpParams — Despeja uma instrução preparada SQL

    Descrição

    public PDOStatement::debugDumpParams(): ?bool

    Despeja a informação contida em uma instrução preparada diretamente na saída. Fornece a consulta SQL em uso, o número de parâmetros usados (Params), a lista de parâmetros com seus nomes de chave ou posição, seus nomes, suas posições na consulta (se for suportado pelo driver PDO, caso contrário será -1), tipo (param_type) como um inteiro, e um valor booleano is_param.

    Esta é uma função de depuração, que despeja os dados diretamente na saída padrão.

    Dica

    Assim como qualquer coisa que envia seu resultado diretamente para o navegador, as funções de controle de saída podem ser usadas para capturar a saída desta função e salvá-la em uma string, por exemplo.

    Esta função somente despejará os parâmetros na instrução no momento do despejo. Parâmetros extras não são armazenados na instrução, e não serão mostrados.

    Parâmetros

    Esta função não possui parâmetros.

    Valor Retornado

    Retorna null, ou false em caso de erro.

    Registro de Alterações

    Versão Descrição
    7.2.0 PDOStatement::debugDumpParams() agora retorna o SQL enviado ao banco de dados, incluindo a consulta completa, bruta (incluindo os marcadores substituídos por seus valores vinculados). Observe que isto só estará disponível se as instrução preparadas emuladas estiverem habilitadas.

    Exemplos

    Exemplo #1 Exemplo de PDOStatement::debugDumpParams() com parâmetros nomeados

    <?php
    /* Executa uma instrução preparada vinculando variáveis 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();

    ?>

    O exemplo acima produzirá:

    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

    Exemplo #2 Exemplo de PDOStatement::debugDumpParams() com parâmetros anônimos

    <?php

    /* Executa uma instrução preparada vinculando variáveis 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();

    ?>

    O exemplo acima produzirá:

    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

    Veja Também

    Melhore Esta Página

    Aprenda Como Melhorar Esta Página • Envie uma Solicitação de Modificação • Reporte um Problema
    ＋adicione uma nota

    Notas Enviadas por Usuários (em inglês) 4 notes

    up
    70
    thefox
    11 years ago
    This function doesn't print parameter values despite the documentation says it does. See https://bugs.php.net/bug.php?id=52384 (filed back in 2010).
    up
    29
    mark at manngo dot net
    11 years ago
    As noted, this doesn’t actually simply print the prepared statement with data to be executed.

    For trouble shooting purposes, I find the following useful:

    <?php
    function parms($string,$data) {
    $indexed=$data==array_values($data);
    foreach(    $data as $k=>$v) {
    if(    is_string($v)) $v="'$v'";
    if(    $indexed) $string=preg_replace('/\?/',$v,$string,1);
    else     $string=str_replace(":$k",$v,$string);
    }
    return     $string;
    }

    // Index Parameters
    $string='INSERT INTO stuff(name,value) VALUES (?,?)';
    $data=array('Fred',23);

    // Named Parameters
    $string='INSERT INTO stuff(name,value) VALUES (:name,:value)';
    $data=array('name'=>'Fred','value'=>23);

    print     parms($string,$data);
    ?>
    up
    16
    Lucas
    9 years ago
    This function doesn't have a return, so if you want to do something with it you'll have to do something like

    <?php
    function pdo_debugStrParams($stmt) {
    ob_start();
    $stmt->debugDumpParams();
    $r = ob_get_contents();
    ob_end_clean();
    return     $r;
    }

    // omitted: connect to the database and prepare a statement
    echo '<pre>'.htmlspecialchars(pdo_debugStrParams($stmt)).'</pre>';
    ?

    Source: http://stackoverflow.com/questions/22157331/something-like-debugdumpparams-in-pdo-settable-to-a-string
    up
    0
    wchasroth at gmail dot com
    14 days ago
    Using PHP 8.3 and MySQL 8.2, debugDumpParams() DOES display the "raw" SQL, with parameter values.

    E.g.
    $sql = "SELECT tid, miv_title, ballot_order FROM title WHERE tid LIKE :tid AND ballot_order = :order";
    $stm = $pdo->prepare($sql);
    $stm->bindValue(":tid", "mi:%");
    $stm->bindValue(":order", 5000, PDO::PARAM_INT);
    $stm->execute();
    $stm->debugDumpParams();

    ... displays ...

    SQL: [92] SELECT tid, miv_title, ballot_order FROM title WHERE tid LIKE :tid AND ballot_order = :order
    Sent SQL: [92] SELECT tid, miv_title, ballot_order FROM title WHERE tid LIKE 'mi:%' AND ballot_order = 5000
    Params: 2
    Key: Name: [4] :tid
    paramno=-1
    name=[4] ":tid"
    is_param=1
    param_type=2
    Key: Name: [6] :order
    paramno=-1
    name=[6] ":order"
    is_param=1
    param_type=1
    ＋adicione uma nota
    To Top