Send transactional mail through mandrill.com. This bundle provides an easy api for Symfony2 Projects.
All settings inside message class represent attributes of Mandrill's API. Please refer to their API documentation for Details:
https://mandrillapp.com/api/docs/messages.html
Before you're able to use this bundle you must sign up with Mandrill.
Mandrill is a great way to send your transactional emails and provides detailed advances reports.
Mandrill is free for limited number of email per day, please read through pricing section on the website for more information:
via composer:
composer require slot/mandrill-bundle
Enable the bundle in the kernel
<?php
// app/AppKernel.php
public function registerBundles()
{
$bundles = array(
// ...
new Slot\MandrillBundle\SlotMandrillBundle(),
);
}
Add configuration to config.yml.
Log in to Mandrill and go to "Settings" -> "SMTP and API Credentials". Create an API Key and use it in your Symfony2 Configuration.
# config.yml
slot_mandrill:
api_key: xxxxx
disable_delivery: true # useful for dev/test environment. Default value is 'false'
# debug: passed to \Mandrill causing it to output curl requests. Useful to see output
# from CLI script. Default value is 'false'
debug: true
default:
sender: [email protected]
sender_name: John Doe # Optionally define a sender name (from name)
subaccount: Project # Optionally define a subaccount to use
proxy:
use: true # when you are behing a proxy. Default value is 'false'
host: example.com
port: 80
user: john
password: doe123
Now you're all set, send your first transactional mails:
Simple controller Example:
<?php
// src/Slot/ExampleBundle/Controller/ExampleController.php
namespace Slot\ExampleBundle\Controller;
use Symfony\Bundle\FrameworkBundle\Controller\Controller;
use Symfony\Component\HttpFoundation\Response;
use Slot\MandrillBundle\Message;
use Slot\MandrillBundle\Dispatcher;
class ExampleController extends Controller
{
public function indexAction()
{
$dispatcher = $this->get('slot_mandrill.dispatcher');
$message = new Message();
$message
->setFromEmail('[email protected]')
->setFromName('Customer Care')
->addTo('[email protected]')
->setSubject('Some Subject')
->setHtml('<html><body><h1>Some Content</h1></body></html>')
->setSubaccount('Project');
$result = $dispatcher->send($message);
return new Response('<pre>' . print_r($result, true) . '</pre>');
}
}
By default the bundle will assume the merge language is 'mailchimp'. You can
change this with $message->setMergeLanguage('handlebars')