PHP mysqli_report MySQLi 函数



  • 定义和用法

    mysqli_report - 启用或禁用内部报告功能
  • 版本支持

    PHP4 PHP5 PHP7
    不支持 支持 支持
    5.3.4 现在,按请求而不是按流程更改报告模式。
    5.2.15 现在,按请求而不是按流程更改报告模式。
  • 语法

    mysqli_report ( int $flags )
    
    有助于在代码开发和测试期间改善查询的功能。 根据标志,它报告来自mysqli函数调用或不使用索引(或使用错误索引)的查询的错误。
  • 参数

    参数 必需的 描述
    flags
    • MYSQLI_REPORT_OFF 关闭报告
    • MYSQLI_REPORT_ERROR 报告来自mysqli函数调用的错误
    • MYSQLI_REPORT_STRICT 将mysqli_sql_exception抛出错误而不是警告
    • MYSQLI_REPORT_INDEX 报告查询中是否未使用索引或错误索引
    • MYSQLI_REPORT_ALL 设置所有选项(全部报告)
  • 返回值

    成功时返回 TRUE, 或者在失败时返回 FALSE。
  • 示例

    <?php
    /* activate reporting */
    mysqli_report(MYSQLI_REPORT_ALL);
    
    $link = mysqli_connect("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");
    
    mysqli_free_result($result);
    
    mysqli_close($link);
    
  • 相关函数

    mysqli_debug() - 执行调试操作
    mysqli_dump_debug_info() - 将调试信息输出到日志
    set_exception_handler() - 设置用户自定义的异常处理函数
    error_reporting() - 设置应该报告何种 PHP 错误