在PHP上使用DocBlocks时，当我不使用execpetion处理错误时，是否应该使用@抛出？

Question

我有一个处理错误的类，它没有使用try-throw-catch机制。

当我注释使用该类的代码时，我是否应该使用@throws标记，即使我实际上没有抛出任何东西？

编辑(试图使我的问题更清楚)：

我的问题是，@throws标记是否意味着在使用代码时可能发生错误，而我正在以某种方式处理它，还是意味着错误可能发生，而我正在具体地使用throw关键字来处理它？

Answer 1

在阅读了文献资料之后，我意识到这一点并没有得到准确的阐述。

关于@throws的文档表明，如果代码块中存在throw关键字，那么无论您是否正在处理它，都应该记录可能引发的每种类型的异常。

所以如果你有

try {
    throw new Exception();
} catch (Exception $e) {
    // handled!
}

在docblock中放置一个@throws条目。

Answer 2

将注释@抛出将此方法标记为不安全。客户端应该准备好在调用此方法时处理此异常。