PHPのrestore_error_handler()関数とは？使い方とサンプルコードを解説

PHPのrestore_error_handler()関数は、直前に設定されていたエラーハンドラを復元するための関数です。set_error_handler()を使ってエラーハンドラ関数を変更した後、元のエラーハンドラ（PHP組み込みのハンドラ、またはユーザー定義のハンドラ）に戻したい場合に利用されます。

基本的な役割

PHPでは、set_error_handler()を使用することで、独自のカスタムエラー処理を定義できます。しかし、一時的にカスタムハンドラへ切り替えた後、処理が終わったらデフォルトの動作に戻したいケースは少なくありません。そんなときにrestore_error_handler()を呼び出せば、直前のエラーハンドラへ簡単に復元できます。

構文

restore_error_handler()

パラメータ

• なし — この関数は引数を受け取りません。

戻り値

restore_error_handler()関数は常に TRUE を返します。

使用例

以下は、カスタムエラーハンドラを設定した後に復元する具体例です。

<?php
function unserialize_handler($errno, $errstr) {
    echo "Custom error: Invalid hello value.\n";
}
$hello = 'pqrs';
set_error_handler('unserialize_handler');
$original = unserialize($hello);
restore_error_handler();
?>

実行結果

Custom error: Invalid hello value.

コードの解説

この例では、まずunserialize_handlerというユーザー定義関数をエラーハンドラとして登録しています。その後、無効な値に対してunserialize()を実行すると、カスタムハンドラが呼び出され、独自のエラーメッセージが出力されます。最後にrestore_error_handler()を呼び出すことで、それまで使用していたエラーハンドラに戻しています。

まとめ

restore_error_handler()は、エラーハンドラの一時的な切り替えと復元を安全に行うための便利な関数です。カスタムエラー処理が必要な特定の処理ブロックでのみハンドラを差し替えたい場合など、柔軟なエラー管理を実現するのに役立ちます。