php - 传播异常的异常注释

Question

假设我有一个函数a 抛出异常$e。因此，根据 phpdoc，我应该在 a 的定义上添加注释 @throws。

当我有另一个函数 b 调用 a

function b() {
   a();
}

在 b 的定义上添加一个 @throw 注释表明 b 可以抛出那种异常？

Answer 1

@throws 注释是为开发人员指示 function() 是否可以抛出异常
首先，您必须问一个问题:为什么不在b() 方法中捕获异常，是否有正当理由？
是吗？ 所以你必须添加 @throws 注释，它会告诉你，或者其他开发者使用 function() b() 是不安全的他们会决定是否愿意捕获或传播异常
此外，由于PHP 不会强制您捕获另一个函数抛出的异常，因此@throws 注释成为必须/强制实践