Имя получателя и его email — разные части mailbox. Ошибка появляется, когда приложение склеивает их само: `"` внутри display name преждевременно закрывает quoted string, запятая выглядит как второй адрес, а перевод строки способен создать новый header. Оставьте адрес и имя отдельными значениями и передайте их MIME-библиотеке.
Сначала воспроизведите сообщение в email catcher или через null/file transport. Посмотрите сериализованный `To`, исключение парсера и точку отказа. Если библиотека не смогла построить письмо, SMTP здесь ни при чём; если transport принял сообщение, дальнейшая доставка исследуется уже по message ID провайдера.
Один символ даёт разные классы ошибки
| Входное имя | Риск ручной сборки | Ожидаемое поведение библиотеки |
|---|---|---|
| Анна «Север» | не-ASCII без нужного encoding | закодировать display name по MIME |
| Anna "North" | кавычка закрывает quoted string | экранировать внутри синтаксиса header |
| Smith, John | запятая разделяет address list | представить как единый display name |
| O'Connor | конфликт с кавычкой языка шаблона | передать обычной строкой объекту |
| Name + CR/LF | header injection | отклонить вход до сериализации |
RFC 5322 задаёт `name-addr` как необязательный display-name и addr-spec в угловых скобках. Символы вне atom допускаются через quoted-string, где quote и обратный слеш требуют quoted-pair. Это работа сериализатора, а не шаблона письма.
Конкатенация переносит синтаксис протокола в пользовательские данные
Ручная сборка строки из display name, угловых скобок и email смешивает данные с грамматикой заголовка. Даже корректное HTML-экранирование не решает проблему: email header не является HTML. Функция `addslashes` тоже предназначена не для RFC 5322 и может создать другой неверный результат.
use Symfony\Component\Mime\Address;
// Хорошо: библиотека сериализует display name и addr-spec
$recipient = new Address($email, $displayName);
$message->to($recipient);
// Плохо: пользовательские данные становятся частью header grammar
$message->to(chr(34) . $displayName . chr(34) . ' <' . $email . '>');- Email валидировать отдельно от имени и не «чинить» удалением символов.
- Display name ограничить по длине и запретить CR/LF/NUL.
- Использовать текущую поддерживаемую версию mail/MIME-компонента.
- Не логировать полный адрес, тело письма или SMTP credentials.
Не-ASCII кодирует библиотека, а не шаблон
Русские, армянские и другие символы в display name требуют корректного представления в Internet Message Format. Современный MIME-компонент выбирает нужное кодирование и складывание длинной строки заголовка. Ручное добавление `=?UTF-8?...?=` поверх уже кодирующей библиотеки приводит к двойному encoding и нечитаемому имени.
Symfony Mailer принимает `Address(email, name)` и отдельно документирует строковый формат `Name <email@example.com>`. Для данных из профиля безопаснее object API: граница между полями не зависит от содержимого имени. Аналогичный тип ищите в используемом SDK, а не переносите пример дословно в другой стек.
CR/LF не является ещё одним вариантом кавычки
Переводы строк в поле имени — сигнал атаки или повреждённого импорта. Если такое значение попадёт в raw header, злоумышленник может попытаться добавить `Bcc`, изменить тему или разбить сообщение. Эти символы отклоняют до очереди отправки; их нельзя просто заменить пробелом без audit event, потому что факт опасного ввода потеряется.
- Проверить тип, длину и отсутствие управляющих символов.
- Создать Address через library API.
- Сериализовать сообщение в тестовый transport.
- Распарсить полученный header тем же независимым тестом.
- Только затем передавать message асинхронному worker.
Набор имён становится регрессионным тестом
Добавьте обычное имя, двойную кавычку, обратный слеш, запятую, апостроф, кириллицу, emoji, максимальную длину и CR/LF. Корректные варианты создают ровно один mailbox с неизменным addr-spec; управляющие символы дают явную validation error. Проверяйте и синхронный путь, и сериализацию очереди — объект не должен превратиться обратно в опасную строку.
Готовое исправление не удаляет реальные символы из имени и не зависит от SMTP-провайдера. В отчёт по сбою входят шаблон события, версия mail-библиотеки, класс исключения и обезличенный набор Unicode code points проблемного имени. Полный email и готовый `.eml` с персональными данными передают только по защищённому процессу.