mysqli::debug

mysqli_debug

(PHP 5, PHP 7, PHP 8)

mysqli::debug -- mysqli_debug — Realiza operações de depuração

Descrição

Estilo orientado a objetos

public mysqli::debug(string $options): true

Estilo procedural

mysqli_debug(string $options): true

Realiza operações de depuração usando a biblioteca Fred Fish.

Parâmetros

options

Uma string representando a operação de depuração a ser executada

A string de opções de depuração é uma sequência de campos separados por dois pontos (:) desta maneira: 

<campo_1>:<campo_2>:<campo_N>
Cada campo consiste de um caractere de opção mandatório seguido por uma , opcional e uma lista de modificadores: separados por vírgula: opção[,modificador,modificador,...,modificador]

Caracteres de Opção Reconhecidos
Caractere de options Descrição
O MYSQLND_DEBUG_FLUSH
A/a MYSQLND_DEBUG_APPEND
F MYSQLND_DEBUG_DUMP_FILE
i MYSQLND_DEBUG_DUMP_PID
L MYSQLND_DEBUG_DUMP_LINE
m MYSQLND_DEBUG_TRACE_MEMORY_CALLS
n MYSQLND_DEBUG_DUMP_LEVEL
o saída para arquivo
T MYSQLND_DEBUG_DUMP_TIME
t MYSQLND_DEBUG_DUMP_TRACE
x MYSQLND_DEBUG_PROFILE_CALLS

Valor Retornado

Sempre retorna true.

Registro de Alterações

Versão Descrição
8.0.0 Esta função agora sempre retorna true. Anteriormente retornava false em caso de falha.

Exemplos

Example #1 Gerando um Aqruivo de Rastreamento

<?php

/* Cria um arquivo de rastreamento em '/tmp/client.trace' na máquina local (do cliente): */
mysqli_debug("d:t:o,/tmp/client.trace");

?>

Notas

Note:

Para usar a função mysqli_debug() deve-se compilar a biblioteca do cliente MySQL com suporte a depuração.

Veja Também