エラー処理 : PHP

Tweet

Pocket

PHPのエラー処理についてメモしています。PHPは言語としてtry catch文で例外処理が行えます。
本投稿では例外処理については記載していません。またどのようにエラーと例外を使い分けるかといったことも記載していません。

エラーレベル

PHPはエラーに応じてレベルが設定されています。
定義済み定数 PHP: Manual
下記表は上記マニュアルより引用。

エラーは下記のように分類できる。

• 処理を中断するエラー
  処理を中断するエラーはset_error_handlerでハンドリングできません(ただしcatch可能な致命的エラーはハンドリングが可能です)。
  • Fatal Error(致命的なエラー : E_ERROR 値1)
  • Parse Error(構文エラー : E_PARSE 値4)
• 処理を中断しないエラー
  処理を中断しないエラーはset_error_handlerでハンドリングできます。
  • Warning(警告 : E_WARNING 値2)
  • Notice(注意 : E_NOTICE 値8)

Fatal Errorの例

<?php
echo(some());　// some関数を定義していない。Fatal Error発生。スクリプトを中断。
echo '終了';   // ここは処理されない。
?>

Noticeの例

<?php
echo($some); // someという変数を宣言していない。ここでNoticeが発生。
echo '終了'; // Noticeはスクリプトを中断しない。ここも実行され終了と表示される。
?>

エラーログ

ログは大きくデバッグのためのログとエラーログがあります。
php.iniのエラーログに関する詳細は下記を参考にしてください。
PHP: 実行時設定 – Manual

error_log関数はエラーログだけでなく通常のログ出力もできます。

error_log($message, 3, 'debug.log');

php.iniのエラー関連ディレクティブ

エラー関連関数

エラー関連の定義済み定数

PHP: 定義済み定数 – Manual

画面出力せずログへ出力する例

1) エラー出力レベル設定

error_reporting = E_ALL & ~E_NOTICE & ~E_WARNING   # 表示レベル設定(E_NOTICEとE_WARNING以外を報告)

PHP: error_reporting – Manual

2) エラーの画面出力禁止

display_errors=Off # 画面へエラー表示禁止(デフォルトはOff)

3) ログ出力を許可、出力ファイル指定

log_errors=On                      # ログ出力許可。
error_log = /var/log/php/error.log # ログ出力ファイル指定。 PHP実行ユーザーが書き込める必要があります。  

log_errorsがOnでerror_logが指定されていないときはhttpdのエラーログへ出力されます。

エラーハンドリング(set_error_handler)の例

<?php
set_error_handler(function ($errno, $errstr, $errfile, $errline){
    echo "エラー情報: NO: {$errno}, メッセージ: {$errstr}, ファイル: {$errfile}, 行 {$errline}";
});

$a++; // エラー情報: NO: 8, メッセージ: Undefined variable: a, ファイル: /path/to/script.php, 行 9

restore_error_handler();

$b++; // Notice: Undefined variable: b in /path/to/script.php on line 11

errnoの8はE_NOTICEに対応します。