MandrillBundle

, _(*1)

Send transactional mail through mandrill.com. This bundle provides an easy api for Symfony2 Projects., _(*2)

All settings inside message class represent attributes of Mandrill's API. Please refer to their API documentation for Details:, _(*3)

https://mandrillapp.com/api/docs/messages.html, _(*4)

Prerequisites

Before you're able to use this bundle you must sign up with Mandrill., _(*5)

http://mandrill.com, _(*6)

Mandrill is a great way to send your transactional emails and provides detailed advances reports., _(*7)

Mandrill is free for limited number of email per day, please read through pricing section on the website for more information:, _(*8)

http://mandrill.com/pricing/, _(*9)

Installation

Add the bundle to your composer.json, _(*10)

# composer.json
{
 "require": {
     "ffreitas-br/mandrill-bundle": "1.*",
 }
}

Run composer install, _(*11)

php ./composer.phar install

Enable the bundle in the kernel, _(*12)

<?php
// app/AppKernel.php

public function registerBundles()
{
    $bundles = array(
        // ...
        new FFreitasBr\MandrillBundle\MandrillBundle(),
    );
}

Configuration

Add configuration to config.yml., _(*13)

Log in to Mandrill and go to "Settings" -> "SMTP and API Credentials". Create an API Key and use it in your Symfony2 Configuration., _(*14)

# config.yml

mandrill:
    api_key: xxxxx
    disable_delivery: true # useful for dev/test environment. Default value is 'false'
    default:
        sender: info@example.com
        sender_name: John Doe
        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:, _(*15)

Use

Simple controller Example:, _(*16)


<?php

// src/FFreitasBr/ExampleBundle/Controller/ExampleController.php
namespace FFreitasBr\ExampleBundle\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\Controller;
use Symfony\Component\HttpFoundation\Response;
use FFreitasBr\MandrillBundle\Message;
use FFreitasBr\MandrillBundle\Dispatcher;

class ExampleController extends Controller
{
    public function indexAction()
    {
        $dispatcher = $this->get('mandrill.dispatcher');

        $message = new Message();

        $message
            ->setFromEmail('mail@example.com')
            ->setFromName('Customer Care')
            ->addTo('max.customer@email.com')
            ->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>');

    }

}