PHP - Try…Catch 处理异常


在 PHP 中,提供了关键字 trycatchthrow 和 finally 来处理异常。而 Error 是一个意外的程序结果,它不能由程序本身处理,程序必须用 die() 或设置自定义错误处理程序来终止。

另一方面,异常是指一种意外情况,可以以这样一种方式进行处理,即程序在将异常抛出其正常流后可以继续运行。

在 PHP 代码中,可以使用 catch 关键字引发异常并捕获异常。可能容易发生异常的代码块被 try 块包围。每个 try 必须至少有一个对应的 catch finally 块。

Try、Throw、Catch 和 Finally

这四个异常相关的关键词起到的作用如下——

关键词 描述
Try  可能发生某些异常的代码块被放置在 “try” 块中。如果未触发 exception,则代码将继续执行。但是,如果确实发生异常,则会“抛出”。执行停止,PHP 查找匹配的 “catch” 块。如果未捕获到异常,PHP 将发出 Fatal Error。
Throw  这是触发异常的方法。每个 “throw” 必须至少有一个 “catch” 或 “finally” 块。
Catch  检索异常并创建包含异常信息的对象的数据块。多个 catch 块可用于捕获不同的异常。
finally  finally 块中的代码总是在 throw 或 catch 块之后执行。

例子

下面是异常处理技术的示例。该代码在浏览器上呈现两个文本字段,并要求用户输入两个数字以执行除法。如果第二个数字(分母)为 0,则引发异常,程序进入 catch 块并打印异常消息。否则,将显示除法的结果。


<html>
<body>
   <form action="<?php echo $_SERVER['PHP_SELF'];?>" method="post">
      <h3>第一个数字: <input type="text" name="first"/></h3>
      <h3>第二个数字: <input type="text" name="second"/></h3>
      <input type="submit" value="提交" />
   </form>

   <?php
      if ($_SERVER["REQUEST_METHOD"] == "POST") {
         $x = $_POST['first'];
         $y = $_POST['second'];
         echo "第一个数字:$x 第二个数字:$y";
         try {
            if ($y == 0) {
               throw new Exception("不能除以零");
            }
            $z = $x/$y;
            echo "<h3>x = $x y = $y 结果 = $z<br>";
         }
         catch (Exception $e) {
            echo "<h3> 出错: " . $e->getMessage();
         }
      }
   ?>
</body>
</html>

将产生以下输出 -

第一个数字:100 第二个数字:0

出错: 不能除以零

Exception 类

PHP 抛出 Exception 类的对象。PHP Exception 类是用户异常的基础。它实现了 throwable 接口。

此类定义以下方法 -

getMessage()

此函数以字符串形式返回 Exception 消息 -


final public Exception::getMessage(): string

此函数将异常代码返回为 int 中的 Exception -


final public Exception::getCode(): int

请看下面的例子 -


try {
   throw new Exception("一些错误消息", 30);
} 
catch(Exception $e) {
   echo "异常代码为: " . $e->getCode();
}

getFile()

此函数返回创建异常的文件名 -


final public Exception::getFile(): string

请看下面的例子 -


try {
   if ($y == 0) {
      throw new Exception("不能除以零");
   }
   $z = $x/$y;
   echo "<h3>x = $x y = $y 结果 = $z<br>";
}
catch (Exception $e) {
   echo "<h3> 出错状态 : " . $e->getMessage(). ",在 " . $e->getFile();
}

它将产生以下输出 -

出错状态: 不能除以零,在 C:\xampp\htdocs\hello.php

getLine()

此函数返回创建异常的行号 -


final public Exception::getLine(): int

请看下面的例子 -


<?php
   if ($_SERVER["REQUEST_METHOD"] == "POST") {
      $x = $_POST['first'];
      $y = $_POST['second'];
      echo "$x $y";
      try {
         if ($y == 0) {
            throw new Exception("不能除以零");
         }
         $z = $x/$y;
         echo "<h3>x = $x y = $y 结果 = $z<br>";
      }
      catch (Exception $e) {
         echo "<h3> 出错状态: " . $e->getMessage(). ",第 " . $e->getLine() . " 行 " . $e->getFile();
      }
   }
