nette/mail

🐛 Bug Fixes

• Display names are no longer quoted when they don't need to be (#107). Since 4.2.0 any name outside plain ASCII – so every name with diacritics – got wrapped in a quoted-string before MIME encoding, which buried the quotes inside the base64 payload and decoded them as part of the name: Objednávky domena.cz arrived as "Objednávky domena.cz". Quoting is now reserved for characters that could genuinely restructure an address list (, ; : < > @ " \), so Kdo uteče, obědvá keeps its quotes and the DKIM fix from #102 stands, while ordinary accented names go out clean.

• Interceptor – a new mailer wrapper that redirects all outgoing To/Cc/Bcc (plus read-receipt headers) to one fixed address, preserves the originals in X-Original-* headers, and optionally adds a subject prefix. No more sending test mail to real customers by accident. Wire it via DI with mail.redirect: [email protected] and it slots in automatically.
• MailTracy Bar panel – a new Bridges/MailTracy/MailPanel subscribes to Interceptor::$onSent and lists each sent message (From / To+Cc+Bcc / Subject / Status) right in the Tracy Bar. Auto-registers in debug mode whenever the Interceptor is active; opt in or out explicitly with mail: debugger: true|false.
• HtmlComposer – a standalone HTML pre-processing pipeline you can drive directly: opt in to inlineCss() (accumulates stylesheets across calls), embedImages($basePath), and let it handle <title> to subject extraction and plain-text alternative generation. Message::setHtmlBody() keeps working as a BC-friendly facade.

🐛 Bug Fixes

• Message::setHtmlBody() – survives large inline data: URIs. A >500 kB base64 payload used to exhaust PCRE's backtrack limit and abort the whole send; the regex is now backtracking-free (#79)
• Message::setHtmlBody() – embeds images whose quoted src="…" or url('…') contains spaces, like "holiday photos/beach.jpg" (#97)
• Message::setHtmlBody() – embeds images whose quoted path contains parentheses, so the classic screenshot (1).png naming no longer silently breaks (#89)
• SendmailMailer – signs the full message so DKIM now covers Subject and To headers, closing a deliverability gap at Gmail, Outlook, and other strict providers (#99)
• MimePart – quotes address phrases containing special characters before MIME-encoding, producing spec-compliant headers even when names include commas, angle brackets, or quotes (#102)
• CssInliner – gracefully skips selectors the DOM engine can't evaluate; pseudo-classes and pseudo-elements like ::marker, :hover, :checked no longer break inlining
• CssInliner – tokenizer regex fixed for very long strings and invalid url() quote combinations that previously tripped the parser

This release introduces CssInliner – a brand-new component that brings CSS-to-inline-style conversion directly into Nette Mail. The minimum PHP version has been raised to 8.2, and static analysis is now a mandatory part of the build pipeline.

• Minimum PHP version raised from 8.0 to 8.2 – time to upgrade if you haven't already

• Improved PHPDoc types and descriptions for better IDE support and static analysis accuracy

• CssInliner – converts <style> rules into inline style attributes, making your HTML emails render consistently across email clients. Features a single-regex tokenizer, full CSS nesting support, Dom\HTMLDocument selector matching (PHP 8.4+), and automatic Outlook-compatible HTML attribute generation (bgcolor, width, align, etc.). <style> tags are preserved so @media queries keep working.

• support for PHP 8.5
• optimized global function calls
• used attribute Deprecated

• SendmailMailer: the use of -f option in the mail command can be disabled (#98)
• support for PHP 8.4

• SmtpMailer: fixed problem with empty response with slow SMTP server

• support for PHP 8.3
• SendmailMailer: fixed $commandArgs handling after 0e236e4 #93
• SmtpMailer: adds 'To: undisclosed-recipients' header when a mail is with only Bcc recipients (#92)
• used #[\SensitiveParameter] to mark sensitive parameters

• support for PHP 8.3
• SmtpMailer: fixed problem with empty response with slow SMTP server