1<?php 2/** 3 * A class to build and send multi part mails (with HTML content and embedded 4 * attachments). All mails are assumed to be in UTF-8 encoding. 5 * 6 * Attachments are handled in memory so this shouldn't be used to send huge 7 * files, but then again mail shouldn't be used to send huge files either. 8 * 9 * @author Andreas Gohr <andi@splitbrain.org> 10 */ 11use dokuwiki\Utf8\PhpString; 12use dokuwiki\Utf8\Clean; 13use dokuwiki\Extension\Event; 14 15/** 16 * Mail Handling 17 */ 18class Mailer 19{ 20 21 protected $headers = []; 22 protected $attach = []; 23 protected $html = ''; 24 protected $text = ''; 25 26 protected $boundary = ''; 27 protected $partid = ''; 28 protected $sendparam; 29 30 protected $allowhtml = true; 31 32 protected $replacements = ['text'=> [], 'html' => []]; 33 34 /** 35 * Constructor 36 * 37 * Initializes the boundary strings, part counters and token replacements 38 */ 39 public function __construct() { 40 global $conf; 41 /* @var Input $INPUT */ 42 global $INPUT; 43 44 $server = parse_url(DOKU_URL, PHP_URL_HOST); 45 if(strpos($server, '.') === false) $server .= '.localhost'; 46 47 $this->partid = substr(md5(uniqid(random_int(0, mt_getrandmax()), true)), 0, 8).'@'.$server; 48 $this->boundary = '__________'.md5(uniqid(random_int(0, mt_getrandmax()), true)); 49 50 $listid = implode('.', array_reverse(explode('/', DOKU_BASE))).$server; 51 $listid = strtolower(trim($listid, '.')); 52 53 $messageid = uniqid(random_int(0, mt_getrandmax()), true) . "@$server"; 54 55 $this->allowhtml = (bool)$conf['htmlmail']; 56 57 // add some default headers for mailfiltering FS#2247 58 if(!empty($conf['mailreturnpath'])) { 59 $this->setHeader('Return-Path', $conf['mailreturnpath']); 60 } 61 $this->setHeader('X-Mailer', 'DokuWiki'); 62 $this->setHeader('X-DokuWiki-User', $INPUT->server->str('REMOTE_USER')); 63 $this->setHeader('X-DokuWiki-Title', $conf['title']); 64 $this->setHeader('X-DokuWiki-Server', $server); 65 $this->setHeader('X-Auto-Response-Suppress', 'OOF'); 66 $this->setHeader('List-Id', $conf['title'].' <'.$listid.'>'); 67 $this->setHeader('Date', date('r'), false); 68 $this->setHeader('Message-Id', "<$messageid>"); 69 70 $this->prepareTokenReplacements(); 71 } 72 73 /** 74 * Attach a file 75 * 76 * @param string $path Path to the file to attach 77 * @param string $mime Mimetype of the attached file 78 * @param string $name The filename to use 79 * @param string $embed Unique key to reference this file from the HTML part 80 */ 81 public function attachFile($path, $mime, $name = '', $embed = '') { 82 if(!$name) { 83 $name = PhpString::basename($path); 84 } 85 86 $this->attach[] = [ 87 'data' => file_get_contents($path), 88 'mime' => $mime, 89 'name' => $name, 90 'embed' => $embed 91 ]; 92 } 93 94 /** 95 * Attach a file 96 * 97 * @param string $data The file contents to attach 98 * @param string $mime Mimetype of the attached file 99 * @param string $name The filename to use 100 * @param string $embed Unique key to reference this file from the HTML part 101 */ 102 public function attachContent($data, $mime, $name = '', $embed = '') { 103 if(!$name) { 104 [, $ext] = explode('/', $mime); 105 $name = count($this->attach).".$ext"; 106 } 107 108 $this->attach[] = [ 109 'data' => $data, 110 'mime' => $mime, 111 'name' => $name, 112 'embed' => $embed 113 ]; 114 } 115 116 /** 117 * Callback function to automatically embed images referenced in HTML templates 118 * 119 * @param array $matches 120 * @return string placeholder 121 */ 122 protected function autoEmbedCallBack($matches) { 123 static $embeds = 0; 124 $embeds++; 125 126 // get file and mime type 127 $media = cleanID($matches[1]); 128 [, $mime] = mimetype($media); 129 $file = mediaFN($media); 130 if(!file_exists($file)) return $matches[0]; //bad reference, keep as is 131 132 // attach it and set placeholder 133 $this->attachFile($file, $mime, '', 'autoembed'.$embeds); 134 return '%%autoembed'.$embeds.'%%'; 135 } 136 137 /** 138 * Add an arbitrary header to the mail 139 * 140 * If an empy value is passed, the header is removed 141 * 142 * @param string $header the header name (no trailing colon!) 143 * @param string|string[] $value the value of the header 144 * @param bool $clean remove all non-ASCII chars and line feeds? 145 */ 146 public function setHeader($header, $value, $clean = true) { 147 $header = str_replace(' ', '-', ucwords(strtolower(str_replace('-', ' ', $header)))); // streamline casing 148 if($clean) { 149 $header = preg_replace('/[^a-zA-Z0-9_ \-\.\+\@]+/', '', $header); 150 $value = preg_replace('/[^a-zA-Z0-9_ \-\.\+\@<>]+/', '', $value); 151 } 152 153 // empty value deletes 154 if(is_array($value)){ 155 $value = array_map('trim', $value); 156 $value = array_filter($value); 157 if(!$value) $value = ''; 158 }else{ 159 $value = trim($value); 160 } 161 if($value === '') { 162 if(isset($this->headers[$header])) unset($this->headers[$header]); 163 } else { 164 $this->headers[$header] = $value; 165 } 166 } 167 168 /** 169 * Set additional parameters to be passed to sendmail 170 * 171 * Whatever is set here is directly passed to PHP's mail() command as last 172 * parameter. Depending on the PHP setup this might break mailing alltogether 173 * 174 * @param string $param 175 */ 176 public function setParameters($param) { 177 $this->sendparam = $param; 178 } 179 180 /** 181 * Set the text and HTML body and apply replacements 182 * 183 * This function applies a whole bunch of default replacements in addition 184 * to the ones specified as parameters 185 * 186 * If you pass the HTML part or HTML replacements yourself you have to make 187 * sure you encode all HTML special chars correctly 188 * 189 * @param string $text plain text body 190 * @param array $textrep replacements to apply on the text part 191 * @param array $htmlrep replacements to apply on the HTML part, null to use $textrep (urls wrapped in <a> tags) 192 * @param string $html the HTML body, leave null to create it from $text 193 * @param bool $wrap wrap the HTML in the default header/Footer 194 */ 195 public function setBody($text, $textrep = null, $htmlrep = null, $html = null, $wrap = true) { 196 197 $htmlrep = (array)$htmlrep; 198 $textrep = (array)$textrep; 199 200 // create HTML from text if not given 201 if($html === null) { 202 $html = $text; 203 $html = hsc($html); 204 $html = preg_replace('/^----+$/m', '<hr >', $html); 205 $html = nl2br($html); 206 } 207 if($wrap) { 208 $wrapper = rawLocale('mailwrap', 'html'); 209 $html = preg_replace('/\n-- <br \/>.*$/s', '', $html); //strip signature 210 $html = str_replace('@EMAILSIGNATURE@', '', $html); //strip @EMAILSIGNATURE@ 211 $html = str_replace('@HTMLBODY@', $html, $wrapper); 212 } 213 214 if(strpos($text, '@EMAILSIGNATURE@') === false) { 215 $text .= '@EMAILSIGNATURE@'; 216 } 217 218 // copy over all replacements missing for HTML (autolink URLs) 219 foreach($textrep as $key => $value) { 220 if(isset($htmlrep[$key])) continue; 221 if(media_isexternal($value)) { 222 $htmlrep[$key] = '<a href="'.hsc($value).'">'.hsc($value).'</a>'; 223 } else { 224 $htmlrep[$key] = hsc($value); 225 } 226 } 227 228 // embed media from templates 229 $html = preg_replace_callback( 230 '/@MEDIA\(([^\)]+)\)@/', 231 [$this, 'autoEmbedCallBack'], $html 232 ); 233 234 // add default token replacements 235 $trep = array_merge($this->replacements['text'], $textrep); 236 $hrep = array_merge($this->replacements['html'], $htmlrep); 237 238 // Apply replacements 239 foreach($trep as $key => $substitution) { 240 $text = str_replace('@'.strtoupper($key).'@', $substitution, $text); 241 } 242 foreach($hrep as $key => $substitution) { 243 $html = str_replace('@'.strtoupper($key).'@', $substitution, $html); 244 } 245 246 $this->setHTML($html); 247 $this->setText($text); 248 } 249 250 /** 251 * Set the HTML part of the mail 252 * 253 * Placeholders can be used to reference embedded attachments 254 * 255 * You probably want to use setBody() instead 256 * 257 * @param string $html 258 */ 259 public function setHTML($html) { 260 $this->html = $html; 261 } 262 263 /** 264 * Set the plain text part of the mail 265 * 266 * You probably want to use setBody() instead 267 * 268 * @param string $text 269 */ 270 public function setText($text) { 271 $this->text = $text; 272 } 273 274 /** 275 * Add the To: recipients 276 * 277 * @see cleanAddress 278 * @param string|string[] $address Multiple adresses separated by commas or as array 279 */ 280 public function to($address) { 281 $this->setHeader('To', $address, false); 282 } 283 284 /** 285 * Add the Cc: recipients 286 * 287 * @see cleanAddress 288 * @param string|string[] $address Multiple adresses separated by commas or as array 289 */ 290 public function cc($address) { 291 $this->setHeader('Cc', $address, false); 292 } 293 294 /** 295 * Add the Bcc: recipients 296 * 297 * @see cleanAddress 298 * @param string|string[] $address Multiple adresses separated by commas or as array 299 */ 300 public function bcc($address) { 301 $this->setHeader('Bcc', $address, false); 302 } 303 304 /** 305 * Add the From: address 306 * 307 * This is set to $conf['mailfrom'] when not specified so you shouldn't need 308 * to call this function 309 * 310 * @see cleanAddress 311 * @param string $address from address 312 */ 313 public function from($address) { 314 $this->setHeader('From', $address, false); 315 } 316 317 /** 318 * Add the mail's Subject: header 319 * 320 * @param string $subject the mail subject 321 */ 322 public function subject($subject) { 323 $this->headers['Subject'] = $subject; 324 } 325 326 /** 327 * Return a clean name which can be safely used in mail address 328 * fields. That means the name will be enclosed in '"' if it includes 329 * a '"' or a ','. Also a '"' will be escaped as '\"'. 330 * 331 * @param string $name the name to clean-up 332 * @see cleanAddress 333 */ 334 public function getCleanName($name) { 335 $name = trim($name, " \t\""); 336 $name = str_replace('"', '\"', $name, $count); 337 if ($count > 0 || strpos($name, ',') !== false) { 338 $name = '"'.$name.'"'; 339 } 340 return $name; 341 } 342 343 /** 344 * Sets an email address header with correct encoding 345 * 346 * Unicode characters will be deaccented and encoded base64 347 * for headers. Addresses may not contain Non-ASCII data! 348 * 349 * If @$addresses is a string then it will be split into multiple 350 * addresses. Addresses must be separated by a comma. If the display 351 * name includes a comma then it MUST be properly enclosed by '"' to 352 * prevent spliting at the wrong point. 353 * 354 * Example: 355 * cc("föö <foo@bar.com>, me@somewhere.com","TBcc"); 356 * to("foo, Dr." <foo@bar.com>, me@somewhere.com"); 357 * 358 * @param string|string[] $addresses Multiple adresses separated by commas or as array 359 * @return false|string the prepared header (can contain multiple lines) 360 */ 361 public function cleanAddress($addresses) { 362 $headers = ''; 363 if(!is_array($addresses)){ 364 $count = preg_match_all('/\s*(?:("[^"]*"[^,]+),*)|([^,]+)\s*,*/', $addresses, $matches, PREG_SET_ORDER); 365 $addresses = []; 366 if ($count !== false && is_array($matches)) { 367 foreach ($matches as $match) { 368 $addresses[] = rtrim($match[0], ','); 369 } 370 } 371 } 372 373 foreach($addresses as $part) { 374 $part = preg_replace('/[\r\n\0]+/', ' ', $part); // remove attack vectors 375 $part = trim($part); 376 377 // parse address 378 if(preg_match('#(.*?)<(.*?)>#', $part, $matches)) { 379 $text = trim($matches[1]); 380 $addr = $matches[2]; 381 } else { 382 $text = ''; 383 $addr = $part; 384 } 385 // skip empty ones 386 if(empty($addr)) { 387 continue; 388 } 389 390 // FIXME: is there a way to encode the localpart of a emailaddress? 391 if(!Clean::isASCII($addr)) { 392 msg(hsc("E-Mail address <$addr> is not ASCII"), -1, __LINE__, __FILE__, MSG_ADMINS_ONLY); 393 continue; 394 } 395 396 if(!mail_isvalid($addr)) { 397 msg(hsc("E-Mail address <$addr> is not valid"), -1, __LINE__, __FILE__, MSG_ADMINS_ONLY); 398 continue; 399 } 400 401 // text was given 402 if(!empty($text) && !isWindows()) { // No named recipients for To: in Windows (see FS#652) 403 // add address quotes 404 $addr = "<$addr>"; 405 406 if(defined('MAILHEADER_ASCIIONLY')) { 407 $text = Clean::deaccent($text); 408 $text = Clean::strip($text); 409 } 410 411 if(strpos($text, ',') !== false || !Clean::isASCII($text)) { 412 $text = '=?UTF-8?B?'.base64_encode($text).'?='; 413 } 414 } else { 415 $text = ''; 416 } 417 418 // add to header comma seperated 419 if($headers != '') { 420 $headers .= ', '; 421 } 422 $headers .= $text.' '.$addr; 423 } 424 425 $headers = trim($headers); 426 if(empty($headers)) return false; 427 428 return $headers; 429 } 430 431 432 /** 433 * Prepare the mime multiparts for all attachments 434 * 435 * Replaces placeholders in the HTML with the correct CIDs 436 * 437 * @return string mime multiparts 438 */ 439 protected function prepareAttachments() { 440 $mime = ''; 441 $part = 1; 442 // embedded attachments 443 foreach($this->attach as $media) { 444 $media['name'] = str_replace(':', '_', cleanID($media['name'], true)); 445 446 // create content id 447 $cid = 'part'.$part.'.'.$this->partid; 448 449 // replace wildcards 450 if($media['embed']) { 451 $this->html = str_replace('%%'.$media['embed'].'%%', 'cid:'.$cid, $this->html); 452 } 453 454 $mime .= '--'.$this->boundary.MAILHEADER_EOL; 455 $mime .= $this->wrappedHeaderLine('Content-Type', $media['mime'].'; id="'.$cid.'"'); 456 $mime .= $this->wrappedHeaderLine('Content-Transfer-Encoding', 'base64'); 457 $mime .= $this->wrappedHeaderLine('Content-ID', "<$cid>"); 458 if($media['embed']) { 459 $mime .= $this->wrappedHeaderLine('Content-Disposition', 'inline; filename='.$media['name']); 460 } else { 461 $mime .= $this->wrappedHeaderLine('Content-Disposition', 'attachment; filename='.$media['name']); 462 } 463 $mime .= MAILHEADER_EOL; //end of headers 464 $mime .= chunk_split(base64_encode($media['data']), 74, MAILHEADER_EOL); 465 466 $part++; 467 } 468 return $mime; 469 } 470 471 /** 472 * Build the body and handles multi part mails 473 * 474 * Needs to be called before prepareHeaders! 475 * 476 * @return string the prepared mail body, false on errors 477 */ 478 protected function prepareBody() { 479 480 // no HTML mails allowed? remove HTML body 481 if(!$this->allowhtml) { 482 $this->html = ''; 483 } 484 485 // check for body 486 if(!$this->text && !$this->html) { 487 return false; 488 } 489 490 // add general headers 491 $this->headers['MIME-Version'] = '1.0'; 492 493 $body = ''; 494 495 if(!$this->html && !count($this->attach)) { // we can send a simple single part message 496 $this->headers['Content-Type'] = 'text/plain; charset=UTF-8'; 497 $this->headers['Content-Transfer-Encoding'] = 'base64'; 498 $body .= chunk_split(base64_encode($this->text), 72, MAILHEADER_EOL); 499 } else { // multi part it is 500 $body .= "This is a multi-part message in MIME format.".MAILHEADER_EOL; 501 502 // prepare the attachments 503 $attachments = $this->prepareAttachments(); 504 505 // do we have alternative text content? 506 if($this->text && $this->html) { 507 $this->headers['Content-Type'] = 'multipart/alternative;'.MAILHEADER_EOL. 508 ' boundary="'.$this->boundary.'XX"'; 509 $body .= '--'.$this->boundary.'XX'.MAILHEADER_EOL; 510 $body .= 'Content-Type: text/plain; charset=UTF-8'.MAILHEADER_EOL; 511 $body .= 'Content-Transfer-Encoding: base64'.MAILHEADER_EOL; 512 $body .= MAILHEADER_EOL; 513 $body .= chunk_split(base64_encode($this->text), 72, MAILHEADER_EOL); 514 $body .= '--'.$this->boundary.'XX'.MAILHEADER_EOL; 515 $body .= 'Content-Type: multipart/related;'.MAILHEADER_EOL. 516 ' boundary="'.$this->boundary.'";'.MAILHEADER_EOL. 517 ' type="text/html"'.MAILHEADER_EOL; 518 $body .= MAILHEADER_EOL; 519 } 520 521 $body .= '--'.$this->boundary.MAILHEADER_EOL; 522 $body .= 'Content-Type: text/html; charset=UTF-8'.MAILHEADER_EOL; 523 $body .= 'Content-Transfer-Encoding: base64'.MAILHEADER_EOL; 524 $body .= MAILHEADER_EOL; 525 $body .= chunk_split(base64_encode($this->html), 72, MAILHEADER_EOL); 526 $body .= MAILHEADER_EOL; 527 $body .= $attachments; 528 $body .= '--'.$this->boundary.'--'.MAILHEADER_EOL; 529 530 // close open multipart/alternative boundary 531 if($this->text && $this->html) { 532 $body .= '--'.$this->boundary.'XX--'.MAILHEADER_EOL; 533 } 534 } 535 536 return $body; 537 } 538 539 /** 540 * Cleanup and encode the headers array 541 */ 542 protected function cleanHeaders() { 543 global $conf; 544 545 // clean up addresses 546 if(empty($this->headers['From'])) $this->from($conf['mailfrom']); 547 $addrs = ['To', 'From', 'Cc', 'Bcc', 'Reply-To', 'Sender']; 548 foreach($addrs as $addr) { 549 if(isset($this->headers[$addr])) { 550 $this->headers[$addr] = $this->cleanAddress($this->headers[$addr]); 551 } 552 } 553 554 if(isset($this->headers['Subject'])) { 555 // add prefix to subject 556 if(empty($conf['mailprefix'])) { 557 if(PhpString::strlen($conf['title']) < 20) { 558 $prefix = '['.$conf['title'].']'; 559 } else { 560 $prefix = '['.PhpString::substr($conf['title'], 0, 20).'...]'; 561 } 562 } else { 563 $prefix = '['.$conf['mailprefix'].']'; 564 } 565 $len = strlen($prefix); 566 if(substr($this->headers['Subject'], 0, $len) !== $prefix) { 567 $this->headers['Subject'] = $prefix.' '.$this->headers['Subject']; 568 } 569 570 // encode subject 571 if(defined('MAILHEADER_ASCIIONLY')) { 572 $this->headers['Subject'] = Clean::deaccent($this->headers['Subject']); 573 $this->headers['Subject'] = Clean::strip($this->headers['Subject']); 574 } 575 if(!Clean::isASCII($this->headers['Subject'])) { 576 $this->headers['Subject'] = '=?UTF-8?B?'.base64_encode($this->headers['Subject']).'?='; 577 } 578 } 579 580 } 581 582 /** 583 * Returns a complete, EOL terminated header line, wraps it if necessary 584 * 585 * @param string $key 586 * @param string $val 587 * @return string line 588 */ 589 protected function wrappedHeaderLine($key, $val){ 590 return wordwrap("$key: $val", 78, MAILHEADER_EOL.' ').MAILHEADER_EOL; 591 } 592 593 /** 594 * Create a string from the headers array 595 * 596 * @returns string the headers 597 */ 598 protected function prepareHeaders() { 599 $headers = ''; 600 foreach($this->headers as $key => $val) { 601 if ($val === '' || $val === null) continue; 602 $headers .= $this->wrappedHeaderLine($key, $val); 603 } 604 return $headers; 605 } 606 607 /** 608 * return a full email with all headers 609 * 610 * This is mainly intended for debugging and testing but could also be 611 * used for MHT exports 612 * 613 * @return string the mail, false on errors 614 */ 615 public function dump() { 616 $this->cleanHeaders(); 617 $body = $this->prepareBody(); 618 if($body === false) return false; 619 $headers = $this->prepareHeaders(); 620 621 return $headers.MAILHEADER_EOL.$body; 622 } 623 624 /** 625 * Prepare default token replacement strings 626 * 627 * Populates the '$replacements' property. 628 * Should be called by the class constructor 629 */ 630 protected function prepareTokenReplacements() { 631 global $INFO; 632 global $conf; 633 /* @var Input $INPUT */ 634 global $INPUT; 635 global $lang; 636 637 $ip = clientIP(); 638 $cip = gethostsbyaddrs($ip); 639 $name = $INFO['userinfo']['name'] ?? ''; 640 $mail = $INFO['userinfo']['mail'] ?? ''; 641 642 $this->replacements['text'] = [ 643 'DATE' => dformat(), 644 'BROWSER' => $INPUT->server->str('HTTP_USER_AGENT'), 645 'IPADDRESS' => $ip, 646 'HOSTNAME' => $cip, 647 'TITLE' => $conf['title'], 648 'DOKUWIKIURL' => DOKU_URL, 649 'USER' => $INPUT->server->str('REMOTE_USER'), 650 'NAME' => $name, 651 'MAIL' => $mail 652 ]; 653 654 $signature = str_replace( 655 '@DOKUWIKIURL@', 656 $this->replacements['text']['DOKUWIKIURL'], 657 $lang['email_signature_text'] 658 ); 659 $this->replacements['text']['EMAILSIGNATURE'] = "\n-- \n" . $signature . "\n"; 660 661 $this->replacements['html'] = [ 662 'DATE' => '<i>' . hsc(dformat()) . '</i>', 663 'BROWSER' => hsc($INPUT->server->str('HTTP_USER_AGENT')), 664 'IPADDRESS' => '<code>' . hsc($ip) . '</code>', 665 'HOSTNAME' => '<code>' . hsc($cip) . '</code>', 666 'TITLE' => hsc($conf['title']), 667 'DOKUWIKIURL' => '<a href="' . DOKU_URL . '">' . DOKU_URL . '</a>', 668 'USER' => hsc($INPUT->server->str('REMOTE_USER')), 669 'NAME' => hsc($name), 670 'MAIL' => '<a href="mailto:"' . hsc($mail) . '">' . hsc($mail) . '</a>' 671 ]; 672 $signature = $lang['email_signature_text']; 673 if(!empty($lang['email_signature_html'])) { 674 $signature = $lang['email_signature_html']; 675 } 676 $signature = str_replace( 677 ['@DOKUWIKIURL@', "\n"], 678 [$this->replacements['html']['DOKUWIKIURL'], '<br />'], 679 $signature 680 ); 681 $this->replacements['html']['EMAILSIGNATURE'] = $signature; 682 } 683 684 /** 685 * Send the mail 686 * 687 * Call this after all data was set 688 * 689 * @triggers MAIL_MESSAGE_SEND 690 * @return bool true if the mail was successfully passed to the MTA 691 */ 692 public function send() { 693 global $lang; 694 $success = false; 695 696 // prepare hook data 697 $data = [ 698 // pass the whole mail class to plugin 699 'mail' => $this, 700 // pass references for backward compatibility 701 'to' => &$this->headers['To'], 702 'cc' => &$this->headers['Cc'], 703 'bcc' => &$this->headers['Bcc'], 704 'from' => &$this->headers['From'], 705 'subject' => &$this->headers['Subject'], 706 'body' => &$this->text, 707 'params' => &$this->sendparam, 708 'headers' => '', // plugins shouldn't use this 709 // signal if we mailed successfully to AFTER event 710 'success' => &$success, 711 ]; 712 713 // do our thing if BEFORE hook approves 714 $evt = new Event('MAIL_MESSAGE_SEND', $data); 715 if($evt->advise_before(true)) { 716 // clean up before using the headers 717 $this->cleanHeaders(); 718 719 // any recipients? 720 if(trim($this->headers['To']) === '' && 721 trim($this->headers['Cc']) === '' && 722 trim($this->headers['Bcc']) === '' 723 ) return false; 724 725 // The To: header is special 726 if(array_key_exists('To', $this->headers)) { 727 $to = (string)$this->headers['To']; 728 unset($this->headers['To']); 729 } else { 730 $to = ''; 731 } 732 733 // so is the subject 734 if(array_key_exists('Subject', $this->headers)) { 735 $subject = (string)$this->headers['Subject']; 736 unset($this->headers['Subject']); 737 } else { 738 $subject = ''; 739 } 740 741 // make the body 742 $body = $this->prepareBody(); 743 if($body === false) return false; 744 745 // cook the headers 746 $headers = $this->prepareHeaders(); 747 // add any headers set by legacy plugins 748 if(trim($data['headers'])) { 749 $headers .= MAILHEADER_EOL.trim($data['headers']); 750 } 751 752 if(!function_exists('mail')){ 753 $emsg = $lang['email_fail'] . $subject; 754 error_log($emsg); 755 msg(hsc($emsg), -1, __LINE__, __FILE__, MSG_MANAGERS_ONLY); 756 $evt->advise_after(); 757 return false; 758 } 759 760 // send the thing 761 if($to === '') $to = '(undisclosed-recipients)'; // #1422 762 if($this->sendparam === null) { 763 $success = @mail($to, $subject, $body, $headers); 764 } else { 765 $success = @mail($to, $subject, $body, $headers, $this->sendparam); 766 } 767 } 768 // any AFTER actions? 769 $evt->advise_after(); 770 return $success; 771 } 772} 773