?>

它将产生以下输出 -

出错状态: 不能除以零,第 21 行 C:\xampp\htdocs\hello.php

多个 Catch 块

PHP 允许在 try 块后面有一系列 catch 块来处理不同的异常情况。可以使用多个 catch 块来处理预定义的异常和错误以及用户定义的异常。

以下示例使用 catch 块处理 DivisioByZeroErrorTypeErrorArgumentCountErrorInvalidArgumentException 条件。还有一个 catch 块来处理一般的 Exception


<?php
   declare(strict_types=1);
   function divide(int $a, int $b) : int {
      return $a / $b;
   }
   $a=10;
   $b=0;
   try {
   if (!$b) {
      throw new DivisionByZeroError('不能除以零.');
      if (is_int($a)==FALSE || is_int($b)==FALSE)
      throw new InvalidArgumentException("参数类型无效");
      $result=divide($a, $b);
      echo $result;
   }
   
   // 如果参数类型不匹配
   catch (TypeError $x) {
      echo $x->getMessage();
   }

   // 如果分母为0
   catch (DivisionByZeroError $y) {
      echo $y->getMessage();
   }

   // 如果参数数量不等于2
   catch (ArgumentCountError $z) {
      echo $z->getMessage();
   }

   // 如果参数类型不匹配
   catch (InvalidArgumentException $i) {
      echo $i->getMessage();
   }

   // 任何未捕获的异常
   catch (Exception $ex) {
      echo $ex->getMessage();
   }    
?>

首先,由于分母为 0,因此将显示 “除以 0” 错误 -

Division by 0

设置 $b=3 将导致 TypeError,因为 divide 函数预期返回整数,但 division 会导致 float

divide(): Return value must be of type int, float returned

如果通过更改 $res=divide($a) 只将一个变量传递给 divide 函数;这将导致 ArgumentCountError 

Too few arguments to function divide(), 1 passed in C:\xampp\htdocs\hello.php on line 16 and exactly 2 expected

如果其中一个参数不是整数,则为 InvalidArgumentException。将 $b 更改为字符串 -

参数类型无效

Finally 块

也可以在 catch 块之后或代替 catch 块指定 finally 块。finally 块中的代码将始终在 try 和 catch 块之后执行,无论是否引发了异常,并且在恢复正常执行之前。


try {
   if ($y == 0) {
      throw new Exception("Division by Zero");
   }
   $z = $x/$y;
   echo "<h3>x = $x y = $y Division = $z </h3><br>";
}
catch (Exception $e) {
   echo "<h3> Exception: " . $e->getMessage(). "</h3>";
}
finally {
   echo "<h3>End of try - catch - finally</h3>";
}

它将产生以下输出 -

情况 1 -

x = 10 y = 5 Division = 2
End of try - catch – finally

情况 2 -

X=10 y=0
Exception: Division by Zero
End of try - catch – finally

Finally With Return

当 try 块或 catch 块(或两者)包含 return 语句时,finally 块有一种特殊的行为。通常,return 语句会导致 program 的控制权返回到调用位置。但是,如果函数具有 try/catch 块和 return,则 finally block 的语句在返回之前先执行。

例子

在下面的示例中,div() 函数具有“try-catch-finally”构造。无异常的 try 块返回 division 的结果。如果出现异常,catch 块将返回错误消息。但是,无论哪种情况,都会首先执行 finally 块中的语句。


<?php
   function div($x, $y) {
      try {
         if ($y==0)
         throw new Exception("Division by 0");
         else
         $res=$x/$y;;
         return $res;
      } 
      catch (Exception $e) {
         return $e->getMessage();
      }
      finally {
         echo "This block is always executed\n";
      }
   }
   $x=10;
   $y=0;
   echo div($x,$y);
?>

它将产生以下输出 -

This block is always executed
Division by 0