mysqli::debug

mysqli_debug

(PHP 5, PHP 7, PHP 8)

mysqli::debug -- mysqli_debugRealiza acciones de depuración

Descripción

Estilo orientado a objetos

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

Estilo por procedimientos

mysqli_debug(string $options): true

Realiza acciones de depuración utilizando la biblioteca de depuración Fred Fish.

Parámetros

options

Un string que representa la operación de depuración a realizar.

El string de control de depuración es una secuencia de campos separados por dos puntos, como sigue:

<field_1>:<field_2>:<field_N>
Cada campo se compone de un carácter flag obligatorio seguido de un , opcional y una lista de modificadores separados por comas: flag[,modifier,modifier,...,modifier]

Caracteres flag reconocidos
options carácter Descripción
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 salida a fichero
T MYSQLND_DEBUG_DUMP_TIME
t MYSQLND_DEBUG_DUMP_TRACE
x MYSQLND_DEBUG_PROFILE_CALLS

Valores devueltos

Siempre devuelve true.

Historial de cambios

Versión Descripción
8.0.0 Esta función devuelve ahora siempre true. Anteriormente, devolvía false en caso de error.

Ejemplos

Ejemplo #1 Generación de un fichero de "traza"

<?php

/* Genera un fichero de "traza" en '/tmp/client.trace' en la máquina (cliente) local: */
mysqli_debug("d:t:o,/tmp/client.trace");

?>

Notas

Nota:

Para utilizar la función mysqli_debug(), se debe compilar la biblioteca cliente MySQL con soporte de depuración.

Ver también