genkgo/mail

Library to send e-mails over different transports and protocols (like SMTP and IMAP) using immutable messages and streams. Also includes SMTP server.

Monday, June 4, 2018
by frederikbosch
Repository
21 Watchers
372 Stars
4,767 Installations

PHP
1 Dependents
0 Suggesters
18 Forks
4 Open issues
31 Versions
22 % Grown

The README.md

Genkgo/Mail - Modern PHP Mail Library

, _(*1)

While analyzing what mail library to use when refactoring a code base, we discovered that the available ones are mostly legacy libraries. Some do not use namespaces and every library we encountered was merely a collection of scalar property bags than objects using encapsulation. Although we used these libs with joy in the past, they do not meet current quality standards. So, we built a new and better library according to modern programming principles., _(*2)

Use this if you want to send e-mails over different transports and protocols using immutable messages and streams., _(*3)

Send message quick and easy


use Genkgo\Mail;

$message = (new Mail\MessageBodyCollection('<html><body>

Hello World, _(*4)

</body></html>'))
    ->withAttachment(new Mail\Mime\FileAttachment('/order1.pdf', new Mail\Header\ContentType('application/pdf')))
    ->createMessage()
    ->withHeader(new Mail\Header\Subject('Hello World'))
    ->withHeader(Mail\Header\From::fromEmailAddress('from@example.com'))
    ->withHeader(Mail\Header\To::fromSingleRecipient('to@example.com', 'name'))
    ->withHeader(Mail\Header\Cc::fromSingleRecipient('cc@example.com', 'name'));

$transport = new Mail\Transport\SmtpTransport(
    Mail\Protocol\Smtp\ClientFactory::fromString('smtp://user:pass@host/')->newClient(),
    Mail\Transport\EnvelopeFactory::useExtractedHeader()
);

$transport->send($message);

Install using composer

$ composer require genkgo/mail

Features

Use SMTP or mail() to send messages
Use IMAPv4 to read messages from your mailbox (no extension required)
Create replies and forward messages, including quoting of original message
Queue messages when transport fails
Automatically connects and reconnects after interval to SMTP server
Automatically generate alternative text for formatted messages
Optimal encoded headers, so no excessive (Q/B) encoded headers
Optimal encoded multipart messages
Only streams and connections are mutable
Messages and actors are immutable
Value objects protect against invalid states
Streams make sure the library has a low memory burden
Many objects but still easy API
90%+ test coverage
Uses highest PHPStan detection level
Only uses TLS < 1.2 if not otherwise possible
Discourages SSL
DKIM signed message
Security is highly prioritized
SMTP server for testing purposes
Great RFC compliance
Cast messages to valid string source
Library has no external dependencies (but uses intl extension)
Only supports PHP versions that are not EOL

Upcoming features

Encrypted and signed messages

Not planned

The following features are not planned for development by the owners, but could become part of the library when initiative is taken by the community., _(*5)

POP Support
Mailbox abstraction layer

Documentation

RFC-compliance

This library tends to be as compliant with e-mail RFCs as possible. It should be compliant with the following RFCs., _(*6)

Credits

This library was not able to exist without Zend/Mail and PHPMailer., _(*7)

The Versions

04/06 2018

dev-master

9999999-dev

Library to send e-mails over different transports and protocols (like SMTP and IMAP) using immutable messages and streams. Also includes SMTP server.

library mail

Library to send e-mails over different transports and protocols (like SMTP and IMAP) using immutable messages and streams. Also includes SMTP server.

genkgo/mail

The README.md

Genkgo/Mail - Modern PHP Mail Library

Send message quick and easy

Install using composer

Features

Upcoming features

Not planned

Documentation

RFC-compliance

Credits

The Versions

dev-master

The Requires

The Development Requires

by Frederik Bosch

by frederik

2.5.1

The Requires

The Development Requires

by Frederik Bosch

2.5.0

The Requires

The Development Requires

by Frederik Bosch

dev-reply

The Requires

The Development Requires

by Frederik Bosch

2.4.0

The Requires

The Development Requires

by Frederik Bosch

2.3.0

The Requires

The Development Requires

by Frederik Bosch

dev-imap-client

The Requires

The Development Requires

by frederik

dev-fix-server-client-closing-connection

The Requires

The Development Requires

by frederik

2.2.0

The Requires

The Development Requires

by frederik

2.1.7

The Requires

The Development Requires

by frederik

2.1.6

The Requires

The Development Requires

by frederik

2.1.5

The Requires

The Development Requires

by frederik

2.1.4

The Requires

The Development Requires

by frederik

2.1.3

The Requires

The Development Requires

by frederik

2.1.2

The Requires

The Development Requires

by frederik

2.1.1

The Requires

The Development Requires

by frederik

dev-fix_quoted_comma_address_name