[edit] Last updated: Fri, 25 May 2012

mysqli_report

(PHP 5)

mysqli_report — Enables or disables internal report functions

Описание

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).

Список параметров

flags

**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)

Возвращаемые значения

Возвращает TRUE в случае успешного завершения или FALSE в случае возникновения ошибки.

Список изменений

Версия	Описание
5.2.15 & 5.3.4	Changing the reporting mode is now be per-request, rather than per-process.

Примеры

Пример #1 Объектно-ориентированный стиль


<?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();
?>

Смотрите также

mysqli_driver::$report_mode
mysqli_debug() - Выполняет процедуры отладки
mysqli_dump_debug_info() - Журналирование отладочной информации

mysqli_rpl_parse_enabled

mysqli_param_count

[edit] Last updated: Fri, 25 May 2012

add a note User Contributed Notes mysqli_report

grepmaster 22-Mar-2009 05:51


Hint: If you use



mysqli_report(MYSQLI_REPORT_ALL ^ MYSQLI_REPORT_STRICT)



normal errors are generated instead of exceptions.

Polarina 10-Nov-2007 03:08


It should be noted that all reports made by this function, are sent through an exception named 'mysqli_sql_exception' instead of a normal PHP warning.

anthony dot parsons at manx dot net 05-Nov-2005 07:23


Be very careful using this function - it's a per-process setting.

If your server is set up to reuse a single PHP process for multiple requests, that means the last setting of this function in any script will affect all other scripts using mysqli.

To be safe always call <? mysqli_report(MYSQLI_REPORT_OFF) ?> at the end of a script. The CGI version of PHP is probably safe from this.



(Tested using PHP 5.0.5, Apache 2 SAPI module)

add a note