SwiftmailerSendGridBundle

, _(*2)

Symfony bundle for SendGrid. Utilizes the SendGrid PHP Library https://github.com/sendgrid/sendgrid-php to make it compatiable with SwiftMailer., _(*3)

Older version (1.x) can be found here: https://github.com/expertcoder/SwiftmailerSendGridBundle/tree/1.x, _(*4)

Installation

composer require expertcoder/swiftmailer-send-grid-bundle, _(*5)

or manually, _(*6)

composer.json, _(*7)

"require": {
    ...
    "expertcoder/swiftmailer-send-grid-bundle": "~2.0"
}

config/packages/swiftmailer.yaml, _(*8)

swiftmailer:
    transport: expertcoder_swift_mailer.send_grid

Don't forget to set your Sendgrid API Key in your .env file, and that you can set your mail's categories from config/packages/expert_coder_swiftmailer_send_grid.yaml, _(*9)

Applications that don't use Symfony Flex

AppKernel.php, _(*10)

$bundles = [
    // ...
    new ExpertCoder\Swiftmailer\SendGridBundle\ExpertCoderSwiftmailerSendGridBundle(),
];

parameters.yml.dist, _(*11)

parameters:
    sendgrid_api_key: PleaseEnterSendGridApiKey

config.yml, _(*12)

swiftmailer:
    transport: expertcoder_swift_mailer.send_grid

expert_coder_swiftmailer_send_grid:
    api_key: %sendgrid_api_key%
    categories: [my_category] # optional, will be added to all mails sent (can be seen on sendgrid dashboard)

Symfony 3

Since Symfony 3.2, you must name the custom transport service swiftmailer.mailer.transport.< name > so you can use one of the solutions below:, _(*13)

services.yml, _(*14)

services:
    swiftmailer.mailer.transport.expertcoder_swift_mailer.send_grid.transport:
      alias: expertcoder_swift_mailer.send_grid.transport

OR, _(*15)

config.yml, _(*16)

swiftmailer:
    transport: 'swiftmailer.mailer.transport.expertcoder_swift_mailer.send_grid'

Tests

This bundle provide a little helper to launch tests locally and here is a quick explanation:, _(*17)

The config_test.yml file contains configuration associated with the bundle.
The manual-test.sh helps you test against a specific symfony version and is the main helper to execute tests. You just have to do sh tests/manual-test.sh versionNumber where versionNumber is the main Symfony version you want to test (ex: 4)
The last file contains PhpUnit tests with help of nyholm/symfony-bundle-test. Note that we set a timeout of 1sec when sending mail to sendgrid as we do not test the actual sendgrid API with a real key.

Important !

Following RFC 1341, section 7.2, if either text/html or text/plain are to be sent in your email: text/plain needs to be first, followed by text/html, followed by any other content., _(*18)

For more informations, please see SwiftMailer and RFC 1341, _(*19)