Caution: This documentation is for eZ Publish legacy, from version 3.x to 6.x.
For 5.x documentation covering Platform see eZ Documentation Center, for difference between legacy and Platform see 5.x Architecture overview.

Transport

Summary

Controls how eZ Publish delivers outgoing mail.

Usage

Transport=sendmail|smtp|file

Description

This setting controls how eZ Publish should deliver outgoing mail. There are three transport options:

  •  "sendmail" - direct delivery through sendmail (must be available on the server)
  •  "smtp" - indirect delivery using an SMTP relay server
  •  "file" - mail is stored on the filesystem instead of being sent

The default value of this setting is "sendmail", which means that mail is delivered directly using the sendmail transfer agent.  This is available on UNIX/Linux systems only, so Windows users should probable use SMTP.

If sendmail is not available then SMTP should be used. (Make sure that SMTP server details are specified using the TransportServer, TransportPort, TransportUser and TransportPassword settings.)

If you need to check/view emails generated by the system without actually sending them out, set this directive to "file". Outgoing mails will be stored as separate files under the "var/log/mail" directory of your eZ Publish installation. Note that this option is for testing and debugging purposes only and should not be used on production/live sites.

From eZ Publish 4.4 (Fuji) onwards, it is possible to send emails with an SSL connection in SMTP.

Examples

Example 1

[MailSettings]
Transport=SMTP
TransportServer=<SMTP SERVER>
TransportConnectionType=ssl
TransportPort=465
TransportUser=<username>
TransportPassword=<password>

The above settings are an example of how your installation needs to be configured to allow your system to send emails with an SSL connection in SMTP.  Of course <SMTP SERVER>, <username> and <password> need to be changed in your own server name, user name and password.  Also port 465 can be changed into any other SSL port you use.

Example 2

[MailSettings]
Transport=SMTP
TransportServer=<SMTP SERVER>
TransportConnectionType=
TransportPort=25
TransportUser=<username>
TransportPassword=<password>

The above is an example of using SMTP sending without any encryption connection. <SMTP SERVER>, <username> and <password> need to be changed in your own server name, user name and password. Also port 25 can be changed into another port you use.

Frederik Holljen (06/05/2005 9:37 am)

Ester Heylen (29/09/2010 8:50 am)

Frederik Holljen, Julia Shymova, Svitlana Shatokhina, Ester Heylen


Comments

  • QMail

    Here a small hint:

    QMail requires:

    [MailSettings]
    HeaderLineEnding=%0D%0A

    You won't even get an error message without the that line.
  • Important note for 4.0.0 users

    Outgoing mail delivery through an SMTP server doesn't work in eZ Publish 4.0.0, see http://issues.ez.no/12321 Either upgrade to 4.0.1 (recommended) or download file http://pubsvn.ez.no/nextgen/stable/4.0/lib/ezutils/classes/ezsmtp.php and replace "lib/ezutils/classes/ezsmtp.php" in your installation.