mysqli_report

(PHP 5)

mysqli_report — 开启或禁用（Mysql）内部（错误）报告函数

说明

bool mysqli_report ( int $flags )

mysqli_report()在开发和测试阶段对于你的查询和代码测试的提升方面是一个非常有用的函数。它依赖flags参数报告从mysqli函数调用或没有使用索引（或使用了坏的索引）的查询引发的错误。

参数

flags

**支持的flags**
名称	描述
`MYSQLI_REPORT_OFF`	关闭错误报告
`MYSQLI_REPORT_ERROR`	报告mysqli函数调用中的错误
`MYSQLI_REPORT_STRICT`	以抛出异常mysqli_sql_exception的方式替换警告错误。
`MYSQLI_REPORT_INDEX`	如果一个查询没有索引或使用了错误的索引则报告错误
`MYSQLI_REPORT_ALL`	设置所有选项（报告所有）

返回值

成功时返回 TRUE，或者在失败时返回 FALSE.

更新日志

版本	说明
5.2.15 & 5.3.4	修改了报告模式，现在是每个请求，而不是每个进程。

范例

面向对象风格


<?php
/* 激活错误报告 */
mysqli_report(MYSQLI_REPORT_ALL);

$mysqli = new mysqli("localhost", "my_user", "my_password", "world");

/* 检查连接 */
if (mysqli_connect_errno()) {
    printf("Connect failed: %s\n", mysqli_connect_error());
    exit();
}

/* 这个查询会报告一个错误 */
$result = $mysqli->query("SELECT Name FROM Nonexistingtable WHERE population > 50000");

/* 这个查询会报告一个坏的索引 */
$result = $mysqli->query("SELECT Name FROM City WHERE population > 50000");
$result->close();

$mysqli->close();
?>

参见

MySQLi_Driver::$report_mode
mysqli_debug() - Performs debugging operations
mysqli_dump_debug_info() - 将调试信息输出到日志

PHP手册 - N: 开启或禁用（Mysql）内部（错误）报告函数

用户评论:

grepmaster (23-Mar-2009 01:51)

Hint: If you use mysqli_report(MYSQLI_REPORT_ALL ^ MYSQLI_REPORT_STRICT) normal errors are generated instead of exceptions.

Polarina (10-Nov-2007 11: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 (06-Nov-2005 03: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)