Sending E-mail

Contents:


By default only the master environment can send emails. For the non-master environments, you can configure outgoing emails via the management console. Emails from Platform.sh are sent via a SendGrid-based SMTP proxy.

Each Platform.sh project is provisioned as a SendGrid sub-account. These SendGrid sub-accounts are capped at 12k emails per month. You can use /usr/sbin/sendmail on your application container to send emails with the assigned SendGrid sub-account. Alternatively, you can use the PLATFORM_SMTP_HOST environment variable to use in your SMTP configuration."

We do not guarantee the deliverability of emails, and we do not support white-labeling them. Our SMTP proxy is intended as a zero-configuration, best effort service. If needed, you can instead use your own SMTP server or email delivery service provider. In that case, please bear in mind that TCP port 25 is blocked for security reasons; use TCP port 465 or 587 instead.

Enabling/disabling email 

Email support can be enabled/disabled per-environment. By default, it is enabled on the master environment and disabled elsewhere. That can be toggled in through the management console or via the command line, like so:

platform environment:info enable_smtp true

platform environment:info enable_smtp false

When SMTP support is enabled the environment variable PLATFORM_SMTP_HOST will be populated with the address of the SMTP host that should be used. When SMTP support is disabled that environment variable will be empty.

Ports 

  • Port 465 and 587 should be used to send email to your own external email server.
  • Port 25 should be used to send through PLATFORM_SMTP_HOST. (this is the default in most mailers).

We proxy your emails through our own smtp host, and encrypt them over port 465 before sending them through to the outside world.

Testing the email service 

Before testing that the email service is working, please make sure that:

  • E-mail has been enabled on the environment
  • the environment has been redeployed
  • you have SSH’d into the environment and verified that the PLATFORM_SMTP_HOST environment variable is visible

To test the email service, first connect to your cluster through ssh using the cli command platform ssh. Substitute the email addresses and run the following snippet in the terminal:

$ php -r 'mail("mail@example.com", "test message", "just testing", "From: tester@example.com");'

After a couple minutes you should receive the “test message” in your mailbox.

Sending email in PHP 

When you send email, you can simply use the built-in mail() function in PHP. The PHP runtime is configured to send email automatically via the assigned SendGrid sub-account. Note that the From header is required; email will not send if that header is missing.

Beware of the potential security problems when using the mail() function, which arise when using user-supplied input in the fifth ($additional_parameters) argument. See the PHP mail() documentation for more information.

SwiftMailer 

In Symfony, if you use the default SwiftMailer service, we recommend the following settings in your app/config/parameters.yaml:

parameters:
  mailer_transport: smtp
  mailer_host: "%env(PLATFORM_SMTP_HOST)%"
  mailer_user: null
  mailer_password: null

If you are using a file spool facility, you will probably need to setup a read/write mount for it in .platform.app.yaml, for example:

mounts:
    'app/spool':
        source: local
        source_path: spool

Sending email in Java 

JavaMail is a Java API used to send and receive email via SMTP, POP3 and IMAP. JavaMail is built into the Jakarta EE platform, but also provides an optional package for use in Java SE.

Jakarta Mail defines a platform-independent and protocol-independent framework to build mail and messaging applications.

Below the sample code that uses Jakarta Mail:

import sh.platform.config.Config;

import javax.mail.Message;
import javax.mail.MessagingException;
import javax.mail.Session;
import javax.mail.Transport;
import javax.mail.internet.InternetAddress;
import javax.mail.internet.MimeMessage;
import java.util.Properties;
import java.util.logging.Level;
import java.util.logging.Logger;

public class JavaEmailSender {

    private static final Logger LOGGER = Logger.getLogger(JavaEmailSender.class.getName());

    public void send() {
        Config config = new Config();
        String to = "";//change accordingly
        String from = "";//change accordingly
        String host = config.getSmtpHost();
        //or IP address
        //Get the session object
        Properties properties = System.getProperties();
        properties.setProperty("mail.smtp.host", host);
        Session session = Session.getDefaultInstance(properties);

        //compose the message
        try {
            MimeMessage message = new MimeMessage(session);
            message.setFrom(new InternetAddress(from));
            message.addRecipient(Message.RecipientType.TO, new InternetAddress(to));
            message.setSubject("Ping");
            message.setText("Hello, this is example of sending email  ");

            // Send message
            Transport.send(message);
            System.out.println("message sent successfully....");

        } catch (MessagingException exp) {
            exp.printStackTrace();
            LOGGER.log(Level.SEVERE, "there is an error to send an message", exp);
        }
    }
}

There is plenty of additional documentation about using JavaMail, like this one, that shows how to send email with HTML formatting and attachments.

References