定義和用法
set_error_handler() 函數設置用戶自定義的錯誤處理函數。 該函數用於創建運行時期間的用戶自己的錯誤處理方法。 該函數會返回舊的錯誤處理程序，若失敗，則返回 null。
語法
set_error_handler(error_function,error_types)
| 參數 | 描述 |
|---|---|
| error_function | 必需。規定發生錯誤時運行的函數。 |
| error_types | 可選。規定在哪個錯誤報告級別會顯示用戶定義的錯誤。默認是 "E_ALL"。 |
提示和注釋
提示：如果使用了該函數，會完全繞過標准的 PHP 錯誤處理函數，如果必要，用戶定義的錯誤處理程序必須終止 (die() ) 腳本。 注意：如果在腳本執行前發生錯誤，由於在那時自定義程序還沒有注冊，因此就不會用到這個自定義錯誤處理程序。
例子
<?php
//error handler function
function customError($errno, $errstr, $errfile, $errline) {
echo "<b>Custom error:</b> [$errno] $errstr<br />";
echo "Error on line $errline in $errfile<br />";
echo "Ending Script";
die();
}
//set error handler
set_error_handler("customError");
$test=2;
//trigger error
if ($test > 1) {
trigger_error("A custom error has been triggered");
}
?>
輸出：
Custom error: [1024] A custom error has been triggered Error on line 19 in C:webfolder est.php Ending Script
需要注意的是：
set_error_handler("customError") 不僅可以接受函數，還可以接受 類的方法（公開的靜態方法 及 公開的非靜態方法 都可以），但需要以 數組形式 傳遞，數組的第一值為“類名”，第二個參數為“方法名”，如下代碼所示：
<?php
class App{
//error handler function
function customError($errno, $errstr, $errfile, $errline) {
echo "<b>Custom error:</b> [$errno] $errstr<br />";
echo "Error on line $errline in $errfile<br />";
echo "Ending Script";
die();
}
}
//set error handler
set_error_handler(array("App","customError"));
$test=2;
//trigger error
if ($test > 1) {
trigger_error("A custom error has been triggered");
}
?>
錯誤路徑泄露
1.漏洞原因： PHP遇到錯誤時，就會給出出錯腳本的位置、行數和原因，例如：
Notice: Use of undefined constant test - assumed ''test'' in D:interpubbigflytest.php on line 3
有很多人說，這並沒有什么大不了。但泄露了實際路徑的后果是不堪設想的，對於某些入侵者，這個信息可是非常重要，而事實上現在有很多的服務器都存在這個問題。 有些網管干脆把PHP配置文件中的 display_errors 設置為 Off 來解決，但本人認為這個方法過於消極。有些時候，我們的確需要PHP返回錯誤的信息以便調試。而且在出錯時也可能需要給用戶一個交待，甚至導航到另一頁面。 2.漏洞解決： PHP從4.1.0開始提供了自定義錯誤處理句柄的功能函數 set_error_handler() ，但很少數腳本編寫者知道。在眾多的PHP論壇中，我只看見很少一部分對此情況進行了處理。set_error_handler的使用方法如下：
string set_error_handler ( callback error_handler [, int error_types])
現在我們就用自定義的錯誤處理把實際路徑過濾掉。
<?php
//admin為管理員的身份判定，true為管理員。
//自定義的錯誤處理函數一定要有這４個輸入變量$errno,$errstr,$errfile,$errline，否則無效。
function my_error_handler($errno, $errstr, $errfile, $errline) {
//如果不是管理員就過濾實際路徑
if (!admin) {
$errfile = str_replace(getcwd(), "", $errfile);
$errstr = str_replace(getcwd(), "", $errstr);
}
switch ($errno) {
case E_ERROR:
echo "ERROR: [ID $errno] $errstr (Line: $errline of $errfile)";
echo "程序已經停止運行，請聯系管理員。";
//遇到Error級錯誤時退出腳本
exit;
break;
case E_WARNING:
echo "WARNING: [ID $errno] $errstr (Line: $errline of $errfile)";
break;
default:
//不顯示Notice級的錯誤
break;
}
}
//把錯誤處理設置為my_error_handler函數
set_error_handler("my_error_handler");
...
?>
這樣，就可以很好地解決安全和調試方便的矛盾了。而且你還可以花點心思，使錯誤提示更加美觀以配合網站的風格。不過注意兩點是： （1）E_ERROR、 E_PARSE、E_CORE_ERROR、E_CORE_WARNING、E_COMPILE_ERROR、E_COMPILE_WARNING是不會 被這個句柄處理的，也就是會用最原始的方式顯示出來。不過出現這些錯誤都是編譯或PHP內核出錯，在通常情況下不會發生。 （2）使用set_error_handler()后，error_reporting ()將會失效。也就是所有的錯誤（除上述的錯誤）都會交給自定義的函數處理。 其它有關於set_error_handler()的信息，大家可以參考PHP的官方手冊。 下面我舉個實際應用中的例子：
<index.php>
<?php
/**
* 先定義一個錯誤處理函數，也可以定義在其他的文件中，再用require()調用
*
* @param $errno 錯誤編號
* @param $errstr 錯誤消息
* @param $errfile 錯誤所在的文件
* @param $errline 錯誤所在的行
* @return bool
*/
function myErrorHandler($errno, $errstr, $errfile, $errline) {
// 為了安全起見，不暴露出真實物理路徑，下面兩行過濾實際路徑
$errfile = str_replace(getcwd(), "", $errfile);
$errstr = str_replace(getcwd(), "", $errstr);
switch ($errno) {
case E_USER_ERROR:
echo "<b>My ERROR</b> [$errno] $errstr<br />";
echo "Fatal error on line $errline in file $errfile";
echo ", PHP " . PHP_VERSION . " (" . PHP_OS . ")<br />";
echo "Aborting...<br />";
exit(1);
break;
case E_USER_WARNING:
echo "<b>My WARNING</b> [$errno] $errstr<br />";
break;
case E_USER_NOTICE:
echo "<b>My NOTICE</b> [$errno] $errstr<br />";
break;
default:
echo "Unknown error type: [$errno] $errstr<br />";
break;
}
/* Don't execute PHP internal error handler */
return true;
}
// 下面開始連接MYSQL服務器，我們故意指定MYSQL端口為3333,實際為3306。
$link_id = @mysql_pconnect("localhost:3333", "root", "password");
set_error_handler(myErrorHandler);
if (!$link_id) {
trigger_error("出錯了", E_USER_ERROR);
}
?>
延伸閱讀：