In a recent project I was working on which was based on Zend Framework (ZF) I wanted to send out some fairly complex emails following user registrations and for various alerts. ZF has a decent class for sending emails which just left forming the text I wanted to send in each email. For each type of email much of the content would remain the same with just a few things changing like name and date. I could have mixed up these elements and strung them together in a variable. This would probably have become very messy very quickly in the same way that mixing html and logic together gets messy quickly.
The solution to the html/logic issue is to use templates and unsurprisingly the same approach also works well for email. There is no shortage of templating systems for PHP and I suspect most would work perfectly adequately for this task. As I was already using ZF though I decided to go with Zend_View.
The class which follows wraps Zend_Mail and Zend_View together. It's possible to quickly and simply assign variables to be used in the template and then when the time comes to send the email additional default variables can be included from a config file. The config file also includes the location where the templates are stored and the email address from which the email should be sent.
/***Atemplatebasedemailsystem**Supportsthesendingofmultiparttxt/htmlemailsbasedontemplates***@authorJonathanStreet*/classAcai_Mail{/***Variableregistryfortemplatevalues*/protected $templateVariables=array();/***Templatename*/protected $templateName;/***Zend_Mailinstance*/protected $zendMail;/***Emailrecipient*/protected $recipient;/***__construct**Setdefaultoptions**/publicfunction__construct(){
$this->zendMail=newZend_Mail();}/***Setvariablesforuseinthetemplates**Magicfunctionstoresthevalueputinanyvariableinthisclassfor*uselaterwhencreatingthetemplate**@paramstring $nameThenameofthevariabletobestored*@parammixed $valueThevalueofthevariable*/publicfunction__set($name, $value){
$this->templateVariables[$name]= $value;}/***Setthetemplatefiletouse**@paramstring $filenameTemplatefilename*/publicfunctionsetTemplate($filename){
$this->templateName= $filename;}/***Settherecipientaddressfortheemailmessage**@paramstring $emailEmailaddress*/publicfunctionsetRecipient($email){
$this->recipient= $email;}/***Sendtheconstructedemail**@todoAddfromname*/publicfunctionsend(){/**Getdatafromconfig*-Fromaddress*-Directoryfortemplatefiles*/
$config=Zend_Registry::get('Config');
$templateDir= $config->email->template->dir;
$fromAddr= $config->email->from;
$templateVars= $config->email->vars->toArray();foreach($templateVarsas $key=> $value){//Ifavariableispresentinconfigwhichhasnotbeenset//addittothelistif(!array_key_exists($key, $this->templateVariables)){
$this->{$key}= $value;}}//Buildtemplate//Checkthattemplatefileexistsbeforeusing
$viewConfig=array('basePath'=> $templateDir);
$subjectView=newZend_View($viewConfig);foreach($this->templateVariablesas $key=> $value){
$subjectView->{$key}= $value;}try{
$subject= $subjectView->render($this->templateName.'.subj');}catch(Zend_View_Exception $e){
$subject=false;}
$textView=newZend_View($viewConfig);foreach($this->templateVariablesas $key=> $value){
$textView->{$key}= $value;}try{
$text= $textView->render($this->templateName.'.txt');}catch(Zend_View_Exception $e){
$text=false;}
$htmlView=newZend_View($viewConfig);foreach($this->templateVariablesas $key=> $value){
$htmlView->{$key}= $value;}try{
$html= $htmlView->render($this->templateName.'.html');}catch(Zend_View_Exception $e){
$html=false;}//var_dump($subject);//var_dump($text);//var_dump($html);//PassvariablestoZend_Mail
$mail=newZend_Mail();//var_dump($fromAddr);
$mail->setFrom($fromAddr);//var_dump($this->recipient);
$mail->addTo($this->recipient);
$mail->setSubject($subject);
$mail->setBodyText($text);if($html !==false){
$mail->setBodyHtml($html);}//Sendemail//$config=Zend_Registry::get('configuration');
$transport= $config->email->transport;if($transport=='Dev'){
$tr=newAcai_Mail_Transport_Dev;
$mail->send($tr);return;}
$mail->send();}}You may want to make some changes to how the class fetches its default values depending on your setup.
Using the class is very simple. Here is the code I use to send a confirmation email to a new user.
$emailObj=newAcai_Mail;
$emailObj->setRecipient($data['email']);
$emailObj->setTemplate('register');
$emailObj->activationLink= $actiUri;
$emailObj->send();Hopefully you find the above code of some use and can integrate it into your own projects. If you have any questions or suggestions please do post them in the comments below.