set_error_handler() 重要用法

set_error_handler这个函数的作用是为了防止错误路径泄露

 

何为错误路径泄露呢？

我们写程序，难免会有问题（是经常会遇到问题  ），而PHP遇到错误时，就会给出出错脚本的位置、行数和原因

有很多人说，这并没有什么大不了。确实，在调试程序阶段，这确实是没啥的，而且我认为给出错误路径是必要的。

但泄露了实际路径的后果是不堪设想的，对于某些入侵者，这个信息可是非常重要，而事实上现在有很多的服务器都存在这个问题。

 

有些网管干脆把PHP配置文件中的display_errors设置为Off来解决（貌似我们就是这样做的），但本人认为这个方法过于消极。

 

有些时候，我们的确需要PHP返回错误的信息以便调试。而且在出错时也可能需要给用户一个交待，甚至导航到另一页面。

 

那么，有啥解决办法呢？

PHP从4.1.0开始提供了自定义错误处理句柄的功能函数set_error_handler()，但很少数脚本编写者知道。

 

 

set_error_handler的使用方法如下：

 

Php代码   

1. string set_error_handler ( callback error_handler [, int error_types])   

 

现在我们就用自定义的错误处理把实际路径过滤掉。

 

如：假设有一个变量$admin，我们是用来判断访问者是否是管理员的（可以通过IP或者登录的用户id来做这个判断）

 

Php代码

1. //admin为管理员的身份判定，true为管理员。  
2. //自定义的错误处理函数一定要有这４个输入变量$errno,$errstr,$errfile,$errline，否则无效。  
3. \function my_error_handler($errno,$errstr,$errfile,$errline)  
4. {  
5.     //如果不是管理员就过滤实际路径  
6.     if(!admin)  
7.     {  
8.         $errfile=str_replace(getcwd(),"",$errfile);  
9.         $errstr=str_replace(getcwd(),"",$errstr);  
10.     }  
11.     switch($errno)  
12.     {  
13.         case E_ERROR:  
14.         echo "ERROR: [ID $errno] $errstr (Line: $errline of $errfile) \n";  
15.         echo "程序已经停止运行，请联系管理员。";  
16.         //遇到Error级错误时退出脚本  
17.         exit;  
18.         break;  
19.   
20.         case E_WARNING:  
21.         echo "WARNING: [ID $errno] $errstr (Line: $errline of $errfile) \n";  
22.         break;  
23.   
24.         default:  
25.         //不显示Notice级的错误  
26.         break;  
27.     }  
28. }  

 

这样就自定义了一个错误处理函数，那么怎么把错误的处理交给这个自定义函数呢？

 

Php代码   

1. // 应用到类  
2. set_error_handler(array(&$this,"appError"));  
3.   
4. //示例的做法  
5. 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 ()将会失效。也就是所有的错误（除上述的错误）都会交给自定义的函数处理。

 

最后，原作者又给出了一个示例（真是个认真负责的好人哈。呵呵）

 

Php代码  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; } 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); }" wmode="transparent"> 

1. //先定义一个函数，也可以定义在其他的文件中，再用require()调用  
2. \function myErrorHandler($errno, $errstr, $errfile, $errline)  
3. {  
4. 　　　　　//为了安全起见，不暴露出真实物理路径，下面两行过滤实际路径  
5.     $errfile=str_replace(getcwd(),"",$errfile);  
6.     $errstr=str_replace(getcwd(),"",$errstr);  
7.   
8.     switch ($errno) {  
9.     case E_USER_ERROR:  
10.   
11.      echo "My ERROR [$errno] $errstr\n";  
12.         echo "  Fatal error on line $errline in file $errfile";  
13.         echo ", PHP " . PHP_VERSION . " (" . PHP_OS . ")\n";  
14.         echo "Aborting...\n";  
15.         exit(1);  
16.         break;  
17.   
18.     case E_USER_WARNING:  
19.         echo "My WARNING [$errno] $errstr\n";  
20.         break;  
21.   
22.     case E_USER_NOTICE:  
23.         echo "My NOTICE [$errno] $errstr\n";  
24.         break;  
25.   
26.     default:  
27.         echo "Unknown error type: [$errno] $errstr\n";  
28.         break;  
29.     }  
30.   
31.       
32.     return true;  
33. }  
34.   
35. //下面开始连接MYSQL服务器，我们故意指定MYSQL端口为3333,实际为3306。  
36. $link_id=@mysql_pconnect("localhost:3333","root","password");  
37. set_error_handler(myErrorHandler);  
38. if (!$link_id) {  
39.     trigger_error("出错了", E_USER_ERROR);  
40.     }  

 

 

嗯，根据上面的那些解释，以及原作者认真负责的态度，我想如果我还学不会这个set_error_handler函数，那么我真该去撞墙了。 

 

 

好了，总结一下，下面是 set_error_handler 三种用法：

 

Php代码   

1. \class CallbackClass {  
2.    function CallbackFunction() {  
3.        // refers to $this  
4.    }  
5.   
6.    function StaticFunction() {  
7.        // doesn't refer to $this  
8.    }  
9. }  
10.   
11. \function NonClassFunction($errno, $errstr, $errfile, $errline) {  
12. }  
13.   
14. // 三种方法如下:  
15.   
16. 1: set_error_handler('NonClassFunction');  // 直接转到一个普通的函数 NonClassFunction  
17.   
18. 2: set_error_handler(array('CallbackClass', 'StaticFunction')); // 转到 CallbackClass 类下的静方法 StaticFunction  
19.   
20. 3: $o =& new CallbackClass();  
21.     set_error_handler(array($o, 'CallbackFunction'));  // 转到类的构造函数，其实本质上跟下面的第四条一样。  
22.   
23. 4. $o = new CallbackClass();  
24.   
25.   
26. // The following may also prove useful:  
27.   
28. \class CallbackClass {  
29.    function CallbackClass() {  
30.        set_error_handler(array(&$this, 'CallbackFunction')); // the & is important  
31.    }  
32.      
33.    function CallbackFunction() {  
34.        // refers to $this  
35.    }  
36. }  

 

其他请见： http://us.php.net/manual/en/function.set-error-handler.php