комментарии — Используя DocBlocks на PHP, я должен использовать @throws, когда я не обрабатываю ошибки с выполнением?

Question

комментарии — Используя DocBlocks на PHP, я должен использовать @throws, когда я не обрабатываю ошибки с выполнением?

У меня есть класс для обработки ошибок, и он не использует try-throw-catch механизм.

Когда я комментирую код, который использует этот класс, я должен использовать @throws тег, хотя я на самом деле ничего не бросал?

РЕДАКТИРОВАТЬ (попробуйте уточнить мой вопрос):

Мой вопрос, если @throws теги означают, что при использовании кода может возникнуть ошибка, и я обрабатываю ее каким-либо образом, или это означает, что может произойти ошибка, и я обрабатываю ее, используя throw ключевое слово конкретно?

0

comments docblocks php

Решение

Другие решения

Помещение аннотации @throws помечает этот метод как небезопасный. Клиент должен быть готов обработать это исключение при вызове этого метода.

1

Источник

Accepted Answer

После прочтения документация, Я понимаю, что это точно не прописано.

Документация по @throws предполагает, что если throw Ключевое слово присутствует вообще внутри блока кода, тогда оно должно быть задокументировано для каждого типа исключения, которое может быть выдано, независимо от того, обрабатываете ли вы его или нет.

Так что если у вас есть

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

положить @throws запись в докблоке.

2