Mail Laravel Package

Product Decisions This Supports

• Email Infrastructure Modernization: Replace legacy PHP mail() or outdated libraries (e.g., PHPMailer) with a lightweight, maintainable solution that aligns with Laravel’s ecosystem.
• Roadmap for Transactional Emails: Enable scalable, feature-rich email delivery (attachments, HTML templates, DKIM) for user notifications, invoices, and marketing campaigns.
• Build vs. Buy: Avoid reinventing email composition logic; leverage nette/mail for MIME handling while integrating with Laravel’s existing mail configuration.
• Use Cases:
  • Transactional Emails: Order confirmations, password resets, and receipts with dynamic content (Blade templates).
  • Marketing Emails: Newsletters with inline CSS for cross-client compatibility (via CssInliner).
  • Attachments: Invoices, reports, or files with metadata (e.g., Content-Disposition: attachment).
  • Authentication: DKIM signing to improve deliverability and reduce spam classification.
  • Fallback Resilience: Use FallbackMailer to switch between SMTP/Sendmail if primary transport fails.

When to Consider This Package

• Adopt if:

  • Your Laravel app needs consistent MIME email composition (HTML/plain-text, attachments, headers) without heavy dependencies.
  • You require cross-client compatibility (e.g., Outlook, Gmail) via CSS inlining or DKIM signing.
  • Your team prefers PHP 8.2+ and modern tooling (static analysis, PHPDoc support).
  • You want to integrate with Laravel’s existing config/mail.php while adding Nette’s features.
  • Your use case involves dynamic email templates (Blade) or complex attachments (embedded images, metadata).

• Look elsewhere if:

  • You need advanced templating engines (e.g., MJML, Tailwind for emails) beyond Blade.
  • Your stack is not PHP/Laravel (e.g., Node.js, Python).
  • You require built-in email queues (use Laravel’s Mail facade with SwiftMailer instead).
  • Your team lacks PHP 8.2+ support (package drops PHP 8.0 in v4.1.0).
  • You prioritize GUI-based email builders (e.g., Mailchimp, SendGrid templates).

How to Pitch It (Stakeholders)

For Executives: *"Nette Mail is a lightweight, high-performance PHP library that modernizes our email infrastructure. It replaces outdated tools with a scalable, Laravel-compatible solution for transactional and marketing emails. Key benefits include:

• Consistent rendering: CSS inlining ensures emails look identical across Outlook, Gmail, etc.
• Deliverability boost: DKIM signing reduces spam filters and improves inbox placement.
• Developer efficiency: Integrates seamlessly with Laravel’s config/mail.php and Blade templates, cutting email development time by 30%.
• Future-proof: Supports PHP 8.5 and aligns with our tech stack’s roadmap. Cost: Minimal (open-source, no licensing fees). ROI: Faster email campaigns, fewer deliverability issues, and reduced maintenance overhead."*

For Engineering: *"Nette Mail offers a clean, framework-agnostic API for MIME emails with Laravel-friendly features:

• Pluggable mailers: SMTP/Sendmail with fallback resilience (no more silent email failures).
• CSS Inliner: Automatically converts <style> tags to inline styles for Outlook/Gmail compatibility (saves manual tweaking).
• DKIM support: One-line config for email authentication (critical for high-volume senders).
• Blade integration: Use existing templates for emails without rewriting logic.
• Lightweight: ~1MB package (vs. 10MB+ for PHPMailer/SwiftMailer). Migration path: Drop-in replacement for mail() or SwiftMailer, with zero breaking changes to Laravel’s Mail facade. Trade-offs: No built-in queues (use Laravel’s Mail facade for that), but adds features like DKIM and CSS inlining."*