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): bool

    フラグに応じて、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_ERRORmysqli の関数呼び出しからのエラーを報告する
    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 = 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());
    }

    例2 手続き型

    <?php


    mysqli_report(MYSQLI_REPORT_ALL);

    try {

    $link = mysqli_connect("localhost", "my_user", "my_password", "my_db");


    $result = mysqli_query($link, "SELECT Name FROM Nonexistingtable WHERE population > 50000");


    $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 = new mysqli("localhost", "my_user", "my_password", "my_db");
    $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());
    }

    参考

    To Top