PHP Conference Japan 2024

    mysqli_driver::$report_mode

    mysqli_report

    (PHP 5、PHP 7、PHP 8)

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

    描述

    面向对象风格

    int $mysqli_driver->report_mode;

    过程式风格

    mysqli_report(int $flags): true

    根据标志，它将 mysqli 错误报告模式设置为异常、警告或无。当设置为 MYSQLI_REPORT_ALL 或 MYSQLI_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