gylaandrij / swiftmailer-mailgun-bundle
Swiftmailer Mailgun bundle
Installs: 1 905
Dependents: 0
Suggesters: 0
Security: 0
Stars: 1
Watchers: 2
Forks: 49
Type:symfony-bundle
Requires
- php: ^7.0
- mailgun/mailgun-php: ^2.3
- swiftmailer/swiftmailer: ^6.0
- symfony/dependency-injection: ^4.0
- symfony/swiftmailer-bundle: ^3.2.1
Requires (Dev)
Suggests
- azine/mailgunwebhooks-bundle: Allows to handle Mailgun event webhooks
- php-http/httplug-bundle: To manage your http clients
README
This bundle adds an extra transport to the swiftmailer service that uses the mailgun http interface for sending messages.
Installation
composer require gylaandrij/swiftmailer-mailgun-bundle php-http/guzzle5-adapter
Note: You can use any of these adapters
Also add to your AppKernel:
new cspoo\Swiftmailer\MailgunBundle\cspooSwiftmailerMailgunBundle(),
Configure your application with the credentials you find on the domain overview on the Mailgun.com dashboard.
// app/config/config.yml: cspoo_swiftmailer_mailgun: key: "key-xxxxxxxxxx" domain: "mydomain.com" http_client: 'httplug.client' # Optional. Defaults to null and uses discovery to find client. # Swiftmailer Configuration swiftmailer: transport: "mailgun" spool: { type: memory } # This will start sending emails on kernel.terminate event
Note that the swiftmailer configuration is the same as the standard one - you just change the mailer_transport parameter.
Usage
First craft a message:
$message = \Swift_Message::newInstance() ->setSubject('Hello Email') ->setFrom('send@example.com') ->setTo('recipient@example.com') ->setBody( $this->renderView( 'HelloBundle:Hello:email.txt.twig', array('name' => $name) ) ) ;
Then send it as you normally would with the mailer
service. Your configuration ensures that you will be using the Mailgun transport.
$this->container->get('mailer')->send($message);
Choose HTTP client
Mailgun 2.0 is no longer coupled to Guzzle5. Thanks to Httplug you can now use any library to transport HTTP messages. You can rely on discovery to automatically find an installed client or you can use HttplugBundle and provide a client service name to the mailgun configuration.
// app/config/config.yml: cspoo_swiftmailer_mailgun: http_client: 'httplug.client'