Ловля ошибок при отправке почты с сайта

Добрый день, сообщество!

Как многим известно, у объекта modUser есть замечательный метод modUser::sendEmail, который позволяет отправлять пользователю письмо буквально в одну строчку. Не надо вручную инициировать службу modPHPMailer, выяснять email пользователя — всё это уже сделали за Вас разработчики MODX в этом методе.

Но есть один недостаток — метод возвращает только булево значение. Отправилось успешно — true, не отправилось — false. Причин, по которым письмо не отправилось, метод не даёт. Столкнулся с проблемой, что письма перестали уходить. Причины неясны, в логи их никто не пишет — ни метод sendEmail, ни класс modPHPMailer.

Покопавшись в исходниках, нашел решение. Возможно, оно будет кому-то полезным:

if(!$user->sendEmail($message, $options)){
	$modx->log(modX::LOG_LEVEL_ERROR, 'Не удалось отправить сообщение пользователю '.$user->get('username').'. Причина: '.$user->xpdo->mail->mailer->ErrorInfo);
}

В логах у вас появится подробное описание ошибки, вплоть до ответа SMTP-сервера.

P.S. Не претендую на «великое открытие», очевидно, многие знали об этом способе и без меня. Но возможно кому-то эта заметка поможет сэкономить несколько минут:))