mj-zana / communication

v2.1.0 2026-10-25 20:38 UTC

Requires

• php: ^8.5
• mj-zana/core: ^2.1
• symfony/mailer: ^7.4 || ^8.0

Requires (Dev)

• phpstan/phpstan: ^2.1
• phpunit/phpunit: ^11.5

MIT

• mail
• mailer
• email
• smtp
• zana

Published on Packagist.org on 2026-10-25 21:19 UTC

README

Email for Zana applications: immutable messages, a configured sender, Symfony Mailer transports, and a recorder for tests.

composer require mj-zana/communication

Setup

Register CommunicationServiceProvider and configure the sender:

// config/mail.php
return [
    'dsn' => 'smtp://user:[e-mail]:587',   // memory:// records instead (the default)
    'from' => ['address' => '[e-mail]', 'name' => 'Example'],
    'reply_to' => '[e-mail]',               // optional default Reply-To
];

Keep the DSN secret: set it from the environment, e.g. APP_MAIL__DSN=smtp://....

Sending

$mailer->send(Message::create()
    ->to('[e-mail]')
    ->replyTo($visitor->email)
    ->subject('New message from the website')
    ->text($body));

Rules

• From comes from configuration. A message without from() gets mail.from. Any other From must be listed in mail.allowed_from. A visitor's address goes in Reply-To, never in From: this keeps SPF and DMARC aligned and prevents spoofing.
• Required: a recipient, a subject, and a text or HTML body.
• No header injection: line breaks in subjects, header values and names are refused.
• Transport failures become MailException.

Testing

With mail.dsn: memory://, the mailer is a MailRecorder, which applies the same rules:

$recorder = $container->get(MailRecorder::class);
$this->assertCount(1, $recorder->sent(fn (Message $m): bool => $m->subject === 'Welcome'));

mj-zana/testing adds assertMailSent() and assertNoMailSent().

License

MIT