php - 在 PHP 上使用 DocBlocks，当我不处理执行错误时，我应该使用 @throws 吗？

Question

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

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

编辑（尽量让我的问题更清楚）：

我的问题是@throws标签是否意味着在使用代码时可能发生错误并且我正在以某种方式处理它，或者这意味着可能发生错误并且我正在通过throw专门使用关键字来处理它？

Answer 1

阅读文档后，我意识到这并没有完全说明。

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

所以如果你有

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

在文档块中添加一个@throws条目。

Answer 2

放置注释 @throws 将此方法标记为不安全。调用此方法时，客户端应准备好处理此异常。