传播异常的异常注释

Question

假设我有一个a抛出异常的函数$e.因此,根据phpdoc我应该有一个@throws关于定义的注释a.

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

function b() {
   a();
}

@throw在b指示b可能抛出这种异常的定义上有一个注释是好的做法/坏习惯/正确/错误吗？

Answer 1

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