1. 首页
  2. PHP 菜鸟教程
  3. PHP - Try…Catch 处理异常

PHP - Try…Catch 处理异常

在 PHP 中，提供了关键字 try、catch、throw 和 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 块处理 DivisioByZeroError、TypeError、ArgumentCountError 和 InvalidArgumentException 条件。还有一个 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
<< PHP - 错误处理 PHP - 错误调试 >>