get_error_handler

(PHP 8 >= 8.5.0)

get_error_handler — ユーザー定義のエラーハンドラ関数を取得する

説明

get_error_handler(): ?callable

存在する場合に、現在のエラーハンドラ関数を返します。

パラメータ

この関数にはパラメータはありません。

戻り値

(もしあれば)現在定義済みのエラーハンドラを返します。組み込みのエラーハンドラを使っている場合は、null を返します。

返されたエラーハンドラは、 set_error_handler() に渡された callable そのものです。

例

例1 get_error_handler() の例

<?php

$handler = function (int $errno, string $errstr, ?string $errfile, ?int $errline) {
     echo "Error: " . $errstr . "\n";
};

var_dump(get_error_handler()); // NULL

set_error_handler($handler);

var_dump(get_error_handler() === $handler); // bool(true)

?>

注意

ヒント

PHP 8.5.0 より前のバージョンでは、この関数の機能は以下のような polyfill で提供できます:

<?php
if (!function_exists('get_error_handler')) {
    function noop_error_handler() {
    }
    function get_error_handler(): ?callable {
        $handler = set_error_handler('noop_error_handler');
        restore_error_handler();
        return $handler;
    }
}
?>

参考

error_reporting() - 出力する PHP エラーの種類を設定する
set_error_handler() - ユーザー定義のエラーハンドラ関数を設定する
restore_error_handler() - 以前のエラーハンドラ関数を回復する
trigger_error() - ユーザーレベルのエラー/警告/通知メッセージを生成する
エラーレベル定数