26 Feb 2011
Development Notes

Email sending functionalities can vary from server to server. Symphony 2.2 introduces a new email API that allows the use of different “gateways” for sending email.

The Symphony core includes two gateways, and more gateways can be installed using extensions. The core gateways are:


This is the “traditional” way to send emails, using PHP’s mail() function and the server’s Sendmail socket. Symphony versions prior to 2.2 always used this.


This allows the system to send emails using a remote SMTP server. This method is generally more reliable and can be especially helpful when mail/Sendmail is unavailable (e.g. on localhost, or on cloud setups).

Using Email Gateways

An “Email Gateway” section has been added to the System > Preferences page, allowing you to define:

  • The email gateway you’d like the system to use when it sends email (i.e. when the send-email event option is triggers, or when a reset-password has been requested).
  • The default sender name and sender address (these are no longer hardcoded in the core and can be changed at any time).
  • Gateway-specific settings (visible as soon as you choose a gateway).

The gateway chosen here only applies to Symphony’s native email functionalities. Your own scripts can use any of the available gateways independent of this setting (developer documentation forthcoming [draft]).


No comments made yet.

Create an account or sign in to comment.

Symphony • Open Source XSLT CMS

Server Requirements

  • PHP 5.3-5.6 or 7.0-7.3
  • PHP's LibXML module, with the XSLT extension enabled (--with-xsl)
  • MySQL 5.5 or above
  • An Apache or Litespeed webserver
  • Apache's mod_rewrite module or equivalent

Compatible Hosts

Sign in

Login details