You can integrate Mailazy in minutes with your platform. Build and monitor your email solution on a trusted foundation with technical and strategic support when you need it the most.
Welcome emails is an important component of any email communication strategy. In order to ensure delivery of Welcome emails to your customers, reply on a trusted cloud-based email provider like Mailazy as a partner in your growth journey.
You need to complete these given prerequisites, you can skip the step if you have already completed.
Sign up for a Mailazy account.
Complete Domain Authentication.
Generate the Mailazy Access Key
Symfony uses SwiftMailer to send email, read more about sending emails from Symfony. To get started you need to modify parameters.yml
and add the following:
mailer:
class: sfMailer
param:
logging: %SF_LOGGING_ENABLED%
charset: %SF_CHARSET%
delivery_strategy: realtime
transport:
class: Swift_SmtpTransport
param:
host: smtp.mailazy.com
port: 587
encryption: ~
username: mailazy_apikey
api_key: mailazy_secret
After that you should be able to send emails. The following shows an example:
$message = Swift_Message::newInstance()
->setFrom('from@example.com')
->setTo('to@example.com')
->setSubject('Subject')
->setBody('Body');
$this->getMailer()->send($message);
If you want more flexibility, you can use partials to define the content of the emails. Add the a class such as lib/myEmail.class.php
.
class myEmail
{
/**
* Library to facilitate email messages being sent out, sendMail deprecated in symfony 1.2
* @param string $partial - Array with html and text partials ie array('text'=>'textPartial', 'html'=>'htmlPartial')
* @param array $parameters - Array we will pass into the partials
* @param string $mailFrom - Email source
* @param string $mailTo - Email destination
* @param string $subject - The subject of the email message
* @param array $sgHeaders - What we will be placing in the SMTPAPI header. Must be null or a non-empty array
* @param array $attachments - Email contains the attachments
*/
public static function sendEmail($partials, $parameters, $mailFrom, $mailTo, $subject, $sgHeaders = null, $attachments = null)
{
// verify we have username/api_key to send out emails - IMPORTANT
if (!sfconfig::has('mailazy_apikey') or !sfconfig::has('mailazy_secret')) {
throw new sfException('SMTP mailazy_apikey/mailazy_secret is required to send email out');
}
$text = null;
$html = null;
if (is_array($partials)) {
// load libraries
sfContext::getInstance()->getConfiguration()->loadHelpers('Partial');
if (isset($partials['text'])) {
$text = get_partial($partials['text'], $parameters);
}
if (isset($partials['html'])) {
$html = get_partial($partials['html'], $parameters);
}
}
if ($text === null && $html === null) {
throw new sfException('A text and/or HTML partial must be given');
}
try {
/*
* Load connection for mailer
*/
$connection = Swift_SmtpTransport::newInstance('smtp.mailazy.com', 587, 'tls')->setUsername(sfconfig::get('mailazy_apikey'))->setPassword(sfconfig::get('mailazy_secret'));
// setup connection/content
$mailer = Swift_Mailer::newInstance($connection);
$message = Swift_Message::newInstance()->setSubject($subject)->setTo($mailTo);
if ($text && $html) {
$message->setBody($html, 'text/html');
$message->addPart($text, 'text/plain');
} else if ($text) {
$message->setBody($text, 'text/plain');
} else {
$message->setBody($html, 'text/html');
}
// if contains SMTPAPI header add it
if (null !== $sgHeaders) {
$message->getHeaders()->addTextHeader('X-SMTPAPI', json_encode($sgHeaders));
}
// update the from address line to include an actual name
if (is_array($mailFrom) and count($mailFrom) == 2) {
$mailFrom = array(
$mailFrom['email'] => $mailFrom['name']
);
}
// add attachments to email
if ($attachments !== null and is_array($attachments)) {
foreach ($attachments as $attachment) {
$attach = Swift_Attachment::fromPath($attachment['file'], $attachment['mime'])->setFilename($attachment['filename']);
$message->attach($attach);
}
}
// Send
$message->setFrom($mailFrom);
$mailer->send($message);
}
catch (Exception $e) {
throw new sfException('Error sending email out - ' . $e->getMessage());
}
}
}
Then configure your credentials on apps/frontend/app.yml
prod:
username: mailazy_apikey
password: mailazy_secret
Now can put your partials in a module such as apps/frontend/modules/mail. For example, to send a registration email in both text and HTML, we would have the following structure:
apps/
frontend/
modules/
mail/
_registrationHTML.php
_registrationTEXT.php
Add this to apps/frontend/modules/mail/\_registrationTEXT.php
Dear < ?php echo $name ?>,
Thank you for registering. Please go to http://domain.com to finish your registration.
Add this to apps/frontend/modules/mail/_registrationHTML.php
Dear < ?php echo $name; ?>,
Thank you for registering. Please go to here to finish your registration.
And send the message as follow:
myEmail::sendEmail(array('text'=>'mail/registrationTEXT', 'html'=>'mail/registrationHTML'), array('name'=>'Recipient Name'), 'youremail@domain.com', 'recipient@example.com', 'Registration Information');
Mailazy email delivery platform is powered by AI and uses the global infrastructure so that you can scale effortlessly. Mailazy is the trusted transactional email provider for hundreds of businesses and we are growing every day. We are known for being the most reliable and trusted senders on the internet.