README

The Email package provides an integration with PHPMailer for sending emails.

Installation

composer require charcoal/email

For Charcoal projects, the service provider can be registered from your configuration file:

{
 "service_providers": {
 "charcoal/email/service-provider/email": {}
 }
}

Usage

use Charcoal\Email\ServiceProvider\EmailServiceProvider;
use Pimple\Container;

$container = new Container();
$container->register(new EmailServiceProvider());

$email = $container['email'];
$email->setData([
 'from' => '"Company inc." <company.inc@example.com>',
 'bcc' => 'shadow@example.com',
 'to' => [
 'recipient@example.com',
 '"Some guy" <someguy@example.com>',
 [
 'name' => 'Other guy',
 'email' => 'otherguy@example.com',
 ],
 ],
 'reply_to' => [
 'name' => 'Jack CEO',
 'email' => 'jack@example.com'
 ],
 'subject' => $this->translator->trans('Email subject'),
 'campaign' => 'Campaign identifier',
 'template_ident' => 'foo/email/default-email'
 'attachments' => [
 'foo/bar.pdf',
 'foo/baz.pdf',
 ],
]);

// Dispatch immediately:
$email->send();

// Alternately, dispatch at a later date using the queue system:
$email->queue('in 5 minutes');

Email Config

The entire email system can be configured from the main app config, in the email config key.

{
 "email": {
 "smtp": true,
 "smtp_hostname": "smtp.example.com",
 "smtp_port": 25,
 "smtp_security": "tls",
 "smtp_username": "user@example.com",
 "smtp_password": "password",

 "default_from": "webproject@example.com",
 "default_reply_to": "webproject@example.com",
 "default_track": false,
 "default_log": true
 }
}

Service Provider

All email services can be quickly registered to a service container with \Charcoal\Email\ServiceProvider\EmailServiceProvider.

Provided services:

Service	Type	Description
email	Email[1]	An email object (factory).
email/factory	FactoryInterface[2]	An email factory, to create email objects.

Notes:

• ^[1] \Charcoal\Email\Email.
• ^[2] Charcoal\Factory\FactoryInterface.

Also available are the following helpers:

Helper Service	Type	Description
email/config	EmailConfig[3]	Email configuration.
email/view	ViewInterface[4]	The view object to render email templates ($container['view']).

Notes:

• ^[3] \Charcoal\Email\EmailConfig.
• ^[4] \Charcoal\View\ViewInterface.

Resources

• Contributing
• Report issues and send pull requests in the main Charcoal repository