PHP set_error_handler() 函數(shù)用法及示例

PHP Error & Loggings 參考手冊(cè)

set_error_handler()函數(shù)設(shè)置用戶自定義的錯(cuò)誤處理函數(shù)

語法

mixed set_error_handler ( callback $error_handler [, int $error_types] );

定義和用法

設(shè)置用戶的函數(shù) (error_handler) 來處理腳本中出現(xiàn)的錯(cuò)誤。
本函數(shù)可以用你自己定義的方式來處理運(yùn)行中的錯(cuò)誤， 例如，在應(yīng)用程序中嚴(yán)重錯(cuò)誤發(fā)生時(shí)，或者在特定條件下觸發(fā)了一個(gè)錯(cuò)誤(使用 trigger_error())，你需要對(duì)數(shù)據(jù)/文件做清理回收。
重要的是要記住 error_types 里指定的錯(cuò)誤類型都會(huì)繞過 PHP 標(biāo)準(zhǔn)錯(cuò)誤處理程序， 除非回調(diào)函數(shù)返回了 FALSE。 error_reporting() 設(shè)置將不會(huì)起到作用而你的錯(cuò)誤處理函數(shù)繼續(xù)會(huì)被調(diào)用 —— 不過你仍然可以獲取 error_reporting 的當(dāng)前值，并做適當(dāng)處理。 需要特別注意的是帶 @ error-control operator 前綴的語句發(fā)生錯(cuò)誤時(shí)，這個(gè)值會(huì)是 0。
同時(shí)注意，在需要時(shí)你有責(zé)任使用 die()。 如果錯(cuò)誤處理程序返回了，腳本將會(huì)繼續(xù)執(zhí)行發(fā)生錯(cuò)誤的后一行。
以下級(jí)別的錯(cuò)誤不能由用戶定義的函數(shù)來處理： E_ERROR、 E_PARSE、 E_CORE_ERROR、 E_CORE_WARNING、 E_COMPILE_ERROR、 E_COMPILE_WARNING，和在 調(diào)用 set_error_handler() 函數(shù)所在文件中產(chǎn)生的大多數(shù) E_STRICT。
如果錯(cuò)誤發(fā)生在腳本執(zhí)行之前（比如文件上傳時(shí)），將不會(huì) 調(diào)用自定義的錯(cuò)誤處理程序因?yàn)樗形丛谀菚r(shí)注冊(cè)。

參數(shù)

錯(cuò)誤處理程序函數(shù)語法

error_function(error_level,error_message, error_file,error_line,error_context);

這是paramenter的描述-

• errno  -  第一個(gè)參數(shù) errno，包含了錯(cuò)誤的級(jí)別，是一個(gè) integer。
  

• errstr  -  第二個(gè)參數(shù) errstr，包含了錯(cuò)誤的信息，是一個(gè) string。
  

• errfile - 第三個(gè)參數(shù)是可選的，errfile， 包含了發(fā)生錯(cuò)誤的文件名，是一個(gè) string。
  

• errline - 第四個(gè)參數(shù)是一個(gè)可選項(xiàng)， errline， 包含了錯(cuò)誤發(fā)生的行號(hào)，是一個(gè) integer。
  

• errcontext - 第五個(gè)可選參數(shù)， errcontext， 是一個(gè)指向錯(cuò)誤發(fā)生時(shí)活動(dòng)符號(hào)表的 array。 也就是說，errcontext 會(huì)包含錯(cuò)誤觸發(fā)處作用域內(nèi)所有變量的數(shù)組。 用戶的錯(cuò)誤處理程序不應(yīng)該修改錯(cuò)誤上下文(context)。
  

返回值

 如果之前有定義過錯(cuò)誤處理程序，則返回該程序名稱的 string；如果是內(nèi)置的錯(cuò)誤處理程序，則返回 NULL。 如果你指定了一個(gè)無效的回調(diào)函數(shù)，同樣會(huì)返回 NULL。 如果之前的錯(cuò)誤處理程序是一個(gè)類的方法，此函數(shù)會(huì)返回一個(gè)帶類和方法名的索引數(shù)組(indexed array)。

在線示例

以下是此set_error_handler函數(shù)的用法：

<?php
   function customError($errno, $errstr, $errfile, $errline) {
      echo "Custom error: [$errno] $errstr\n";
      echo "Error on line $errline in $errfile\n";
      echo "Ending Script";
      
      die();
   }
   
   //設(shè)置錯(cuò)誤處理程序
   set_error_handler("customError");
   $test = 0;
   
   //觸發(fā)錯(cuò)誤
   if ($test >  -1) {
      trigger_error("已觸發(fā)自定義錯(cuò)誤");
   }
?>

輸出結(jié)果：

Custom error: [1024] A custom error has been triggered Error on line 16 
in /home/cg/root/1531703/main.php 
Ending Script