mysqli_driver::$report_mode

mysqli_report

(PHP 5, PHP 7, PHP 8)

mysqli_driver::$report_mode -- mysqli_report设置 mysqli 错误报告模式

说明

面向对象风格

过程化风格

根据标志,它将 mysqli 错误报告模式设置为异常、警告或无。当设置为 MYSQLI_REPORT_ALLMYSQLI_REPORT_INDEX 时,它还会通知有关不使用索引(或使用错误索引)的查询。

从 PHP 8.1.0 开始,默认设置为 MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT。以前,它为 MYSQLI_REPORT_OFF

参数

flags

支持的标志
名称 说明
MYSQLI_REPORT_OFF 关闭报告
MYSQLI_REPORT_ERROR 报告来自 mysqli 函数调用的错误
MYSQLI_REPORT_STRICT 为错误抛出 mysqli_sql_exception 而不是警告
MYSQLI_REPORT_INDEX 报告查询中是否未使用索引或使用了错误索引
MYSQLI_REPORT_ALL 设置所有选项(报告全部)

返回值

返回 true

变更日志

版本 说明
8.1.0 默认值现在为 MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT。以前,它为 MYSQLI_REPORT_OFF

范例

范例 #1 面向对象风格

<?php

/* 激活报告 */
$driver = new mysqli_driver();
$driver->report_mode = MYSQLI_REPORT_ALL;

try {
/* 如果连接失败,将抛出 mysqli_sql_exception */
$mysqli = new mysqli("localhost", "my_user", "my_password", "my_db");

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

/* 此查询应报告错误索引(如果 population 列没有索引) */
$result = $mysqli->query("SELECT Name FROM City WHERE population > 50000");
} catch (
mysqli_sql_exception $e) {
error_log($e->__toString());
}

范例 #2 过程化风格

<?php

/* 激活报告 */
mysqli_report(MYSQLI_REPORT_ALL);

try {
/* 如果连接失败,将抛出 mysqli_sql_exception */
$link = mysqli_connect("localhost", "my_user", "my_password", "my_db");

/* 此查询应报告错误 */
$result = mysqli_query($link, "SELECT Name FROM Nonexistingtable WHERE population > 50000");

/* 此查询应报告错误索引(如果 population 列没有索引) */
$result = mysqli_query($link, "SELECT Name FROM City WHERE population > 50000");
} catch (
mysqli_sql_exception $e) {
error_log($e->__toString());
}

范例 #3 错误报告,除了错误索引错误

<?php

/* 激活报告 */
mysqli_report(MYSQLI_REPORT_ERROR | MYSQLI_REPORT_STRICT);

try {
/* 如果连接失败,将抛出 mysqli_sql_exception */
$mysqli = new mysqli("localhost", "my_user", "my_password", "my_db");

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

/* 此处不会报告任何错误,即使索引不可用 */
$result = $mysqli->query("SELECT Name FROM City WHERE population > 50000");
} catch (
mysqli_sql_exception $e) {
error_log($e->__toString());
}

参见

添加备注

用户贡献的备注 1 备注

8
nineoclick (atsymbol) gmail (dot) com
7 年前
似乎不太清楚,但标志*可以组合*,就像其他标志一样。
例如

<?php

# 希望注意到所有错误,除了关于索引的错误
$driver = new mysqli_driver();
$driver->report_mode = MYSQLI_REPORT_ALL & ~MYSQLI_REPORT_INDEX;

?>
To Top