git.roojs.org Git - Pman.Core/blob - 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; // not supported
  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     function __construct($args) {
  90         foreach($args as $k=>$v) {
  91             // a bit trusting..
  92             $this->$k =  $v;
  93         }
  94         // allow core mailer debug setting.
  95         $ff = HTML_FlexyFramework::get();
  96
  97         if (!empty($ff->Core_Mailer['debug'])) {
  98             $this->debug = $ff->Core_Mailer['debug'];
  99         }
 100         //$this->log("URL MAP");
 101         //$this->log($this->urlmap);
 102
 103     }
 104
 105     /**
 106      * ---------------- Global Tools ---------------
 107      */
 108
 109     function toData()
 110     {
 111         $templateFile = $this->template;
 112         $args = (array)$this->contents;
 113         $content  = clone($this->page);
 114
 115         foreach($args as $k=>$v) {
 116             $content->$k = $v;
 117         }
 118
 119         $content->msgid = empty($content->msgid ) ? md5(time() . rand()) : $content->msgid ;
 120
 121         $ff = HTML_FlexyFramework::get();
 122         $http_host = isset($_SERVER["HTTP_HOST"]) ? $_SERVER["HTTP_HOST"] : 'pman.HTTP_HOST.not.set';
 123         if (isset($ff->Pman['HTTP_HOST'])) {
 124             $http_host  = $ff->Pman['HTTP_HOST'];
 125         }
 126
 127
 128         $content->HTTP_HOST = $http_host;
 129
 130
 131
 132
 133         // this should be done by having multiple template sources...!!!
 134
 135         require_once 'HTML/Template/Flexy.php';
 136
 137         $tmp_opts = array(
 138            // 'forceCompile' => true,
 139             'site_prefix' => false,
 140             'multiSource' => true,
 141         );
 142         if (!empty($this->templateDir)) {
 143             $tmp_opts['templateDir'] = $this->templateDir;
 144         }
 145         $fopts = HTML_FlexyFramework::get()->HTML_Template_Flexy;
 146         if (!empty($fopts['DB_DataObject_translator'])) {
 147             $tmp_opts['DB_DataObject_translator'] = $fopts['DB_DataObject_translator'];
 148         }
 149         if (!empty($fopts['locale'])) {
 150             $tmp_opts['locale'] = $fopts['locale'];
 151         }
 152
 153         // local opt's overwrite
 154         if (!empty($this->locale)) {
 155             $tmp_opts['locale'] = $this->locale;
 156         }
 157
 158         $htmlbody = false;
 159         $html_tmp_opts = $tmp_opts;
 160         $htmltemplate = new HTML_Template_Flexy( $html_tmp_opts );
 161         if (is_string($htmltemplate->resolvePath('mail/'.$templateFile.'.body.html')) ) {
 162             // then we have a multi-part email...
 163             if (!empty($this->html_locale)) {
 164                 $html_tmp_opts['locale'] = $this->html_locale;
 165             }
 166             $htmltemplate = new HTML_Template_Flexy( $html_tmp_opts );
 167
 168             $htmltemplate->compile('mail/'. $templateFile.'.body.html');
 169             $htmlbody =  $htmltemplate->bufferedOutputObject($content);
 170
 171             $this->htmlbody = $htmlbody;
 172
 173             // for the html body, we may want to convert the attachments to images.
 174 //            var_dump($htmlbody);exit;
 175             if ($this->replaceImages) {
 176                 $htmlbody = $this->htmlbodytoCID($htmlbody);
 177             }
 178             if ($this->css_embed) {
 179                 $htmlbody = $this->htmlbodyCssEmbed($htmlbody);
 180
 181             }
 182         }
 183         $tmp_opts['nonHTML'] = true;
 184
 185
 186         //print_R($tmp_opts);
 187         // $tmp_opts['force'] = true;
 188
 189         $template = new HTML_Template_Flexy(  $tmp_opts );
 190         $template->compile('mail/'. $templateFile.'.txt');
 191
 192         /* use variables from this object to ouput data. */
 193         $mailtext = $template->bufferedOutputObject($content);
 194         //print_r($mailtext);exit;
 195
 196
 197
 198         //echo "<PRE>";print_R($mailtext);
 199
 200         /* With the output try and send an email, using a few tricks in Mail_MimeDecode. */
 201         require_once 'Mail/mimeDecode.php';
 202         require_once 'Mail.php';
 203
 204         $decoder = new Mail_mimeDecode($mailtext);
 205         $parts = $decoder->getSendArray();
 206         if (PEAR::isError($parts)) {
 207             return $parts;
 208             //echo "PROBLEM: {$parts->message}";
 209             //exit;
 210         }
 211
 212         $isMime = false;
 213
 214         require_once 'Mail/mime.php';
 215         $mime = new Mail_mime(array(
 216             'eol' => "\n",
 217             //'html_encoding' => 'base64',
 218             'html_charset' => 'utf-8',
 219             'text_charset' => 'utf-8',
 220             'head_charset' => 'utf-8',
 221         ));
 222         // clean up the headers...
 223
 224
 225         $parts[1]['Message-Id'] = '<' .   $content->msgid   .
 226                                      '@' . $content->HTTP_HOST .'>';
 227
 228
 229         if ($htmlbody !== false) {
 230             // got a html headers...
 231
 232             if (isset($parts[1]['Content-Type'])) {
 233                 unset($parts[1]['Content-Type']);
 234             }
 235             $mime->setTXTBody($parts[2]);
 236             $mime->setHTMLBody($htmlbody);
 237 //            var_dump($mime);exit;
 238             foreach($this->images as $cid=>$cdata) {
 239
 240                 $mime->addHTMLImage(
 241                     $cdata['file'],
 242                      $cdata['mimetype'],
 243                      $cid.'.'.$cdata['ext'],
 244                     true,
 245                     $cdata['contentid']
 246                 );
 247             }
 248             $isMime = true;
 249         }
 250
 251         if(!empty($this->attachments)){
 252             //if got a attachments
 253             $header = $mime->headers($parts[1]);
 254
 255             if (isset($parts[1]['Content-Type'])) {
 256                 unset($parts[1]['Content-Type']);
 257             }
 258
 259             if (!$isMime) {
 260
 261                 if(preg_match('/text\/html/', $header['Content-Type'])){
 262                     $mime->setHTMLBody($parts[2]);
 263                     $mime->setTXTBody('This message is in HTML only');
 264                 }else{
 265                     $mime->setTXTBody($parts[2]);
 266                     $mime->setHTMLBody('<PRE>'.htmlspecialchars($parts[2]).'</PRE>');
 267                 }
 268             }
 269             foreach($this->attachments as $attch){
 270                 $mime->addAttachment(
 271                         $attch['file'],
 272                         $attch['mimetype'],
 273                         (!empty($attch['name'])) ? $attch['name'] : '',
 274                         true
 275                 );
 276             }
 277
 278             $isMime = true;
 279         }
 280
 281         if($isMime){
 282             $parts[2] = $mime->get();
 283             $parts[1] = $mime->headers($parts[1]);
 284         }
 285
 286
 287         $ret = array(
 288             'recipents' => $parts[0],
 289             'headers' => $parts[1],
 290             'body' => $parts[2],
 291             'mailer' => $this
 292         );
 293         if ($this->rcpts !== false) {
 294             $ret['recipents'] =  $this->rcpts;
 295         }
 296         // if 'to' is empty, then add the recipents in there... (must be an array?
 297         if (!empty($ret['recipents']) && is_array($ret['recipents']) &&
 298                 (empty($ret['headers']['To']) || !strlen(trim($ret['headers']['To'])))) {
 299             $ret['headers']['To'] = implode(',', $ret['recipents']);
 300         }
 301
 302
 303         // add bcc if necessary..
 304         if (!empty($this->bcc)) {
 305            $ret['bcc'] = $this->bcc;
 306         }
 307         return $ret;
 308     }
 309     function send($email = false)
 310     {
 311
 312                         var_dmup('ed');exit;
 313         $ff = HTML_FlexyFramework::get();
 314
 315         $pg = $ff->page;
 316
 317         $email = is_array($email)  ? $email : $this->toData();
 318
 319         if (is_a($email, 'PEAR_Error')) {
 320             $pg->addEvent("COREMAILER-FAIL",  false, "email toData failed");
 321
 322
 323             return $email;
 324         }
 325
 326         //$this->log( htmlspecialchars(print_r($email,true)));
 327
 328         ///$recipents = array($this->email);
 329 //        $mailOptions = PEAR::getStaticProperty('Mail','options');
 330
 331         $mailOptions = isset($ff->Mail) ? $ff->Mail : array();
 332         //print_R($mailOptions);exit;
 333
 334         if ($this->mail_method == 'SMTPMX' && empty($mailOptions['mailname'])) {
 335             $pg->jerr("Mail[mailname] is not set - this is required for SMTPMX");
 336
 337         }
 338
 339         $mail = Mail::factory($this->mail_method,$mailOptions);
 340         if ($this->debug) {
 341             $mail->debug = (bool) $this->debug;
 342         }
 343
 344         $email['headers']['Date'] = date('r');
 345         if (PEAR::isError($mail)) {
 346             $pg->addEvent("COREMAILER-FAIL",  false, "mail factory failed");
 347
 348
 349             return $mail;
 350         }
 351         $rcpts = $this->rcpts == false ? $email['recipents'] : $this->rcpts;
 352
 353
 354
 355         // this makes contents untrustable...
 356         if (!empty($this->contents['bcc']) && is_array($this->contents['bcc'])) {
 357             $rcpts =array_merge(is_array($rcpts) ? $rcpts : array($rcpts), $this->contents['bcc']);
 358         }
 359
 360         $oe = error_reporting(E_ALL & ~E_NOTICE & ~E_STRICT);
 361         $ret = $mail->send($rcpts,$email['headers'],$email['body']);
 362         error_reporting($oe);
 363         if ($ret === true) {
 364             $pg->addEvent("COREMAILER-SENT",  false,
 365                 'To: ' .  ( is_array($rcpts) ? implode(', ', $rcpts) : $rcpts ) .
 366                 'Subject: '  . @$email['headers']['Subject']
 367             );
 368         }  else {
 369             $pg->addEvent("COREMAILER-FAIL",  false, $ret->toString());
 370         }
 371
 372         return $ret;
 373     }
 374
 375     function htmlbodytoCID($html)
 376     {
 377         $dom = new DOMDocument();
 378         // this may raise parse errors as some html may be a component..
 379         @$dom->loadHTML('<?xml encoding="UTF-8">' .$html);
 380         $imgs= $dom->getElementsByTagName('img');
 381
 382         foreach ($imgs as $i=>$img) {
 383             $url  = $img->getAttribute('src');
 384             if (preg_match('#^cid:#', $url)) {
 385                 continue;
 386             }
 387             $me = $img->getAttribute('mailembed');
 388             if ($me == 'no') {
 389                 continue;
 390             }
 391
 392             $conv = $this->fetchImage($url);
 393             $this->images[$conv['contentid']] = $conv;
 394
 395             $img->setAttribute('src', 'cid:' . $conv['contentid']);
 396
 397
 398         }
 399         return $dom->saveHTML();
 400
 401
 402
 403     }
 404     function htmlbodyCssEmbed($html)
 405     {
 406         $ff = HTML_FlexyFramework::get();
 407         $dom = new DOMDocument();
 408
 409         // this may raise parse errors as some html may be a component..
 410         @$dom->loadHTML('<?xml encoding="UTF-8">' .$html);
 411         $links = $dom->getElementsByTagName('link');
 412         $lc = array();
 413         foreach ($links as $link) {  // duplicate as links is dynamic and we change it..!
 414             $lc[] = $link;
 415         }
 416         //<link rel="stylesheet" type="text/css" href="{rootURL}/roojs1/css-mailer/mailer.css">
 417
 418         foreach ($lc as $i=>$link) {
 419             //var_dump($link->getAttribute('href'));
 420
 421             if ($link->getAttribute('rel') != 'stylesheet') {
 422                 continue;
 423             }
 424             $url  = $link->getAttribute('href');
 425             $file = $ff->rootDir . $url;
 426
 427             if (!preg_match('#^(http|https)://#', $url)) {
 428                 $file = $ff->rootDir . $url;
 429
 430                 if (!file_exists($file)) {
 431 //                    echo $file;
 432                     $link->setAttribute('href', 'missing:' . $file);
 433                     continue;
 434                 }
 435             } else {
 436                $file = $this->mapurl($url);
 437             }
 438
 439             $par = $link->parentNode;
 440             $par->removeChild($link);
 441             $s = $dom->createElement('style');
 442             $e = $dom->createTextNode(file_get_contents($file));
 443             $s->appendChild($e);
 444             $par->appendChild($s);
 445
 446         }
 447         return $dom->saveHTML();
 448
 449
 450     }
 451
 452
 453
 454     function fetchImage($url)
 455     {
 456
 457
 458         $this->log( "FETCH : $url\n");
 459
 460         if ($url[0] == '/') {
 461             $ff = HTML_FlexyFramework::get();
 462             $file = $ff->rootDir . $url;
 463             require_once 'File/MimeType.php';
 464             $m  = new File_MimeType();
 465             $mt = $m->fromFilename($file);
 466             $ext = $m->toExt($mt);
 467
 468             return array(
 469                     'mimetype' => $mt,
 470                    'ext' => $ext,
 471                    'contentid' => md5($file),  // mailer makes md5 cid's' -- cid with attachment-** are done by mailer.
 472                    'file' => $file
 473             );
 474
 475
 476
 477         }
 478
 479         //print_R($url); exit;
 480
 481
 482         if (preg_match('#^file:///#', $url)) {
 483             $file = preg_replace('#^file://#', '', $url);
 484             require_once 'File/MimeType.php';
 485             $m  = new File_MimeType();
 486             $mt = $m->fromFilename($file);
 487             $ext = $m->toExt($mt);
 488
 489             return array(
 490                 'mimetype'  => $mt,
 491                 'ext'       =>   $ext,
 492                 'contentid' => md5($file),
 493                 'file'      => $file
 494             );
 495
 496         }
 497
 498         // CACHE???
 499         // 2 files --- the info file.. and the actual file...
 500         // add user
 501         // unix only...
 502         $uinfo = posix_getpwuid( posix_getuid () );
 503         $user = $uinfo['name'];
 504
 505         $cache = ini_get('session.save_path')."/Pman_Core_Mailer-{$user}/" . md5($url);
 506         if ($this->cache_images &&
 507                 file_exists($cache) &&
 508                 filemtime($cache) > strtotime('NOW - 1 WEEK')
 509             ) {
 510             $ret =  json_decode(file_get_contents($cache), true);
 511             $this->log("fetched from cache");
 512             $ret['file'] = $cache . '.data';
 513             return $ret;
 514         }
 515         if (!file_exists(dirname($cache))) {
 516             mkdir(dirname($cache),0700, true);
 517         }
 518
 519         require_once 'HTTP/Request.php';
 520         $a = new HTTP_Request($this->mapurl($url));
 521         $a->sendRequest();
 522         $data = $a->getResponseBody();
 523
 524         $this->log("got file of size " . strlen($data));
 525         $this->log("save contentid " . md5($url));
 526
 527         file_put_contents($cache .'.data', $data);
 528
 529
 530         $mt = $a->getResponseHeader('Content-Type');
 531
 532         require_once 'File/MimeType.php';
 533         $m  = new File_MimeType();
 534         $ext = $m->toExt($mt);
 535
 536         $ret = array(
 537             'mimetype' => $mt,
 538             'ext' => $ext,
 539             'contentid' => md5($url)
 540
 541         );
 542
 543         file_put_contents($cache, json_encode($ret));
 544         $ret['file'] = $cache . '.data';
 545         return $ret;
 546     }
 547
 548     function mapurl($in)
 549     {
 550
 551         foreach($this->urlmap as $o=>$n) {
 552             if (strpos($in,$o) === 0) {
 553                 $ret =$n . substr($in,strlen($o));
 554                 $this->log("mapURL in $in = $ret");
 555                 return $ret;
 556             }
 557         }
 558         $this->log("mapurl no change - $in");
 559         return $in;
 560
 561
 562     }
 563
 564
 565
 566     function log($val)
 567     {
 568         if (!$this->debug) {
 569             return;
 570         }
 571         if ($this->debug < 2) {
 572             echo '<PRE>' . print_r($val,true). "\n";
 573             return;
 574         }
 575         $fh = fopen('/tmp/core_mailer.log', 'a');
 576         fwrite($fh, date('Y-m-d H:i:s -') . json_encode($val) . "\n");
 577         fclose($fh);
 578
 579
 580     }
 581
 582 }