Descripción

Estilo orientado a objetos

int $mysqli_driver->report_mode;

Estilo procedimental

mysqli_report(int $flags): true

Según los flags, esto define el modo de informe de errores de mysqli a excepción, advertencia o ninguno. Cuando se define como MYSQLI_REPORT_ALL o MYSQLI_REPORT_INDEX esto también informará sobre consultas que no utilizan un índice (o un índice incorrecto).

A partir de PHP 8.1.0, el valor por omisión es MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT. Anteriormente, era MYSQLI_REPORT_OFF.

Parámetros

flags

Flags admitidos

Nombre Descripción

MYSQLI_REPORT_OFF Desactiva los informes (valor por omisión)

MYSQLI_REPORT_ERROR Informa sobre errores desde llamadas a funciones mysqli

MYSQLI_REPORT_STRICT Lanza una excepción mysqli_sql_exception para errores, en lugar de emitir alertas

MYSQLI_REPORT_INDEX Informa si no se utiliza ningún índice o un índice incorrecto en una consulta

MYSQLI_REPORT_ALL Define todas las opciones (informa sobre todo)

**Flags admitidos**
Nombre	Descripción
`MYSQLI_REPORT_OFF`	Desactiva los informes (valor por omisión)
`MYSQLI_REPORT_ERROR`	Informa sobre errores desde llamadas a funciones mysqli
`MYSQLI_REPORT_STRICT`	Lanza una excepción mysqli_sql_exception para errores, en lugar de emitir alertas
`MYSQLI_REPORT_INDEX`	Informa si no se utiliza ningún índice o un índice incorrecto en una consulta
`MYSQLI_REPORT_ALL`	Define todas las opciones (informa sobre todo)

Valores devueltos

Retorna siempre true.

Historial de cambios

Versión	Descripción
8.1.0	El valor por omisión es ahora `MYSQLI_REPORT_ERROR \| MYSQLI_REPORT_STRICT`. Anteriormente, era `MYSQLI_REPORT_OFF`.

Ejemplos

Ejemplo #1 Estilo orientado a objetos

<?php

/* Activación del informe de errores */
$driver = new mysqli_driver();
$driver->report_mode = MYSQLI_REPORT_ALL;

try {
    /* si la conexión falla, se lanzará una mysqli_sql_exception */
    $mysqli = new mysqli("localhost", "my_user", "my_password", "my_db");

    /* esta consulta debería informar sobre un error */
    $result = $mysqli->query("SELECT Name FROM Nonexistingtable WHERE population > 50000");

    /* esta consulta debería informar sobre un índice incorrecto, si la columna population no tiene un índice */
    $result = $mysqli->query("SELECT Name FROM City WHERE population > 50000");
} catch (mysqli_sql_exception $e) {
    error_log($e->__toString());
}

Ejemplo #2 Estilo procedimental

<?php

/* Activación del informe de errores */
mysqli_report(MYSQLI_REPORT_ALL);

try {
    /* si la conexión falla, se lanzará una excepción mysqli_sql_exception */
    $link = mysqli_connect("localhost", "my_user", "my_password", "my_db");

    /* esta consulta debería informar sobre un error */
    $result = mysqli_query($link, "SELECT Name FROM Nonexistingtable WHERE population > 50000");

    /* esta consulta debería informar sobre un índice incorrecto, si la columna population no tiene un índice */
    $result = mysqli_query($link, "SELECT Name FROM City WHERE population > 50000");
} catch (mysqli_sql_exception $e) {
    error_log($e->__toString());
}

Ejemplo #3 Informe de errores a excepción de errores de índice incorrecto

<?php

/* Activación del informe de errores */
$driver = new mysqli_driver();
$driver->report_mode = MYSQLI_REPORT_ALL;

try {
    /* si la conexión falla, se lanzará una mysqli_sql_exception */
    $mysqli = new mysqli("localhost", "my_user", "my_password", "my_db");

    /* esta consulta debería informar sobre un error */
    $result = $mysqli->query("SELECT Name FROM Nonexistingtable WHERE population > 50000");

    /* esto NO emitirá un error incluso si no hay ningún índice disponible */
    $result = $mysqli->query("SELECT Name FROM City WHERE population > 50000");
} catch (mysqli_sql_exception $e) {
    error_log($e->__toString());
}

Ver también

mysqli_sql_exception
set_exception_handler() - Define una función de usuario para gestionar excepciones
error_reporting() - Establece el nivel de reporte de errores de PHP

mysqli_driver::$report_mode