thinkPhp set_error_handler()函數的用法

來源:互聯網
上載者:User

定義和用法
set_error_handler() 函數設定使用者自訂的錯誤處理函數。

該函數用於建立運行時期間的使用者自己的錯誤處理方法。

該函數會返回舊的錯誤處理程式,若失敗,則返回 null。

文法
set_error_handler(error_function,error_types)

參數 描述
error_function 必需。規定發生錯誤時啟動並執行函數。
error_types 可選。規定在哪個錯誤報表層級會顯示使用者定義的錯誤。預設是 “E_ALL”。

提示和注釋
提示:如果使用了該函數,會完全繞過標準的 PHP 錯誤處理函數,如果必要,使用者定義的錯誤處理程式必須終止 (die() ) 指令碼。

注意:如果在指令碼執行前發生錯誤,由於在那時自訂程式還沒有註冊,因此就不會用到這個自訂錯誤處理程式。

先來看一下thinkphp裡對appError這個函數的定義

 代碼如下 複製代碼
    public function appError($errno, $errstr, $errfile, $errline)
    {
      switch ($errno) {
          case E_ERROR:
          case E_USER_ERROR:
              $errorStr = "錯誤:[$errno] $errstr ".basename($errfile)." 第 $errline 行.n";
              if(C('WEB_LOG_RECORD')){
                 Log::record($errorStr);
                 Log::save();
              }
              halt($errorStr);
              break;
          case E_STRICT:
          case E_USER_WARNING:
          case E_USER_NOTICE:
          default:
            $errorStr = "注意:[$errno] $errstr ".basename($errfile)." 第 $errline 行.n";
            Log::record($errorStr);
             break;
      }
    }

不過我對這個寫法還是抱有疑義,為啥不直接用if else搞定呢?因為貌似看這個邏輯,if else足以,有些頭暈。
已經在論壇上面向高手們請教了,不過現在還沒有回複,貌似TP的論壇上的高手反應都不快,或者是我的問題太過淺顯了?呵。
說正題,看到這個函數裡面的這些錯誤方式,以及init裡的set_error_handler,
因為我沒有用過這個函數,所以就要去問一下google了。我不覺得這是丟人的事哈。
下面把我認為最好的一篇文章轉載一下,抱歉,他原來的格式有些亂,我稍微整理了一下。
原文地址:set_error_handler() 用法 作者:白天的影子
set_error_handler這個函數的作用是為了防止錯誤路徑泄露
何為錯誤路徑泄露呢?
我們寫程式,難免會有問題(是經常會遇到問題  ),而PHP遇到錯誤時,就會給出出錯指令碼的位置、行數和原因
有很多人說,這並沒有什麼大不了。確實,在偵錯工具階段,這確實是沒啥的,而且我認為給出錯誤路徑是必要的。
但泄露了實際路徑的後果是不堪設想的,對於某些入侵者,這個資訊可是非常重要,而事實上現在有很多的伺服器都存在這個問題。
有些網管乾脆把PHP設定檔中的display_errors設定為Off來解決(貌似我們就是這樣做的),但本人認為這個方法過於消極。
有些時候,我們的確需要PHP返回錯誤的資訊以便調試。而且在出錯時也可能需要給使用者一個交待,甚至導航到另一頁面。
那麼,有啥解決辦法呢?
PHP從4.1.0開始提供了自訂錯誤處理控制代碼的功能函數set_error_handler(),但很少數指令碼編寫者知道。
很不好意思的是,我就不知道,剛翻了google才知道,慚愧啊。。
在眾多的PHP論壇中,我只看見很少一部分對此情況進行了處理。(確實有一些牛逼論壇也會有這個問題啊)
set_error_handler的使用方法如下:
string set_error_handler ( callback error_handler [, int error_types])
現在我們就用自訂的錯誤處理把實際路徑過濾掉。
例如:假設有一個變數$admin,我們是用來判斷訪問者是否是管理員的(可以通過IP或者登入的使用者id來做這個判斷)

 代碼如下 複製代碼

//admin為管理員的身份判定,true為管理員。
//自訂的錯誤處理函數一定要有這4個輸入變數$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;
    }

}這樣就自訂了一個錯誤處理函數,和thinkphp的appError是一樣的。呵呵。
那麼怎麼把錯誤的處理交給這個自訂函數呢?
//thinkphp 的做法
set_error_handler(array(&$this,"appError"));
//樣本的做法
set_error_handler("my_error_handler");so easy,這樣,就可以很好地解決安全和調試方便的矛盾了。而且你還可以花點心思,使錯誤提示更加美觀以配合網站的風格。
原作者給出了兩點需要注意的地方,我也放出來吧,希望引起廣大同胞們的注意:
E_ERROR、E_PARSE、E_CORE_ERROR、E_CORE_WARNING、E_COMPILE_ERROR、E_COMPILE_WARNING是不會被這個控制代碼處理的,也就是會用最原始的方式顯示出來。不過出現這些錯誤都是編譯或PHP核心出錯,在通常情況下不會發生。
使用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 "<b>My ERROR</b> [$errno] $errstr<br />n";
        echo "  Fatal error on line $errline in file $errfile";
        echo ", PHP " . PHP_VERSION . " (" . PHP_OS . ")<br />n";
        echo "Aborting...<br />n";
        exit(1);
        break;

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

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

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

嗯,根據上面的那些解釋,以及原作者認真負責的態度,我想如果我還學不會這個set_error_handler函數,那麼我真該去撞牆了

 

錯誤路徑泄露
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為管理員。
//自訂的錯誤處理函數一定要有這4個輸入變數$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的官方手冊。

下面我舉個實際應用中的例子:

 代碼如下 複製代碼

<?php
//先定義一個函數,也可以定義在其他的檔案中,再用require()調用
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 />n";
   echo "Fatal error on line $errline in file $errfile";
   echo ", PHP " . PHP_VERSION . " (" . PHP_OS . ")<br />n";
   echo "Aborting...<br />n";
   exit(1);
  break;

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

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

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

需要注意的是:
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");
}
?>

聯繫我們

該頁面正文內容均來源於網絡整理,並不代表阿里雲官方的觀點,該頁面所提到的產品和服務也與阿里云無關,如果該頁面內容對您造成了困擾,歡迎寫郵件給我們,收到郵件我們將在5個工作日內處理。

如果您發現本社區中有涉嫌抄襲的內容,歡迎發送郵件至: info-contact@alibabacloud.com 進行舉報並提供相關證據,工作人員會在 5 個工作天內聯絡您,一經查實,本站將立刻刪除涉嫌侵權內容。

A Free Trial That Lets You Build Big!

Start building with 50+ products and up to 12 months usage for Elastic Compute Service

  • Sales Support

    1 on 1 presale consultation

  • After-Sales Support

    24/7 Technical Support 6 Free Tickets per Quarter Faster Response

  • Alibaba Cloud offers highly flexible support services tailored to meet your exact needs.