PHP set_error_handler()函數使用詳解（示例）

2024-05-04 23:19:34

字體：大中小

來源：轉載

供稿：網友

我們寫程序，難免會有問題（是經常會遇到問題），而PHP遇到錯誤時，就會給出出錯腳本的位置、行數和原因。有很多人說，這并沒有什么大不了。確實，在調試程序階段，這確實是沒啥的，而且我認為給出錯誤路徑是必要的。
但泄露了實際路徑的后果是不堪設想的，對于某些入侵者，這個信息可是非常重要，而事實上現在有很多的服務器都存在這個問題。有些網管干脆把PHP配置文件中的display_errors設置為Off來解決（貌似我們就是這樣做的），但本人認為這個方法過于消極。
有些時候，我們的確需要PHP返回錯誤的信息以便調試。而且在出錯時也可能需要給用戶一個交待，甚至導航到另一頁面。那么，有啥解決辦法呢？
set_error_handler()
PHP從4.1.0開始提供了自定義錯誤處理句柄的功能函數set_error_handler()，但很少數腳本編寫者知道。set_error_handler這個函數可以很好地防止錯誤路徑泄露，當然還有其它更多的作用。
可以用來屏蔽錯誤。出現錯誤一來會把一些信息暴漏給用戶，極有可能成為黑客攻擊你網站的工具。二來讓用戶覺得你的水平很挫。
可以記下錯誤的信息，及時發現一些生產環境的出現的問題。
可以做相應的處理，出錯的時候可以顯示跳轉到預先定義好的出錯頁面，提供更好的用戶體驗。
可以作為調試工具，一些時候必須在生產環境調試一些東西，但又不想影響正在使用的用戶。
set_error_handler的使用方法如下：

復制代碼代碼如下:

string set_error_handler ( callback error_handler [, int error_types])

現在我們就用自定義的錯誤處理把實際路徑過濾掉。假設有一個變量$admin，我們是用來判斷訪問者是否是管理員的（可以通過IP或者登錄的用戶id來做這個判斷）

復制代碼代碼如下:

//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) /n";
        echo "程序已經停止運行，請聯系管理員。";
        //遇到Error級錯誤時退出腳本
        exit;
        break;

        case E_WARNING:
        echo "WARNING: [ID $errno] $errstr (Line: $errline of $errfile) /n";
        break;

        default:
        //不顯示Notice級的錯誤
        break;
    }
}

這樣就自定義了一個錯誤處理函數，那么怎么把錯誤的處理交給這個自定義函數呢？

復制代碼代碼如下:

// 應用到類
set_error_handler(array(&$this,"appError"));

//示例的做法
set_error_handler("my_error_handler");

so easy，這樣，就可以很好地解決安全和調試方便的矛盾了。而且你還可以花點心思，使錯誤提示更加美觀以配合網站的風格。
原作者給出了兩點需要注意的地方，我也放出來吧，希望引起廣大同胞們的注意：
1、E_ERROR、E_PARSE、E_CORE_ERROR、E_CORE_WARNING、 E_COMPILE_ERROR、E_COMPILE_WARNING是不會被這個句柄處理的，也就是會用最原始的方式顯示出來。不過出現這些錯誤都是編譯或PHP內核出錯，在通常情況下不會發生。
2、使用set_error_handler()后，error_reporting ()將會失效。也就是所有的錯誤（除上述的錯誤）都會交給自定義的函數處理。
最后，出一個示例

復制代碼代碼如下:

//先定義一個函數，也可以定義在其他的文件中，再用require()調用
function myErrorHandler($errno, $errstr, $errfile, $errline)
{
　　　　　//為了安全起見，不暴露出真實物理路徑，下面兩行過濾實際路徑
 $errfile=str_replace(getcwd(),"",$errfile);
 $errstr=str_replace(getcwd(),"",$errstr);

 switch ($errno) {
 case E_USER_ERROR:

 echo "My ERROR [$errno] $errstr /n";
 echo " Fatal error on line $errline in file $errfile";
 echo ", PHP " . PHP_VERSION . " (" . PHP_OS . ") /n";
 echo "Aborting... /n";
 exit(1);
 break;

 case E_USER_WARNING:
 echo "My WARNING [$errno] $errstr /n";
 break;

 case E_USER_NOTICE:
 echo "My NOTICE [$errno] $errstr /n";
 break;

 default:
 echo "Unknown error type: [$errno] $errstr /n";
 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);
}