悍魔之战·网游指挥部

PHP: 异常

异常

目录扩展(extend)异常处理类

PHP 有一个和其他语言相似的异常模型。在 PHP 里可以 throw 并捕获(catch)异常。为了捕获潜在的异常,代码会包含在

try 块里。每个 try 都必须至少有一个相应的 catch 或 finally 块。

如果抛出异常的函数作用域内没有 catch 块,异常会沿调用栈“向上冒泡”,直到找到匹配的 catch 块。沿途会执行所有遇到的

finally 块。在没有设置全局异常处理程序时,如果调用栈向上都没有遇到匹配的 catch,程序会抛出 fatal 错误并终止。

抛出的对象必须是 instanceof Throwable。尝试抛出其他对象会导致 PHP Fatal 错误。

PHP 8.0.0 起,throw 关键词现在开始是表达式,可用于任何表达式上下文。在此之前,它是语句,必须独占一行。

catch

catch 定义了处理抛出异常的方式。

catch 块定义了它能处理的异常/错误的类型,并可以选择将异常赋值到变量中。

(在 PHP 8.0.0 之前的版本中必须要赋值到变量)

如果遇到抛出对象的类型匹配了首个 catch 块的异常或错误,将会处理该对象。

可用多个 catch 捕获不同的异常类。

正常情况下(try 代码块里没有抛出异常)会在最后一个定义的 catch 后面继续执行。

catch 代码块里也可以 throw 或者重新抛出异常。

不抛出的话,会在触发的 catch 后面继续执行。

当 PHP 抛出一个异常时,将不会执行后续的代码语句,并会尝试查找首个匹配的 catch 代码块。

如果没有用 set_exception_handler() 设置异常处理函数,

PHP 会在异常未被捕获时产生 Fatal 级错误,提示 "Uncaught Exception ..."

消息。

从 PHP 7.1.0 起 catch 可以用竖线符(|) 指定多个异常。

如果在不同的类层次结构中,不同异常的异常需要用同样的方式处理,就特别适用这种方式。

从 PHP 8.0.0 起,捕获的异常不再强制要求指定变量名。

catch 代码块会在未指定时继续执行,只是无法访问到抛出的对象。

finally

finally 代码块可以放在 catch 之后,或者直接代替它。

无论是否抛出了异常,在 try 和 catch 之后、在执行后续代码之前,

放在 finally 里的代码总是会执行。

值得注意的是 finally 和 return 语句之间存在相互影响。

如果在 try 或 catch 里遇到 return,仍然会执行 finally 里的代码。

而且,遇到 return 语句时,会先执行 finally 再返回结果。

此外,如果 finally 里也包含了 return 语句,将返回 finally 里的值。

另一个值得注意的交互是发生在 try 块内抛出的异常与 finally

块内抛出的异常之间。如果两个块都抛出异常,则会传播来自 finally

块的异常,而来自 try 块的异常将作为其前一个异常。

全局异常处理程序

当允许异常冒泡到全局作用域时,它可以被全局异常处理器捕获到。

set_exception_handler()

可以设置一个函数,在没有调用其他块时代替 catch。

在本质上,实现的效果等同于整个程序被 try-catch 包裹起来,

而该函数就是 catch。

注释

注意:

PHP 内部函数主要使用 错误报告,

只有一些现代 面向对象 的扩展使用异常。

不过,错误很容易用 ErrorException

转化成异常。

然而,这个技术方案仅适用非 Fatal 级的错误。

示例 #1 将错误报告转成异常

function exceptions_error_handler($severity, $message, $filename, $lineno) {

throw new ErrorException($message, 0, $severity, $filename, $lineno);

}

set_error_handler('exceptions_error_handler');

?>

小技巧

PHP 标准库(SPL)

提供了大量的 标准内置异常。

示例

示例 #2 抛出一个异常

function inverse($x) {

if (!$x) {

throw new Exception('Division by zero.');

}

return 1/$x;

}

try {

echo inverse(5) . "\n";

echo inverse(0) . "\n";

} catch (Exception $e) {

echo 'Caught exception: ', $e->getMessage(), "\n";

}

// 继续执行

echo "Hello World\n";

?>

以上示例会输出:

0.2

Caught exception: Division by zero.

Hello World

示例 #3 带 finally 块的异常处理

function inverse($x) {

if (!$x) {

throw new Exception('Division by zero.');

}

return 1/$x;

}

try {

echo inverse(5) . "\n";

} catch (Exception $e) {

echo 'Caught exception: ', $e->getMessage(), "\n";

} finally {

echo "First finally.\n";

}

try {

echo inverse(0) . "\n";

} catch (Exception $e) {

echo 'Caught exception: ', $e->getMessage(), "\n";

} finally {

echo "Second finally.\n";

}

// 继续执行

echo "Hello World\n";

?>

以上示例会输出:

0.2

First finally.

Caught exception: Division by zero.

Second finally.

Hello World

示例 #4 finally 和 return 相互之间的影响

function test() {

try {

throw new Exception('foo');

} catch (Exception $e) {

return 'catch';

} finally {

return 'finally';

}

}

echo test();

?>

以上示例会输出:

finally

示例 #5 异常嵌套

class MyException extends Exception { }

class Test {

public function testing() {

try {

try {

throw new MyException('foo!');

} catch (MyException $e) {

// 重新 throw

throw $e;

}

} catch (Exception $e) {

var_dump($e->getMessage());

}

}

}

$foo = new Test;

$foo->testing();

?>

以上示例会输出:

string(4) "foo!"

示例 #6 多个异常的捕获处理

class MyException extends Exception { }

class MyOtherException extends Exception { }

class Test {

public function testing() {

try {

throw new MyException();

} catch (MyException | MyOtherException $e) {

var_dump(get_class($e));

}

}

}

$foo = new Test;

$foo->testing();

?>

以上示例会输出:

string(11) "MyException"

示例 #7 忽略捕获的变量

仅仅在 PHP 8.0.0 及以上版本有效

function test() {

throw new SpecificException('Oopsie');

}

try {

test();

} catch (SpecificException) {

print "A SpecificException was thrown, but we don't care about the details.";

}

?>

以上示例会输出:

A SpecificException was thrown, but we don't care about the details.

示例 #8 以表达式的形式抛出

仅仅在 PHP 8.0.0 及以上版本有效

class SpecificException extends Exception {}

function test() {

do_something_risky() or throw new Exception('It did not work');

}

function do_something_risky() {

return false; // 模拟失败

}

try {

test();

} catch (Exception $e) {

print $e->getMessage();

}

?>

以上示例会输出:

It did not work

示例 #9 try 和 finally 中的异常

try {

try {

throw new Exception(message: 'Third', previous: new Exception('Fourth'));

} finally {

throw new Exception(message: 'First', previous: new Exception('Second'));

}

} catch (Exception $e) {

var_dump(

$e->getMessage(),

$e->getPrevious()->getMessage(),

$e->getPrevious()->getPrevious()->getMessage(),

$e->getPrevious()->getPrevious()->getPrevious()->getMessage(),

);

}

以上示例会输出:

string(5) "First"

string(6) "Second"

string(5) "Third"

string(6) "Fourth"

Copyright © 2022 悍魔之战·网游指挥部 All Rights Reserved.