在编写PHP程序时,错误处理是一个重要的部分。如果程序中缺少错误检测代码,那么看上去很不专业,也为安全风险敞开了大门
例:
2 | $a = fopen ( 'test.txt' , 'r' ); |
那么正确的写法应该如下:
2 | if ( file_exists ( 'test.txt' )) { |
3 | $f = fopen ( 'test.txt' , 'r' ); |
一、PHP错误处理的三种方式
A、简单的die()语句;
等价于exit();
例:
1 | if (! file_exists ( 'aa.txt' )) { |
简洁写法:
1 | file_exits( 'aaa.txt' ) or die ( '文件不存在' ); |
B、自定义错误和错误触发器
1、错误处理器(自定义错误,一般用于语法错误处理)
创建自定义错误函数(处理器),该函数必须有能力处理至少两个参数(error_level和errormessage),但是可以接受最多五个参数(error_file、error_line、error_context)
语法:
function error_function($error_level, $error_message, $error_file, $error_line, $error_context)
// 创建好后还需要改写set_error_handler();函数
set_error_handler('error_function', E_WARNING); // 这里error_function对应上面创建的自定义处理器名,第二个参数为使用自定义错误处理器的错误级别;
错误报告级别(了解即可)
这些错误报告级别是错误处理程序旨在处理的错误的不同的类型:
值 | 常量 | 描述 |
---|
2 | E_WARNING | 非致命的 run-time 错误。不暂停脚本执行。 |
8 | E_NOTICE | Run-time 通知。脚本发现可能有错误发生,但也可能在脚本正常运行时发生。 |
256 | E_USER_ERROR | 致命的用户生成的错误。这类似于程序员使用 PHP 函数 trigger_error() 设置的 E_ERROR。 |
512 | E_USER_WARNING | 非致命的用户生成的警告。这类似于程序员使用 PHP 函数 trigger_error() 设置的 E_WARNING。 |
1024 | E_USER_NOTICE | 用户生成的通知。这类似于程序员使用 PHP 函数 trigger_error() 设置的 E_NOTICE。 |
4096 | E_RECOVERABLE_ERROR | 可捕获的致命错误。类似 E_ERROR,但可被用户定义的处理程序捕获。(参见 set_error_handler()) |
8191 | E_ALL | 所有错误和警告,除级别 E_STRICT 以外。(在 PHP 6.0,E_STRICT 是 E_ALL 的一部分) |
2、错误触发器(一般用于处理逻辑上的错误)
需求:比如要接收一个年龄,如果数字大于120,就认为是一个错误
传统方法:
使用触发器:
05 | trigger_error( '年龄错误' ); |
11 | function myerror( $error_level , $error_message ) { |
16 | set_error_handler( 'myerror' , E_USER_WARNING); |
练习题:
02 | date_default_timezone_set( 'PRC' ); |
03 | function myerror( $error_level , $error_message ) { |
04 | $info = "错误号:$error_level" ; |
05 | $info .= "错误信息:$error_message" ; |
06 | $info .= '发生时间:' . date ( 'Y-m-d H:i:s' ); |
08 | if (! $fp = fopen ( $filename , 'a' )) { |
09 | echo '创建文件' . $filename . '失败' ; |
11 | if ( is_writeable ( $filename )) { |
12 | if (!fwrite( $fp , $info )) { |
19 | echo '文件' . $filename . '不可写' ; |
24 | set_error_handler( 'myerror' , E_WARNING); |
25 | $fp = fopen ( 'aaa.txt' , 'r' ); |
C、错误日志
默认的根据php.ini中error_log配置,PHP向服务器的错误记录系统或文件发送错误记录。通过使用error_log()函数可以向文件或远程目的地发送错误记录;
语法:
error_log(error[, type, destination, headers])
type部分一般用3,表示在文件后面追加错误信息,而不会覆盖原内容destination表示目的地,即存放的文件或远程目的地
如:error_log("$error_info",3,"errors.txt");
二、PHP异常处理【重点】
1、基本语法
05 | } catch (Exception $e ) { |
2、处理处理程序应当包括:
- try - 使用异常的函数应该位于 "try" 代码块内。如果没有触发异常,则代码将照常继续执行。但是如果异常被触发,会抛出一个异常;
- throw - 这里规定如何触发异常。每一个 "throw" 必须对应至少一个 "catch";
- catch - "catch" 代码块会捕获异常,并创建一个包含异常信息的对象;
让我们触发一个异常:
05 | function checkNum( $number ) { |
07 | throw new Exception( "Value must be 1 or below" ); |
17 | echo 'If you see this, the number is 1 or below' ; |
18 | } catch (Exception $e ) { |
20 | echo 'Message: ' . $e ->getMessage(); |
上面代码将获得类似这样一个错误:
1 | Message: Value must be 1 or below |
例子解释:
上面的代码抛出了一个异常,并捕获了它:
- 创建 checkNum() 函数,它检测数字是否大于 1,如果是,则抛出一个异常。
- 在 "try" 代码块中调用 checkNum() 函数。
- checkNum() 函数中的异常被抛出。
- "catch" 代码块接收到该异常,并创建一个包含异常信息的对象 ($e)。
- 通过从这个 exception 对象调用 $e->getMessage(),输出来自该异常的错误消息。
不过,为了遵循“每个 throw 必须对应一个 catch”的原则,可以设置一个顶层的异常处理器来处理漏掉的错误。
set_exception_handler()函数可设置处理所有未捕获异常的用户定义函数。
05 | function myexception( $e ) { |
06 | echo 'this is top exception' ; |
10 | set_exception_handler( "myexception" ); |
14 | throw new Exception( '$i must greater than 10' ); |
16 | } catch (Exception $e ) { |
18 | echo $e ->getMessage() . '<br/>' ; |
21 | throw new Exception( 'errorinfo' ); |
创建一个自定义的异常类
02 | class customException extends Exception { |
03 | public function errorMessage() { |
04 | $errorMsg = 'Error on line ' . $this ->getLine() . ' in ' . $this ->getFile() . ': <b>' . $this ->getMessage() . '</b> is not a valid E-Mail address' ; |
11 | throw new customException( 'error message' ); |
12 | } catch (customException $e ) { |
13 | echo $e ->errorMessage(); |
可以使用多个catch来返回不同情况下的错误信息
05 | throw new customException( 'error message' ); |
08 | throw new Exception( 'error2' ); |
10 | } catch (customException $e ) { |
11 | echo $e ->getMessage(); |
12 | } catch (Exception $e1 ) { |
13 | echo $e1 ->getMessage(); |
异常的规则
- 需要进行异常处理的代码应该放入 try 代码块内,以便捕获潜在的异常。
- 每个try或throw代码块必须至少拥有一个对应的 catch 代码块。
- 使用多个 catch 代码块可以捕获不同种类的异常。
- 可以在try代码内的catch 代码块中再次抛出(re-thrown)异常。
简而言之:如果抛出了异常,就必须捕获它。