Mailer.php
[Pman.Core] / Mailer.php
1 <?php
2
3 /**
4  *
5  *  code that used to be in Pman (sendTemplate / emailTemplate)
6  * 
7  *  template is in template directory subfolder 'mail'
8  *   
9  *  eg. use 'welcome' as template -> this will use templates/mail/welcome.txt
10  *  if you also have templates/mail/welcome.body.html - then that will be used as 
11  *     the html body
12  * 
13  *
14  *  usage:
15  *
16  * 
17  *  require_once 'Pman/Core/Mailer.php';
18  *  $x= new  Pman_Core_Mailer(array(
19        'page' => $this,
20                 // if bcc is property of this, then it will be used (BAD DESIGN)
21        'rcpts' => array(),    
22        'template' => 'your_template',
23                 // must be in templates/mail direcotry..
24                 // header and plaintext verison in mail/your_template.txt
25                 // if you want a html body - use  mail/your_template.body.html
26        
27         // 'bcc' => 'xyz@abc.com,abc@xyz.com',  // string...
28         // 'contents'  => array(),              //  << keys must be trusted
29                                             // if bcc is property of contents, then it will be used (BAD DESIGN)
30            
31         // 'html_locale => 'en',                // always use the 'english translated verison'
32         // 'cache_images => true,               // -- defaults to caching images - set to false to disable.
33         // 'replaceImages => false,             // should images be replaced.
34         // 'urlmap => array(                    // map urls from template to a different location.
35         //      'https://www.mysite.com/' => 'http://localhost/',
36         // ),
37         // 'locale' => 'en',                    // .... or zh_hk....
38            
39         // 'attachments' => array(
40         //       array(
41         //        'file' => '/path/to/file',    // file location
42         //        name => 'myfile.pdf',         // (optional) - uses basename of file
43         //        mimetype : 
44         //      ), 
45         //  
46         // 'mail_method' =>  'SMTP',            // or SMTPMX
47   
48     )
49  *
50  *  recipents is gathered from the resulting template
51  *   -- eg.
52  *    To: <a>,<b>,<c>
53  * 
54  * 
55  *  if the file     '
56  * 
57  * 
58  *  $x->toData(); // returns data needed for notify?? - notify should really
59  *                  // just use this to pass around later..
60  *
61  *  $x->send();
62  *
63  */
64
65 class Pman_Core_Mailer {
66     var $debug          = 0;
67     var $page           = false; /* usually a html_flexyframework_page */
68     var $contents       = false; /* object or array */
69     var $template       = false; /* string */
70     var $replaceImages  = false; /* boolean */
71     var $rcpts   = false;
72     var $templateDir = false;
73     var $locale = false; // eg. 'en' or 'zh_HK'
74     var $urlmap = array();
75     
76     
77     var $html_locale = false; // eg. 'en' or 'zh_HK'
78     var $images         = array(); // generated list of cid images for sending
79     var $attachments = false;
80     var $css_inline = false; // put the css into the html
81     var $css_embed = false; // put the css tags into the body.
82     
83     var $mail_method = 'SMTP';
84     
85     var $cache_images = true;
86       
87     var $bcc = false;
88     
89     var $body_cls = false;
90     
91     function __construct($args) {
92         foreach($args as $k=>$v) {
93             // a bit trusting..
94             $this->$k =  $v;
95         }
96         // allow core mailer debug setting.
97         $ff = HTML_FlexyFramework::get();
98         
99         if (!empty($ff->Core_Mailer['debug'])) {
100             $this->debug = $ff->Core_Mailer['debug'];
101         }
102         //$this->log("URL MAP");
103         //$this->log($this->urlmap);
104         
105     }
106      
107     /**
108      * ---------------- Global Tools ---------------   
109      */
110     
111     function toData()
112     {
113         $templateFile = $this->template;
114         $args = (array)$this->contents;
115         $content  = clone($this->page);
116         
117         foreach($args as $k=>$v) {
118             $content->$k = $v;
119         }
120         
121         $content->msgid = empty($content->msgid ) ? md5(time() . rand()) : $content->msgid ;
122         
123         $ff = HTML_FlexyFramework::get();
124         $http_host = isset($_SERVER["HTTP_HOST"]) ? $_SERVER["HTTP_HOST"] : 'pman.HTTP_HOST.not.set';
125         if (isset($ff->Pman['HTTP_HOST'])) {
126             $http_host  = $ff->Pman['HTTP_HOST'];
127         }
128         
129         $content->HTTP_HOST = $http_host;
130         
131         // this should be done by having multiple template sources...!!!
132         
133         require_once 'HTML/Template/Flexy.php';
134         
135         $tmp_opts = array(
136            // 'forceCompile' => true,
137             'site_prefix' => false,
138             'multiSource' => true,
139         );
140         if (!empty($this->templateDir)) {
141             $tmp_opts['templateDir'] = $this->templateDir;
142         }
143         $fopts = HTML_FlexyFramework::get()->HTML_Template_Flexy;
144         if (!empty($fopts['DB_DataObject_translator'])) {
145             $tmp_opts['DB_DataObject_translator'] = $fopts['DB_DataObject_translator'];
146         }
147         if (!empty($fopts['locale'])) {
148             $tmp_opts['locale'] = $fopts['locale'];
149         }
150         
151         // local opt's overwrite
152         if (!empty($this->locale)) {
153             $tmp_opts['locale'] = $this->locale;
154         }
155         
156         $htmlbody = false;
157         $html_tmp_opts = $tmp_opts;
158         $htmltemplate = new HTML_Template_Flexy( $html_tmp_opts );
159         if (is_string($htmltemplate->resolvePath('mail/'.$templateFile.'.body.html')) ) { 
160             // then we have a multi-part email...
161             if (!empty($this->html_locale)) {
162                 $html_tmp_opts['locale'] = $this->html_locale;
163             }
164             $htmltemplate = new HTML_Template_Flexy( $html_tmp_opts );
165             
166             $htmltemplate->compile('mail/'. $templateFile.'.body.html');
167             $htmlbody =  $htmltemplate->bufferedOutputObject($content);
168             
169             $this->htmlbody = $htmlbody;
170             
171             // for the html body, we may want to convert the attachments to images.
172 //            var_dump($htmlbody);exit;
173             
174             if(!empty($content->body_cls) && strlen($content->body_cls)){
175                 $htmlbody = $this->htmlbodySetClass($htmlbody, $content->body_cls);
176             }
177             
178             if ($this->replaceImages) {
179                 $htmlbody = $this->htmlbodytoCID($htmlbody);    
180             }
181             
182             if ($this->css_embed) {
183                 $htmlbody = $this->htmlbodyCssEmbed($htmlbody);
184             }
185             
186             if ($this->css_inline && strlen($this->css_inline)) {
187                 $htmlbody = $this->htmlbodyInlineCss($htmlbody);
188             }
189             
190         }
191         $tmp_opts['nonHTML'] = true;
192         
193         
194         //print_R($tmp_opts);
195         // $tmp_opts['force'] = true;
196         
197         $template = new HTML_Template_Flexy(  $tmp_opts );
198         $template->compile('mail/'. $templateFile.'.txt');
199         
200         /* use variables from this object to ouput data. */
201         $mailtext = $template->bufferedOutputObject($content);
202         //print_r($mailtext);exit;
203        
204         
205         
206         //echo "<PRE>";print_R($mailtext);
207         
208         /* With the output try and send an email, using a few tricks in Mail_MimeDecode. */
209         require_once 'Mail/mimeDecode.php';
210         require_once 'Mail.php';
211         
212         $decoder = new Mail_mimeDecode($mailtext);
213         $parts = $decoder->getSendArray();
214         if (PEAR::isError($parts)) {
215             return $parts;
216             //echo "PROBLEM: {$parts->message}";
217             //exit;
218         } 
219         
220         $isMime = false;
221         
222         require_once 'Mail/mime.php';
223         $mime = new Mail_mime(array(
224             'eol' => "\n",
225             //'html_encoding' => 'base64',
226             'html_charset' => 'utf-8',
227             'text_charset' => 'utf-8',
228             'head_charset' => 'utf-8',
229         ));
230         // clean up the headers...
231         
232         
233         $parts[1]['Message-Id'] = '<' .   $content->msgid   .
234                                      '@' . $content->HTTP_HOST .'>';
235         
236           
237         if ($htmlbody !== false) {
238             // got a html headers...
239             
240             if (isset($parts[1]['Content-Type'])) {
241                 unset($parts[1]['Content-Type']);
242             }
243             $mime->setTXTBody($parts[2]);
244             $mime->setHTMLBody($htmlbody);
245 //            var_dump($mime);exit;
246             foreach($this->images as $cid=>$cdata) { 
247             
248                 $mime->addHTMLImage(
249                     $cdata['file'],
250                      $cdata['mimetype'],
251                      $cid.'.'.$cdata['ext'],
252                     true,
253                     $cdata['contentid']
254                 );
255             }
256             $isMime = true;
257         }
258         
259         if(!empty($this->attachments)){
260             //if got a attachments
261             $header = $mime->headers($parts[1]);
262             
263             if (isset($parts[1]['Content-Type'])) {
264                 unset($parts[1]['Content-Type']);
265             }
266             
267             if (!$isMime) {
268             
269                 if(preg_match('/text\/html/', $header['Content-Type'])){
270                     $mime->setHTMLBody($parts[2]);
271                     $mime->setTXTBody('This message is in HTML only');
272                 }else{
273                     $mime->setTXTBody($parts[2]);
274                     $mime->setHTMLBody('<PRE>'.htmlspecialchars($parts[2]).'</PRE>');
275                 }
276             }
277             foreach($this->attachments as $attch){
278                 $mime->addAttachment(
279                         $attch['file'],
280                         $attch['mimetype'],
281                         (!empty($attch['name'])) ? $attch['name'] : '',
282                         true
283                 );
284             }
285             
286             $isMime = true;
287         }
288         
289         if($isMime){
290             $parts[2] = $mime->get();
291             $parts[1] = $mime->headers($parts[1]);
292         }
293          
294         
295         $ret = array(
296             'recipents' => $parts[0],
297             'headers' => $parts[1],
298             'body' => $parts[2],
299             'mailer' => $this
300         );
301         if ($this->rcpts !== false) {
302             $ret['recipents'] =  $this->rcpts;
303         }
304         // if 'to' is empty, then add the recipents in there... (must be an array?
305         if (!empty($ret['recipents']) && is_array($ret['recipents']) &&
306                 (empty($ret['headers']['To']) || !strlen(trim($ret['headers']['To'])))) {
307             $ret['headers']['To'] = implode(',', $ret['recipents']);
308         }
309        
310         
311         // add bcc if necessary..
312         if (!empty($this->bcc)) {
313            $ret['bcc'] = $this->bcc;
314         }
315         return $ret;
316     }
317     function send($email = false)
318     {
319                         
320         $ff = HTML_FlexyFramework::get();
321         
322         $pg = $ff->page;
323         
324         $ts = microtime(true);
325         $email = is_array($email)  ? $email : $this->toData();
326         print_r(microtime(true) - $ts);exit;
327         if (is_a($email, 'PEAR_Error')) {
328             $pg->addEvent("COREMAILER-FAIL",  false, "email toData failed"); 
329       
330             
331             return $email;
332         }
333         
334         //$this->log( htmlspecialchars(print_r($email,true)));
335         
336         ///$recipents = array($this->email);
337 //        $mailOptions = PEAR::getStaticProperty('Mail','options');
338         
339         $mailOptions = isset($ff->Mail) ? $ff->Mail : array();
340         //print_R($mailOptions);exit;
341         
342         if ($this->mail_method == 'SMTPMX' && empty($mailOptions['mailname'])) {
343             $pg->jerr("Mail[mailname] is not set - this is required for SMTPMX");
344             
345         }
346         
347         $mail = Mail::factory($this->mail_method,$mailOptions);
348         if ($this->debug) {
349             $mail->debug = (bool) $this->debug;
350         }
351         
352         $email['headers']['Date'] = date('r'); 
353         if (PEAR::isError($mail)) {
354             $pg->addEvent("COREMAILER-FAIL",  false, "mail factory failed"); 
355       
356             
357             return $mail;
358         } 
359         $rcpts = $this->rcpts == false ? $email['recipents'] : $this->rcpts;
360         
361         
362         
363         // this makes contents untrustable...
364         if (!empty($this->contents['bcc']) && is_array($this->contents['bcc'])) {
365             $rcpts =array_merge(is_array($rcpts) ? $rcpts : array($rcpts), $this->contents['bcc']);
366         }
367         
368         $oe = error_reporting(E_ALL & ~E_NOTICE & ~E_STRICT);
369         $ret = $mail->send($rcpts,$email['headers'],$email['body']);
370         error_reporting($oe);
371         if ($ret === true) { 
372             $pg->addEvent("COREMAILER-SENT",  false,
373                 'To: ' .  ( is_array($rcpts) ? implode(', ', $rcpts) : $rcpts ) .
374                 'Subject: '  . @$email['headers']['Subject']
375             ); 
376         }  else {
377             $pg->addEvent("COREMAILER-FAIL",  false, $ret->toString());
378         }
379         
380         return $ret;
381     }
382     
383     function htmlbodytoCID($html)
384     {
385         $dom = new DOMDocument();
386         // this may raise parse errors as some html may be a component..
387         @$dom->loadHTML('<?xml encoding="UTF-8">' .$html);
388         $imgs= $dom->getElementsByTagName('img');
389         
390         $urls = array();
391         
392         foreach ($imgs as $i=>$img) {
393             $url  = $img->getAttribute('src');
394             if (preg_match('#^cid:#', $url)) {
395                 continue;
396             }
397             $me = $img->getAttribute('mailembed');
398             if ($me == 'no') {
399                 continue;
400             }
401             
402             if(!array_key_exists($url, $urls)){
403                 $conv = $this->fetchImage($url);
404                 $urls[$url] = $conv;
405                 $this->images[$conv['contentid']] = $conv;
406             } else {
407                 $conv = $urls[$url];
408             }
409             
410             $img->setAttribute('src', 'cid:' . $conv['contentid']);
411         }
412         
413         /*
414         foreach ($imgs as $i=>$img) {
415             $url  = $img->getAttribute('src');
416             if (preg_match('#^cid:#', $url)) {
417                 continue;
418             }
419             $me = $img->getAttribute('mailembed');
420             if ($me == 'no') {
421                 continue;
422             }
423             
424             $conv = $this->fetchImage($url);
425             $this->images[$conv['contentid']] = $conv;
426             
427             $img->setAttribute('src', 'cid:' . $conv['contentid']);
428         }
429         * 
430         */
431         
432         return $dom->saveHTML();
433         
434         
435         
436     }
437     function htmlbodyCssEmbed($html)
438     {
439         $ff = HTML_FlexyFramework::get();
440         $dom = new DOMDocument();
441         
442         // this may raise parse errors as some html may be a component..
443         @$dom->loadHTML('<?xml encoding="UTF-8">' .$html);
444         $links = $dom->getElementsByTagName('link');
445         $lc = array();
446         foreach ($links as $link) {  // duplicate as links is dynamic and we change it..!
447             $lc[] = $link;
448         }
449         //<link rel="stylesheet" type="text/css" href="{rootURL}/roojs1/css-mailer/mailer.css">
450         
451         foreach ($lc as $i=>$link) {
452             //var_dump($link->getAttribute('href'));
453             
454             if ($link->getAttribute('rel') != 'stylesheet') {
455                 continue;
456             }
457             $url  = $link->getAttribute('href');
458             $file = $ff->rootDir . $url;
459             
460             if (!preg_match('#^(http|https)://#', $url)) {
461                 $file = $ff->rootDir . $url;
462
463                 if (!file_exists($file)) {
464 //                    echo $file;
465                     $link->setAttribute('href', 'missing:' . $file);
466                     continue;
467                 }
468             } else {
469                $file = $this->mapurl($url);  
470             }
471             
472             $par = $link->parentNode;
473             $par->removeChild($link);
474             $s = $dom->createElement('style');
475             $e = $dom->createTextNode(file_get_contents($file));
476             $s->appendChild($e);
477             $par->appendChild($s);
478             
479         }
480         return $dom->saveHTML();
481         
482         
483     }
484     
485     function htmlbodyInlineCss($html)
486     {   
487         $dom = new DOMDocument();
488         
489         @$dom->loadHTML('<?xml encoding="UTF-8">' .$html);
490         
491         $html = $dom->getElementsByTagName('html');
492         $head = $dom->getElementsByTagName('head');
493         $body = $dom->getElementsByTagName('body');
494         
495         if(!$head->length){
496             $head = $dom->createElement('head');
497             $html->item(0)->insertBefore($head, $body->item(0));
498             $head = $dom->getElementsByTagName('head');
499         }
500         
501         $s = $dom->createElement('style');
502         $e = $dom->createTextNode($this->css_inline);
503         $s->appendChild($e);
504         $head->item(0)->appendChild($s);
505         
506         return $dom->saveHTML();
507         
508         /* Inline
509         require_once 'HTML/CSS/InlineStyle.php';
510         
511         $doc = new HTML_CSS_InlineStyle($html);
512         
513         $doc->applyStylesheet($this->css_inline);
514         
515         $html = $doc->getHTML();
516         
517         return $html;
518         */
519     }
520     
521     function htmlbodySetClass($html, $cls)
522     {
523         $dom = new DOMDocument();
524         
525         @$dom->loadHTML('<?xml encoding="UTF-8">' .$html);
526         
527         $body = $dom->getElementsByTagName('body');
528         
529         $class = $dom->createAttribute('class');
530         $class->value = $cls;
531         $body->item(0)->appendChild($class);
532         
533         return $dom->saveHTML();
534     }
535     
536     function fetchImage($url)
537     {
538         
539         
540         $this->log( "FETCH : $url\n");
541         
542         if ($url[0] == '/') {
543             $ff = HTML_FlexyFramework::get();
544             $file = $ff->rootDir . $url;
545             require_once 'File/MimeType.php';
546             $m  = new File_MimeType();
547             $mt = $m->fromFilename($file);
548             $ext = $m->toExt($mt); 
549             
550             return array(
551                     'mimetype' => $mt,
552                    'ext' => $ext,
553                    'contentid' => md5($file),  // mailer makes md5 cid's' -- cid with attachment-** are done by mailer.
554                    'file' => $file
555             );
556             
557             
558             
559         }
560         
561         //print_R($url); exit;
562         
563         
564         if (preg_match('#^file:///#', $url)) {
565             $file = preg_replace('#^file://#', '', $url);
566             require_once 'File/MimeType.php';
567             $m  = new File_MimeType();
568             $mt = $m->fromFilename($file);
569             $ext = $m->toExt($mt); 
570             
571             return array(
572                 'mimetype'  => $mt,
573                 'ext'       =>   $ext,
574                 'contentid' => md5($file),
575                 'file'      => $file
576             );
577             
578         }
579         
580         // CACHE???
581         // 2 files --- the info file.. and the actual file...
582         // add user
583         // unix only...
584         $uinfo = posix_getpwuid( posix_getuid () ); 
585         $user = $uinfo['name']; 
586         
587         $cache = ini_get('session.save_path')."/Pman_Core_Mailer-{$user}/" . md5($url);
588         if ($this->cache_images &&
589                 file_exists($cache) &&
590                 filemtime($cache) > strtotime('NOW - 1 WEEK')
591             ) {
592             $ret =  json_decode(file_get_contents($cache), true);
593             $this->log("fetched from cache");
594             $ret['file'] = $cache . '.data';
595             return $ret;
596         }
597         if (!file_exists(dirname($cache))) {
598             mkdir(dirname($cache),0700, true);
599         }
600         
601         require_once 'HTTP/Request.php';
602         
603         $real_url = str_replace(' ', '%20', $this->mapurl($url));
604         $a = new HTTP_Request($real_url);
605         $a->sendRequest();
606         $data = $a->getResponseBody();
607         
608         $this->log("got file of size " . strlen($data));
609         $this->log("save contentid " . md5($url));
610         
611         file_put_contents($cache .'.data', $data);
612         
613         
614         $mt = $a->getResponseHeader('Content-Type');
615         
616         require_once 'File/MimeType.php';
617         $m  = new File_MimeType();
618         $ext = $m->toExt($mt);
619         
620         $ret = array(
621             'mimetype' => $mt,
622             'ext' => $ext,
623             'contentid' => md5($url)
624             
625         );
626         
627         file_put_contents($cache, json_encode($ret));
628         $ret['file'] = $cache . '.data';
629         return $ret;
630     }  
631     
632     function mapurl($in)
633     {
634         
635         foreach($this->urlmap as $o=>$n) {
636             if (strpos($in,$o) === 0) {
637                 $ret =$n . substr($in,strlen($o));
638                 $this->log("mapURL in $in = $ret");
639                 return $ret;
640             }
641         }
642         $this->log("mapurl no change - $in");
643         return $in;
644          
645         
646     }
647  
648     
649     
650     function log($val)
651     {
652         if (!$this->debug) {
653             return;
654         }
655         if ($this->debug < 2) {
656             echo '<PRE>' . print_r($val,true). "\n"; 
657             return;
658         }
659         $fh = fopen('/tmp/core_mailer.log', 'a');
660         fwrite($fh, date('Y-m-d H:i:s -') . json_encode($val) . "\n");
661         fclose($fh);
662         
663         
664     }
665     
666 }