PHP异常处理
一、什么是异常
异常处理用于在指定的错误（异常）情况发生时改变脚本的正常流程。这种情况称为异常。
当异常被触发时，通常会发生：
- 当前代码状态被保存
- 代码执行被切换到预定义（自定义）的异常处理器函数
- 根据情况，处理器也许会从保存的代码状态重新开始执行代码，终止脚本执行，或从代码中另外的位置继续执行脚本
我们将展示不同的错误处理方法：
- 异常的基本使用
- 创建自定义的异常处理器
- 多个异常
- 重新抛出异常
- 设置顶层异常处理器
注释：异常应该仅仅在错误情况下使用，而不应该用于在一个指定的点跳转到代码的另一个位置。
二、异常的基本使用
当异常被抛出时，其后的代码不会继续执行，PHP 会尝试查找匹配的 "catch" 代码块。
如果异常没有被捕获，而且又没用使用 set_exception_handler() 作相应的处理的话，那么将发生一个严重的错误（致命错误），并且输出 "Uncaught Exception" （未捕获异常）的错误消息。
让我们尝试抛出一个异常，同时不去捕获它：
<?php // 创建一个有异常处理的函数 function checkNum($number) { if($number>1) { throw new Exception("Value must be 1 or below"); } return true; } // 触发异常 checkNum(2); ?>
上面的代码会得到类似这样的一个错误：
Fatal error: Uncaught exception 'Exception' with message 'Value must be 1 or below' in /www/runoob/test/test.php:7 Stack trace: #0 /www/runoob/test/test.php(13): checkNum(2) #1 {main} thrown in /www/runoob/test/test.php on line 7
三、Try、throw 和 catch
要避免上面实例中出现的错误，我们需要创建适当的代码来处理异常。
适当的处理异常代码应该包括：
- Try - 使用异常的函数应该位于 "try" 代码块内。如果没有触发异常，则代码将照常继续执行。但是如果异常被触发，会抛出一个异常。
- Throw - 里规定如何触发异常。每一个 "throw" 必须对应至少一个 "catch"。
- Catch - "catch" 代码块会捕获异常，并创建一个包含异常信息的对象。
让我们触发一个异常：
<?php // 创建一个有异常处理的函数 function checkNum($number) { if($number>1) { throw new Exception("变量值必须小于等于 1"); } return true; } // 在 try 块 触发异常 try { checkNum(2); // 如果抛出异常，以下文本不会输出 echo '如果输出该内容，说明 $number 变量'; } // 捕获异常 catch(Exception $e) { echo 'Message: ' .$e->getMessage(); } ?>
上面代码将得到类似这样一个错误：
Message: 变量值必须小于等于 1
实例解释：
上面的代码抛出了一个异常，并捕获了它：
- 创建 checkNum() 函数。它检测数字是否大于 1。如果是，则抛出一个异常。
- 在 "try" 代码块中调用 checkNum() 函数。
- checkNum() 函数中的异常被抛出。
- "catch" 代码块接收到该异常，并创建一个包含异常信息的对象 ($e)。
- 通过从这个 exception 对象调用 $e->getMessage()，输出来自该异常的错误消息。
然而，为了遵循 "每个 throw 必须对应一个 catch" 的原则，可以设置一个顶层的异常处理器来处理漏掉的错误。
PHP7以上版本实现同时捕获异常和错误：
try{ throw new Exception("xxxsx"); demo(); } catch (Throwable $e){//Throwable是异常与错误类共同接口 //instanceof检测对象是否是某个类的实例 if($e instanceof Exception){ echo "异常"; } if($e instanceof Error){ echo "错误"; } }
四、创建一个自定义的 Exception 类
创建自定义的异常处理程序非常简单。我们简单地创建了一个专门的类，当 PHP 中发生异常时，可调用其函数。该类必须是 exception 类的一个扩展。
这个自定义的 customException 类继承了 PHP 的 exception 类的所有属性，您可向其添加自定义的函数。
我们开始创建 customException 类：
<?php class customException extends Exception { public function errorMessage() { // 错误信息 $errorMsg = '错误行号 '.$this->getLine().' in '.$this->getFile() .': <b>'.$this->getMessage().'</b> 不是一个合法的 E-Mail 地址'; return $errorMsg; } } $email = "someone@example...com"; try { // 检测邮箱 if(filter_var($email, FILTER_VALIDATE_EMAIL) === FALSE) { // 如果是个不合法的邮箱地址，抛出异常 throw new customException($email); } } catch (customException $e) { //display custom message echo $e->errorMessage(); } ?>
这个新的类是旧的 exception 类的副本，外加 errorMessage() 函数。正因为它是旧类的副本，因此它从旧类继承了属性和方法，我们可以使用 exception 类的方法，比如 getLine()、getFile() 和 getMessage()。
实例解释：
上面的代码抛出了一个异常，并通过一个自定义的 exception 类来捕获它：
- customException() 类是作为旧的 exception 类的一个扩展来创建的。这样它就继承了旧的 exception 类的所有属性和方法。
- 创建 errorMessage() 函数。如果 e-mail 地址不合法，则该函数返回一条错误消息。
- 把 $email 变量设置为不合法的 e-mail 地址字符串。
- 执行 "try" 代码块，由于 e-mail 地址不合法，因此抛出一个异常。
- "catch" 代码块捕获异常，并显示错误消息。
事务异常处理实例
<?php //自定义异常类 class myException extends Exception { //创建异常日志 public function createLog() { date_default_timezone_set("PRC"); $date=date("Y/m/d H:i"); $path=getcwd().DIRECTORY_SEPARATOR.'logs'.DIRECTORY_SEPARATOR; if(!file_exists($path)){ mkdir($path,0777,true); } $logsTemp="[%s] 【Exception】 文件：%s有报错，错误出现在第%s行,错误详情：%s".PHP_EOL; $logs=sprintf($logsTemp,$date,$this->getFile(),$this->getLine(),$this->getMessage()); file_put_contents($path."dbException.log",$logs,FILE_APPEND); } } # 事务 ENGINE=INNODB 存储引擎 innodb（支持事务） myisam（不支持） //date_default_timezone_set('PRC'); try{ #捕捉到异常后，会停止执行后面的代码 # 1、连接数据库 $link = @mysqli_connect('localhost','root','root','jkdb'); if(!$link ){ throw new myException("连接数据库失败！",500); } if(!mysqli_set_charset($link,'utf8')){ throw new myException("设置字符集失败！",500); } # 开启事务 mysqli_query($link,'start transaction'); $sql = "update user set money=money-180 where username = '张无忌'"; $result = mysqli_query($link,$sql); if( !$result || mysqli_affected_rows($link) == 0 ){ throw new myException("sql事务语句执行失败！",400); } $sql = "update user set money=money+180 where username = '乔峰'"; $result = mysqli_query($link,$sql); if( !$result || mysqli_affected_rows($link) == 0 ){ throw new myException("sql事务语句执行失败！",400); } $sql = "update equipment set owner=1 where equipment = '汗血宝马' and owner = 2"; $result = mysqli_query($link,$sql); if( !$result || mysqli_affected_rows($link) == 0 ){ throw new myException("sql事务语句执行失败！",400); } mysqli_query($link,'commit'); }catch(myException $e){ $e->createLog(); if($e->getCode()==400){ mysqli_query($link,'rollback'); } } ?>
五、多个异常
可以为一段脚本使用多个异常，来检测多种情况。
可以使用多个 if..else 代码块，或一个 switch 代码块，或者嵌套多个异常。这些异常能够使用不同的 exception 类，并返回不同的错误消息：
<?php class customException extends Exception { public function errorMessage() { // 错误信息 $errorMsg = '错误行号 '.$this->getLine().' in '.$this->getFile() .': <b>'.$this->getMessage().'</b> 不是一个合法的 E-Mail 地址'; return $errorMsg; } } $email = "someone@example.com"; try { // 检测邮箱 if(filter_var($email, FILTER_VALIDATE_EMAIL) === FALSE) { // 如果是个不合法的邮箱地址，抛出异常 throw new customException($email); } // 检测 "example" 是否在邮箱地址中 if(strpos($email, "example") !== FALSE) { //不同类处理 throw new Exception("$email 是 example 邮箱"); } } catch (customException $e) { echo $e->errorMessage(); } catch(Exception $e) { echo $e->getMessage(); } ?>
实例解释：
上面的代码测试了两种条件，如果其中任何一个条件不成立，则抛出一个异常：
- customException() 类是作为旧的 exception 类的一个扩展来创建的。这样它就继承了旧的 exception 类的所有属性和方法。
- 创建 errorMessage() 函数。如果 e-mail 地址不合法，则该函数返回一个错误消息。
- 把 $email 变量设置为一个字符串，该字符串是一个有效的 e-mail 地址，但包含字符串 "example"。
- 执行 "try" 代码块，在第一个条件下，不会抛出异常。
- 由于 e-mail 含有字符串 "example"，第二个条件会触发异常。
- "catch" 代码块会捕获异常，并显示恰当的错误消息。
如果 customException 类抛出了异常，但没有捕获 customException，仅仅捕获了 base exception，则在那里处理异常。
六、重新抛出异常
有时，当异常被抛出时，您也许希望以不同于标准的方式对它进行处理。可以在一个 "catch" 代码块中再次抛出异常。
脚本应该对用户隐藏系统错误。对程序员来说，系统错误也许很重要，但是用户对它们并不感兴趣。为了让用户更容易使用，您可以再次抛出带有对用户比较友好的消息的异常：
<?php class customException extends Exception { public function errorMessage() { // 错误信息 $errorMsg = $this->getMessage().' 不是一个合法的 E-Mail 地址。'; return $errorMsg; } } $email = "someone@example.com"; try { try { // 检测 "example" 是否在邮箱地址中 if(strpos($email, "example") !== FALSE) { // 如果是个不合法的邮箱地址，抛出异常 throw new Exception($email); } } catch(Exception $e) { // 重新抛出异常 throw new customException($email); } } catch (customException $e) { // 显示自定义信息 echo $e->errorMessage(); } ?>
实例解释：
上面的代码检测在邮件地址中是否含有字符串 "example"。如果有，则再次抛出异常：
- customException() 类是作为旧的 exception 类的一个扩展来创建的。这样它就继承了旧的 exception 类的所有属性和方法。
- 创建 errorMessage() 函数。如果 e-mail 地址不合法，则该函数返回一个错误消息。
- 把 $email 变量设置为一个字符串，该字符串是一个有效的 e-mail 地址，但包含字符串 "example"。
- "try" 代码块包含另一个 "try" 代码块，这样就可以再次抛出异常。
- 由于 e-mail 包含字符串 "example"，因此触发异常。
- "catch" 代码块捕获到该异常，并重新抛出 "customException"。
- 捕获到 "customException"，并显示一条错误消息。
如果在当前的 "try" 代码块中异常没有被捕获，则它将在更高层级上查找 catch 代码块。
七、设置顶层异常处理器
set_exception_handler() 函数可设置处理所有未捕获异常的用户定义函数。
<?php function myException($exception) { echo "<b>Exception:</b> " , $exception->getMessage(); } set_exception_handler('myException'); throw new Exception('Uncaught Exception occurred'); ?>
以上代码的输出如下所示：
Exception: Uncaught Exception occurred
在上面的代码中，不存在 "catch" 代码块，而是触发顶层的异常处理程序。应该使用此函数来捕获所有未被捕获的异常。
使用匿名函数：
set_exception_handler(function (MyException $e){ $e->toJson();//调用自定义异常类的方法 });
八、异常的规则
- 需要进行异常处理的代码应该放入 try 代码块内，以便捕获潜在的异常。
- 每个 try 或 throw 代码块必须至少拥有一个对应的 catch 代码块。
- 使用多个 catch 代码块可以捕获不同种类的异常。
- 可以在 try 代码块内的 catch 代码块中抛出（再次抛出）异常。
简而言之：如果抛出了异常，就必须捕获它。
实例
【ajax请求id为1的订单信息】
- 1、请求id不能为空 返回：{"errcode":400,"msg":"上传的id不能为空"}
- 2、请求id必须为正整型 返回：{"errcode":400,"msg":"上传的id必须为整型"}
- 3、没有找到id为1对应的订单记录 返回：{"errcode":404,"msg":"没有对应的记录"}
- 4、内部报错 notice、warning 返回：{"errcode":500,"msg":"没有对应的记录"}
- 5、正常 返回：{"errcode":0,"data"：{'orderno'：'nb123'}}
表单代码
<form>
订单号：<input type="text" name="orderNum">
<input type="button" id="btn" value="查询">
</form>
ajax代码
$(function(){ $("#btn").on("click",function(){ $.ajax({ type : "POST", url : "queryDb.php", data : $("form").serialize(), dataType : "json", success:function(res){ console.log(res); if(res.errcode!=0){ $(".massage").html("<p style='color:red'>"+res.msg+"</p>"); }else{ $(".massage").html("<p>订单信息如下：<br/>"+res.data.orderno+"</p>"); } } }); }); });
php代码
class myException extends Exception { //输出json数据 public function toJson() { header("Content-Type:application/json;charset=utf8;"); exit(json_encode(["errcode" => $this->getCode(), "msg" => $this->getMessage()])); } } //设置错误处理函数 set_error_handler(function ($errno, $errstr, $errfile, $errline) { if (in_array($errno, [E_ERROR, E_WARNING])) { exit(json_encode(["errcode" => 500, "msg" => "服务器内部错误!"])); } }); //设置异常处理函数 set_exception_handler(function (myException $e) { $e->toJson(); }); //判断是否是ajax请求 if (!isset($_SERVER['HTTP_X_REQUESTED_WITH']) || $_SERVER['HTTP_X_REQUESTED_WITH'] != 'XMLHttpRequest') { exit('不是用ajax提交的数据！'); } //验证输入数据 $id = $_POST["orderNum"]; if (!isset($id) || empty($id)) { throw new myException("上传的id不能为空！", 400); } if (!preg_match("/^\d+$/", $id)) { throw new myException("上传的id必须为整型!", 400); } //连接数据库 $link = mysqli_connect("localhost", "root", "root", "order"); if (!$link) { throw new myException("没有对应的记录！", 500); } if (!mysqli_set_charset($link, "utf8")) { throw new myException("没有对应的记录！", 500); } $sql = "select * from orderTable where id=$id"; $res = mysqli_query($link, $sql); if (!$res) { throw new myException("没有对应的记录！", 500); } $row = mysqli_fetch_assoc($res); if (empty($row)) { throw new myException("没有对应的记录！", 404); } //没有错误，返回数据 echo json_encode(["errcode" => 0, "data" => ["orderno" => $row["name"]]]);
浙公网安备 33010602011771号