异常处理

异常用于在指定的错误发生时改变脚本的正常流程

异常

PHP5提供了一种新的面向对象地错误处理方法

异常处理用于在指定的错误(异常)情况发生时改变脚本地正常流程。这种情况被称为异常

当异常被触发时:

  • 当前代码状态被保存
  • 代码执行被切换到预定义的异常处理器函数
  • 根据情况，处理器也许会从保存的代码状态重新开始执行代码，终止脚本执行，或从代码中另外的位置继续执行脚本

错误处理方法:

  • 异常的基本使用
  • 创建自定义的异常处理器
  • 多个异常
  • 重新抛出异常
  • 设置顶层异常处理器

异常只能用在错误情况下使用，而不应该被用于一个点跳到另一个点的情况

基本使用

当异常被抛出时，其后的代码不会继续执行，PHP会尝试查找匹配的catch代码块

如果异常没有被捕获，而且又没用set_exception_handler()作相应处理的话，那就会发生一个致命错误，并且输出”Uncaught Exception”的错误消息

1
2
3
4
5
6
7
8
9
10
11
12
13
<?php
// 创建一个有异常处理的函数
function checkNum($number)
{
    if($number>1)
    {
        throw new Exception("Value must be 1 or below");
    }
    return true;
}
 
// 触发异常
checkNum(2);

这个例子触发异常但是没去捕获它，就会得到这样的错误

1
2
3
4
5
Fatal error: Uncaught Exception: Value must be 1 or below in F:\default\PHP_default\test1.php:7
Stack trace:
#0 F:\default\PHP_default\test1.php(13): checkNum(2)
#1 {main}
  thrown in F:\default\PHP_default\test1.php on line 7

Try、throw和catch

要避免上面实例中出现的错误，我们需要创建适当的代码来处理异常

适当的处理异常代码应该包括

  • Try 使用异常的函数应该位于”try”代码块内。如果没有触发异常，则代码将照常继续执行。但是如果异常被触发，会抛出一个异常
  • Throw 里规定如何触发异常。每一个”throw”必须对应至少一个”catch”
  • Catch “catch”代码块会捕获异常，并创建一个包含异常信息的对象
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
<?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();
}

运行结果

1
Message: 变量值必须小于等于 1

实例解释

上面的代码解释为

  • 创建checkNum()函数。它检测数字是否大于1。如果是，则抛出一个异常
  • 在”try”代码块中调用checkNum()函数
  • checkNum()函数中的异常被抛出
  • “catch”代码块接收到该异常，并创建一个包含异常信息的对象，通常为$e
  • 通过从这个exception对象调用$e->getMessage()，输出来自该异常的错误信息

创建自定义异常

创建自定义的异常处理程序非常简单。简单创建一个专门的类，当发生异常时，可调用其函数。该类必须为exception类的子类

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
<?php
class customException extends Exception
{
    public function errorMessage()
    {
        // 错误信息
        $errorMsg = '错误行号 '.$this->getLine().' in '.$this->getFile()
            .':'."\n".$this->getMessage().' 不是一个合法的 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类来捕获异常
  • customException()类作为旧的exception类的子类，继承了exception类的所有属性和方法
  • 创建errorMessage()函数。如果e-mail地址不合法，则该函数返回一条错误消息
  • 把$email变量设置为不合法的e-mail地址字符串
  • 执行”try”代码块，由于e-mail地址不合法，因此抛出一个异常
  • “catch”代码块捕获异常，并显示错误消息

多个异常

可以为脚本使用多个异常，来检测多种情况
可以使用多个if…else代码块，或一个switch代码块，或者嵌套多个异常。这些异常能够使用不同的exception类，返回不同的错误信息

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
<?php
class customException extends Exception
{
    public function errorMessage()
    {
        // 错误信息
        $errorMsg = '错误行号 '.$this->getLine().' in '.$this->getFile()
            .':'."\n".$this->getMessage().' 不是一个合法的 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();
}

基本与上个例子一致，不过是使用了判断语句和多个catch来实现了多异常的处理

重新抛出异常

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
<?php
class customException extends Exception
{
    public function errorMessage()
    {
        // 错误信息
        $errorMsg = $this->getMessage().' 不是一个合法的 E-Mail 地址。';
        return $errorMsg;
    }
}

$email = "someone@exampl.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();
}

有时候，当异常被抛出时，希望以不同于标准的方式处理，就可以套娃

与上面例子几乎无异，不解释了

设置顶层异常处理器

set_exception_handler() 函数可设置处理所有未捕获异常的用户定义函数

1
2
3
4
5
6
7
8
9
<?php
function myException($exception)
{
    echo "Exception: " , $exception->getMessage();
}

set_exception_handler('myException');

throw new Exception('Uncaught Exception occurred');

运行结果

1
Exception: Uncaught Exception occurred

上面不存在catch代码块，而是触发顶层的异常处理程序。应该使用此函数来捕获所有未捕获的异常

总结

1.需要进行异常处理的代码必须放入try代码块中，以便捕获潜在的异常

2.每个try或throw代码块必须至少拥有一个对应的catch代码块

3.使用多个catch代码块可以捕获不同种类的异常

4.可以在try代码块内的catch代码块中抛出或再次抛出异常