Warning: You are browsing the documentation for Symfony 2.5, which is no longer maintained.
Read the updated version of this page for Symfony 6.0 (the current stable version).
Requirements for sending emails from a production system differ from your development setup as you don't want to be limited in the number of emails, the sending rate or the sender address. Thus, using Gmail or similar services is not an option. If setting up and maintaining your own reliable mail server causes you a headache there's a simple solution: Leverage the cloud to send your emails.
This cookbook shows how easy it is to integrate Amazon's Simple Email Service (SES) into Symfony.
You can use the same technique for other mail services, as most of the time there is nothing more to it than configuring an SMTP endpoint for Swift Mailer.
In the Symfony configuration, change the Swift Mailer settings
encryption according to the information provided in
the SES console. Create your individual SMTP credentials in the SES console
and complete the configuration with the provided
1 2 3 4 5 6 7 8
# app/config/config.yml swiftmailer: transport: smtp host: email-smtp.us-east-1.amazonaws.com port: 465 # different ports are available, see SES console encryption: tls # TLS encryption is required username: AWS_ACCESS_KEY # to be created in the SES console password: AWS_SECRET_KEY # to be created in the SES console
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20
<!-- app/config/config.xml --> <container xmlns="http://symfony.com/schema/dic/services" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:swiftmailer="http://symfony.com/schema/dic/swiftmailer" xsi:schemaLocation="http://symfony.com/schema/dic/services http://symfony.com/schema/dic/services/services-1.0.xsd http://symfony.com/schema/dic/swiftmailer http://symfony.com/schema/dic/swiftmailer/swiftmailer-1.0.xsd"> <!-- ... --> <swiftmailer:config transport="smtp" host="email-smtp.us-east-1.amazonaws.com" port="465" encryption="tls" username="AWS_ACCESS_KEY" password="AWS_SECRET_KEY" /> </container>
1 2 3 4 5 6 7 8 9
// app/config/config.php $container->loadFromExtension('swiftmailer', array( 'transport' => 'smtp', 'host' => 'email-smtp.us-east-1.amazonaws.com', 'port' => 465, 'encryption' => 'tls', 'username' => 'AWS_ACCESS_KEY', 'password' => 'AWS_SECRET_KEY', ));
encryption keys are not present in the Symfony Standard
Edition configuration by default, but you can simply add them as needed.
And that's it, you're ready to start sending emails through the cloud!
If you are using the Symfony Standard Edition, configure the parameters in
parameters.yml and use them in your configuration files. This allows
for different Swift Mailer configurations for each installation of your
application. For instance, use Gmail during development and the cloud in
1 2 3 4 5 6 7 8 9
# app/config/parameters.yml parameters: # ... mailer_transport: smtp mailer_host: email-smtp.us-east-1.amazonaws.com mailer_port: 465 # different ports are available, see SES console mailer_encryption: tls # TLS encryption is required mailer_user: AWS_ACCESS_KEY # to be created in the SES console mailer_password: AWS_SECRET_KEY # to be created in the SES console
If you intend to use Amazon SES, please note the following:
- You have to sign up to Amazon Web Services (AWS);
- Every sender address used in the
Return-Path(bounce address) header needs to be confirmed by the owner. You can also confirm an entire domain;
- Initially you are in a restricted sandbox mode. You need to request production access before being allowed to send to arbitrary recipients;
- SES may be subject to a charge.