php set_error_handler() 详细用法

Posted 脚本叔叔

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了php set_error_handler() 详细用法相关的知识,希望对你有一定的参考价值。

转载: http://us.php.net/manual/en/function.set-error-handler.php

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. //自定义的错误处理函数一定要有这4个输入变量$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代码  
  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 "<b>My ERROR</b> [$errno] $errstr<br />\\n";  
  12.         echo "  Fatal error on line $errline in file $errfile";  
  13.         echo ", PHP " . PHP_VERSION . " (" . PHP_OS . ")<br />\\n";  
  14.         echo "Aborting...<br />\\n";  
  15.         exit(1);  
  16.         break;  
  17.   
  18.     case E_USER_WARNING:  
  19.         echo "<b>My WARNING</b> [$errno] $errstr<br />\\n";  
  20.         break;  
  21.   
  22.     case E_USER_NOTICE:  
  23.         echo "<b>My NOTICE</b> [$errno] $errstr<br />\\n";  
  24.         break;  
  25.   
  26.     default:  
  27.         echo "Unknown error type: [$errno] $errstr<br />\\n";  
  28.         break;  
  29.       
  30.   
  31.     /* Don't execute PHP internal error handler */  
  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'PHP set_error_handler()函数的使用

    php set_error_handler

    php set_error_handler() 详细用法

    设置了set_error_handler,但是执行一个未定义的函数时,还是显示php自带错误提示?

    set_error_handler与set_exception_handler

    php 中的错误处理机制