`mysqli_report`

mysqli_report
Enables or disables internal report functions

Description

bool mysqli_report(int flags);

mysqli_report is a powerful function to improve your queries and code during development and testing phase. Depending on the flags it reports errors from mysqli function calls or queries which don't use an index (or use a bad index).

Parameters

flags

Table 20.24. Supported flags

Name	Description
`MYSQLI_REPORT_OFF`	Turns reporting off
`MYSQLI_REPORT_ERROR`	Report errors from mysqli function calls
`MYSQLI_REPORT_STRICT`	Throw `mysqli_sql_exception` for errors instead of warnings
`MYSQLI_REPORT_INDEX`	Report if no index or bad index was used in a query
`MYSQLI_REPORT_ALL`	Set all options (report all)

Return Values

Returns TRUE on success or FALSE on failure.

Changelog

Version	Description
& 5.3.4	Changing the reporting mode is now be per-request, rather than per-process.

Examples

Example 20.203. Object oriented style

<?php
/* activate reporting */
mysqli_report(MYSQLI_REPORT_ALL);
$mysqli = new mysqli('localhost', 'my_user', 'my_password', 'world');
/* check connection */
if (mysqli_connect_errno()) {
 printf('Connect failed: %s\n', mysqli_connect_error());
 exit();
}
/* this query should report an error */
$result = $mysqli->query('SELECT Name FROM Nonexistingtable WHERE population > 50000');
/* this query should report a bad index */
$result = $mysqli->query('SELECT Name FROM City WHERE population > 50000');
$result->close();
$mysqli->close();
?>