Скажем, например, у меня есть класс MailQueue с очередью функций, которая принимает адрес отправителя, тему, тело и массив получателей. Функция проверяет заданные параметры на наличие и действительность адреса электронной почты, а затем пытается вставить сообщение в базу данных, готовую к отправке, когда очередная обработка очереди выполняется. Если какой-либо из параметров функции не проходит проверку, я выбрасываю исключение (скажем, типа InvalidArguementException), а если происходит сбой вставки базы данных, у меня есть специальное исключение базы данных, которое нужно сгенерировать (например, типа DatabaseException).
Объявляю ли я в своем комментарии к PHPDoc, что я выбрасываю оба типа исключений (несколько строк @throws), или я делаю это совершенно неправильно?
Задача ещё не решена.
Других решений пока нет …