Switch From Swift Mailer to Symfony Mailer

The Varbase Email 9.0.x is managing a smooth switch from Swift Mailer to Symfony Mailer.

Using the same Varbase Email template file which works with both of them.

Only it's a matter of copying the old SMTP keys and configs to the Symfony Mailer way.

Steps to Switch to Symfony Mailer

Backup the site before any updates or changes.

Updating a Varbase Site

Update Varbase Email to 9.0.2 or later

The 9.0.2 version later requires the Symfony Mailer module.

  • Kept the Swift Mailer in the 9.0.x branch of Varbase Email, But switched the default config to use the Symfony Mailer module on the default installation.

  • Added the Symfony Mailer module, with all needed switching in code.

Copy the Old Swift Mailer Keys and Configs

Save any old configs for Swift Mailer or Mail System. Which had been sat before by

Configure Swift Mailer

Uninstall Swift Mailer and Mail System Modules

The Symfony Mailer module can not be enabled along with the Mail System module in the same system.

In case of trying to enable the Symfony Mailer Back-compatibility module. The following message will show up under install extensions.

Uninstall Swift Mailer and Mail System modules

drush pm:uninstall swiftmailer
drush pm:uninstall mailsystem

Enable the Symfony Mailer Module

drush pm:enable symfony_mailer
drush pm:enable symfony_mailer_bc

Follow with the Configure Symfony Mailer Steps

Use the saved backup copy of Swift Mailer mail system configs.

Configure Symfony Mailer

Or import the Varbase email module configuration partially using Drush:

drush cim --partial --source=/app/docroot/modules/contrib/varbase_email/config/optional

Migrate Custom Templates In Custom Themes

No extra work is needed when no custom changes in themes in projects.

Follow the following steps when having any custom changes over styling.

Switch from inline Styling to Libraries

Symfony Mailer clears all raw styling CSS elements in the template.

Inline or style elements are cleared out in the email.html.twig ,varbase_email.html.twig template file.

Remove custom CSS styling from your custom changes in your custom theme.

Create a new library to attach the needed styles to the template.

Example: custom_subtheme.libraries.yml file in your custom Vartheme sub-theme

default.email-style.ltr:
  css:
    theme:
      css/theme/email-style.theme.ltr.css: {}

default.email-style.rtl:
  css:
    theme:
      css/theme/email-style.theme.rtl.css: {}

Having a custom LTR ( Left to right ) and RTL (Right to left ) styling in separate files and libraries, to override the default Varbase Email libraries.

Symfony Mailer only allows attaching the custom style to the template using the default Drupal library system.

The Varbase Email module has two libraries that can be extended or overridden.

Example: custom_subtheme.info.yml file in your custom Vartheme sub-theme

libraries-override:
  varbase_email/default.email-style.ltr: custom_subtheme/default.email-style.ltr
  varbase_email/default.email-style.rtl: custom_subtheme/default.email-style.rtl

Migrate Custom Code or Custom Multiple Mailers

Symfony Mailer allows each module to have custom email templates and other sending transport.

The default transport service will be used when no custom transport was configured for the module. When a custom or contrib module is trying to send emails it will use the default. Unless a custom Symfony Mailer plugin was developed to support the contrib module with more options.

If the old project had any custom code or custom multiple mailers in the same system. The code should be migrated to configs. Using the Symfony Mailer plugin system.

Last updated