| [ Index ] |
PHP Cross Reference of Wordpress 2.9.1 |
[Summary view] [Print] [Text view]
1 <?php 2 /*~ class.phpmailer.php 3 .---------------------------------------------------------------------------. 4 | Software: PHPMailer - PHP email class | 5 | Version: 2.0.4 | 6 | Contact: via sourceforge.net support pages (also www.codeworxtech.com) | 7 | Info: http://phpmailer.sourceforge.net | 8 | Support: http://sourceforge.net/projects/phpmailer/ | 9 | ------------------------------------------------------------------------- | 10 | Author: Andy Prevost (project admininistrator) | 11 | Author: Brent R. Matzelle (original founder) | 12 | Copyright (c) 2004-2007, Andy Prevost. All Rights Reserved. | 13 | Copyright (c) 2001-2003, Brent R. Matzelle | 14 | ------------------------------------------------------------------------- | 15 | License: Distributed under the Lesser General Public License (LGPL) | 16 | http://www.gnu.org/copyleft/lesser.html | 17 | This program is distributed in the hope that it will be useful - WITHOUT | 18 | ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or | 19 | FITNESS FOR A PARTICULAR PURPOSE. | 20 | ------------------------------------------------------------------------- | 21 | We offer a number of paid services (www.codeworxtech.com): | 22 | - Web Hosting on highly optimized fast and secure servers | 23 | - Technology Consulting | 24 | - Oursourcing (highly qualified programmers and graphic designers) | 25 '---------------------------------------------------------------------------' 26 */ 27 /** 28 * PHPMailer - PHP email transport class 29 * @package PHPMailer 30 * @author Andy Prevost 31 * @copyright 2004 - 2009 Andy Prevost 32 */ 33 34 class PHPMailer { 35 36 ///////////////////////////////////////////////// 37 // PROPERTIES, PUBLIC 38 ///////////////////////////////////////////////// 39 40 /** 41 * Email priority (1 = High, 3 = Normal, 5 = low). 42 * @var int 43 */ 44 var $Priority = 3; 45 46 /** 47 * Sets the CharSet of the message. 48 * @var string 49 */ 50 var $CharSet = 'iso-8859-1'; 51 52 /** 53 * Sets the Content-type of the message. 54 * @var string 55 */ 56 var $ContentType = 'text/plain'; 57 58 /** 59 * Sets the Encoding of the message. Options for this are "8bit", 60 * "7bit", "binary", "base64", and "quoted-printable". 61 * @var string 62 */ 63 var $Encoding = '8bit'; 64 65 /** 66 * Holds the most recent mailer error message. 67 * @var string 68 */ 69 var $ErrorInfo = ''; 70 71 /** 72 * Sets the From email address for the message. 73 * @var string 74 */ 75 var $From = 'root@localhost'; 76 77 /** 78 * Sets the From name of the message. 79 * @var string 80 */ 81 var $FromName = 'Root User'; 82 83 /** 84 * Sets the Sender email (Return-Path) of the message. If not empty, 85 * will be sent via -f to sendmail or as 'MAIL FROM' in smtp mode. 86 * @var string 87 */ 88 var $Sender = ''; 89 90 /** 91 * Sets the Subject of the message. 92 * @var string 93 */ 94 var $Subject = ''; 95 96 /** 97 * Sets the Body of the message. This can be either an HTML or text body. 98 * If HTML then run IsHTML(true). 99 * @var string 100 */ 101 var $Body = ''; 102 103 /** 104 * Sets the text-only body of the message. This automatically sets the 105 * email to multipart/alternative. This body can be read by mail 106 * clients that do not have HTML email capability such as mutt. Clients 107 * that can read HTML will view the normal Body. 108 * @var string 109 */ 110 var $AltBody = ''; 111 112 /** 113 * Sets word wrapping on the body of the message to a given number of 114 * characters. 115 * @var int 116 */ 117 var $WordWrap = 0; 118 119 /** 120 * Method to send mail: ("mail", "sendmail", or "smtp"). 121 * @var string 122 */ 123 var $Mailer = 'mail'; 124 125 /** 126 * Sets the path of the sendmail program. 127 * @var string 128 */ 129 var $Sendmail = '/usr/sbin/sendmail'; 130 131 /** 132 * Path to PHPMailer plugins. This is now only useful if the SMTP class 133 * is in a different directory than the PHP include path. 134 * @var string 135 */ 136 var $PluginDir = ''; 137 138 /** 139 * Holds PHPMailer version. 140 * @var string 141 */ 142 var $Version = "2.0.4"; 143 144 /** 145 * Sets the email address that a reading confirmation will be sent. 146 * @var string 147 */ 148 var $ConfirmReadingTo = ''; 149 150 /** 151 * Sets the hostname to use in Message-Id and Received headers 152 * and as default HELO string. If empty, the value returned 153 * by SERVER_NAME is used or 'localhost.localdomain'. 154 * @var string 155 */ 156 var $Hostname = ''; 157 158 /** 159 * Sets the message ID to be used in the Message-Id header. 160 * If empty, a unique id will be generated. 161 * @var string 162 */ 163 var $MessageID = ''; 164 165 ///////////////////////////////////////////////// 166 // PROPERTIES FOR SMTP 167 ///////////////////////////////////////////////// 168 169 /** 170 * Sets the SMTP hosts. All hosts must be separated by a 171 * semicolon. You can also specify a different port 172 * for each host by using this format: [hostname:port] 173 * (e.g. "smtp1.example.com:25;smtp2.example.com"). 174 * Hosts will be tried in order. 175 * @var string 176 */ 177 var $Host = 'localhost'; 178 179 /** 180 * Sets the default SMTP server port. 181 * @var int 182 */ 183 var $Port = 25; 184 185 /** 186 * Sets the SMTP HELO of the message (Default is $Hostname). 187 * @var string 188 */ 189 var $Helo = ''; 190 191 /** 192 * Sets connection prefix. 193 * Options are "", "ssl" or "tls" 194 * @var string 195 */ 196 var $SMTPSecure = ""; 197 198 /** 199 * Sets SMTP authentication. Utilizes the Username and Password variables. 200 * @var bool 201 */ 202 var $SMTPAuth = false; 203 204 /** 205 * Sets SMTP username. 206 * @var string 207 */ 208 var $Username = ''; 209 210 /** 211 * Sets SMTP password. 212 * @var string 213 */ 214 var $Password = ''; 215 216 /** 217 * Sets the SMTP server timeout in seconds. This function will not 218 * work with the win32 version. 219 * @var int 220 */ 221 var $Timeout = 10; 222 223 /** 224 * Sets SMTP class debugging on or off. 225 * @var bool 226 */ 227 var $SMTPDebug = false; 228 229 /** 230 * Prevents the SMTP connection from being closed after each mail 231 * sending. If this is set to true then to close the connection 232 * requires an explicit call to SmtpClose(). 233 * @var bool 234 */ 235 var $SMTPKeepAlive = false; 236 237 /** 238 * Provides the ability to have the TO field process individual 239 * emails, instead of sending to entire TO addresses 240 * @var bool 241 */ 242 var $SingleTo = false; 243 244 ///////////////////////////////////////////////// 245 // PROPERTIES, PRIVATE 246 ///////////////////////////////////////////////// 247 248 var $smtp = NULL; 249 var $to = array(); 250 var $cc = array(); 251 var $bcc = array(); 252 var $ReplyTo = array(); 253 var $attachment = array(); 254 var $CustomHeader = array(); 255 var $message_type = ''; 256 var $boundary = array(); 257 var $language = array(); 258 var $error_count = 0; 259 var $LE = "\n"; 260 var $sign_cert_file = ""; 261 var $sign_key_file = ""; 262 var $sign_key_pass = ""; 263 264 ///////////////////////////////////////////////// 265 // METHODS, VARIABLES 266 ///////////////////////////////////////////////// 267 268 /** 269 * Sets message type to HTML. 270 * @param bool $bool 271 * @return void 272 */ 273 function IsHTML($bool) { 274 if($bool == true) { 275 $this->ContentType = 'text/html'; 276 } else { 277 $this->ContentType = 'text/plain'; 278 } 279 } 280 281 /** 282 * Sets Mailer to send message using SMTP. 283 * @return void 284 */ 285 function IsSMTP() { 286 $this->Mailer = 'smtp'; 287 } 288 289 /** 290 * Sets Mailer to send message using PHP mail() function. 291 * @return void 292 */ 293 function IsMail() { 294 $this->Mailer = 'mail'; 295 } 296 297 /** 298 * Sets Mailer to send message using the $Sendmail program. 299 * @return void 300 */ 301 function IsSendmail() { 302 $this->Mailer = 'sendmail'; 303 } 304 305 /** 306 * Sets Mailer to send message using the qmail MTA. 307 * @return void 308 */ 309 function IsQmail() { 310 $this->Sendmail = '/var/qmail/bin/sendmail'; 311 $this->Mailer = 'sendmail'; 312 } 313 314 ///////////////////////////////////////////////// 315 // METHODS, RECIPIENTS 316 ///////////////////////////////////////////////// 317 318 /** 319 * Adds a "To" address. 320 * @param string $address 321 * @param string $name 322 * @return void 323 */ 324 function AddAddress($address, $name = '') { 325 $cur = count($this->to); 326 $this->to[$cur][0] = trim($address); 327 $this->to[$cur][1] = $name; 328 } 329 330 /** 331 * Adds a "Cc" address. Note: this function works 332 * with the SMTP mailer on win32, not with the "mail" 333 * mailer. 334 * @param string $address 335 * @param string $name 336 * @return void 337 */ 338 function AddCC($address, $name = '') { 339 $cur = count($this->cc); 340 $this->cc[$cur][0] = trim($address); 341 $this->cc[$cur][1] = $name; 342 } 343 344 /** 345 * Adds a "Bcc" address. Note: this function works 346 * with the SMTP mailer on win32, not with the "mail" 347 * mailer. 348 * @param string $address 349 * @param string $name 350 * @return void 351 */ 352 function AddBCC($address, $name = '') { 353 $cur = count($this->bcc); 354 $this->bcc[$cur][0] = trim($address); 355 $this->bcc[$cur][1] = $name; 356 } 357 358 /** 359 * Adds a "Reply-To" address. 360 * @param string $address 361 * @param string $name 362 * @return void 363 */ 364 function AddReplyTo($address, $name = '') { 365 $cur = count($this->ReplyTo); 366 $this->ReplyTo[$cur][0] = trim($address); 367 $this->ReplyTo[$cur][1] = $name; 368 } 369 370 ///////////////////////////////////////////////// 371 // METHODS, MAIL SENDING 372 ///////////////////////////////////////////////// 373 374 /** 375 * Creates message and assigns Mailer. If the message is 376 * not sent successfully then it returns false. Use the ErrorInfo 377 * variable to view description of the error. 378 * @return bool 379 */ 380 function Send() { 381 $header = ''; 382 $body = ''; 383 $result = true; 384 385 if((count($this->to) + count($this->cc) + count($this->bcc)) < 1) { 386 $this->SetError($this->Lang('provide_address')); 387 return false; 388 } 389 390 /* Set whether the message is multipart/alternative */ 391 if(!empty($this->AltBody)) { 392 $this->ContentType = 'multipart/alternative'; 393 } 394 395 $this->error_count = 0; // reset errors 396 $this->SetMessageType(); 397 $header .= $this->CreateHeader(); 398 $body = $this->CreateBody(); 399 400 if($body == '') { 401 return false; 402 } 403 404 /* Choose the mailer */ 405 switch($this->Mailer) { 406 case 'sendmail': 407 $result = $this->SendmailSend($header, $body); 408 break; 409 case 'smtp': 410 $result = $this->SmtpSend($header, $body); 411 break; 412 case 'mail': 413 $result = $this->MailSend($header, $body); 414 break; 415 default: 416 $result = $this->MailSend($header, $body); 417 break; 418 //$this->SetError($this->Mailer . $this->Lang('mailer_not_supported')); 419 //$result = false; 420 //break; 421 } 422 423 return $result; 424 } 425 426 /** 427 * Sends mail using the $Sendmail program. 428 * @access private 429 * @return bool 430 */ 431 function SendmailSend($header, $body) { 432 if ($this->Sender != '') { 433 $sendmail = sprintf("%s -oi -f %s -t", escapeshellcmd($this->Sendmail), escapeshellarg($this->Sender)); 434 } else { 435 $sendmail = sprintf("%s -oi -t", escapeshellcmd($this->Sendmail)); 436 } 437 438 if(!@$mail = popen($sendmail, 'w')) { 439 $this->SetError($this->Lang('execute') . $this->Sendmail); 440 return false; 441 } 442 443 fputs($mail, $header); 444 fputs($mail, $body); 445 446 $result = pclose($mail); 447 if (version_compare(phpversion(), '4.2.3') == -1) { 448 $result = $result >> 8 & 0xFF; 449 } 450 if($result != 0) { 451 $this->SetError($this->Lang('execute') . $this->Sendmail); 452 return false; 453 } 454 return true; 455 } 456 457 /** 458 * Sends mail using the PHP mail() function. 459 * @access private 460 * @return bool 461 */ 462 function MailSend($header, $body) { 463 464 $to = ''; 465 for($i = 0; $i < count($this->to); $i++) { 466 if($i != 0) { $to .= ', '; } 467 $to .= $this->AddrFormat($this->to[$i]); 468 } 469 470 $toArr = split(',', $to); 471 472 $params = sprintf("-oi -f %s", $this->Sender); 473 if ($this->Sender != '' && strlen(ini_get('safe_mode')) < 1) { 474 $old_from = ini_get('sendmail_from'); 475 ini_set('sendmail_from', $this->Sender); 476 if ($this->SingleTo === true && count($toArr) > 1) { 477 foreach ($toArr as $key => $val) { 478 $rt = @mail($val, $this->EncodeHeader($this->SecureHeader($this->Subject)), $body, $header, $params); 479 } 480 } else { 481 $rt = @mail($to, $this->EncodeHeader($this->SecureHeader($this->Subject)), $body, $header, $params); 482 } 483 } else { 484 if ($this->SingleTo === true && count($toArr) > 1) { 485 foreach ($toArr as $key => $val) { 486 $rt = @mail($val, $this->EncodeHeader($this->SecureHeader($this->Subject)), $body, $header, $params); 487 } 488 } else { 489 $rt = @mail($to, $this->EncodeHeader($this->SecureHeader($this->Subject)), $body, $header); 490 } 491 } 492 493 if (isset($old_from)) { 494 ini_set('sendmail_from', $old_from); 495 } 496 497 if(!$rt) { 498 $this->SetError($this->Lang('instantiate')); 499 return false; 500 } 501 502 return true; 503 } 504 505 /** 506 * Sends mail via SMTP using PhpSMTP (Author: 507 * Chris Ryan). Returns bool. Returns false if there is a 508 * bad MAIL FROM, RCPT, or DATA input. 509 * @access private 510 * @return bool 511 */ 512 function SmtpSend($header, $body) { 513 include_once($this->PluginDir . 'class-smtp.php'); 514 $error = ''; 515 $bad_rcpt = array(); 516 517 if(!$this->SmtpConnect()) { 518 return false; 519 } 520 521 $smtp_from = ($this->Sender == '') ? $this->From : $this->Sender; 522 if(!$this->smtp->Mail($smtp_from)) { 523 $error = $this->Lang('from_failed') . $smtp_from; 524 $this->SetError($error); 525 $this->smtp->Reset(); 526 return false; 527 } 528 529 /* Attempt to send attach all recipients */ 530 for($i = 0; $i < count($this->to); $i++) { 531 if(!$this->smtp->Recipient($this->to[$i][0])) { 532 $bad_rcpt[] = $this->to[$i][0]; 533 } 534 } 535 for($i = 0; $i < count($this->cc); $i++) { 536 if(!$this->smtp->Recipient($this->cc[$i][0])) { 537 $bad_rcpt[] = $this->cc[$i][0]; 538 } 539 } 540 for($i = 0; $i < count($this->bcc); $i++) { 541 if(!$this->smtp->Recipient($this->bcc[$i][0])) { 542 $bad_rcpt[] = $this->bcc[$i][0]; 543 } 544 } 545 546 if(count($bad_rcpt) > 0) { // Create error message 547 for($i = 0; $i < count($bad_rcpt); $i++) { 548 if($i != 0) { 549 $error .= ', '; 550 } 551 $error .= $bad_rcpt[$i]; 552 } 553 $error = $this->Lang('recipients_failed') . $error; 554 $this->SetError($error); 555 $this->smtp->Reset(); 556 return false; 557 } 558 559 if(!$this->smtp->Data($header . $body)) { 560 $this->SetError($this->Lang('data_not_accepted')); 561 $this->smtp->Reset(); 562 return false; 563 } 564 if($this->SMTPKeepAlive == true) { 565 $this->smtp->Reset(); 566 } else { 567 $this->SmtpClose(); 568 } 569 570 return true; 571 } 572 573 /** 574 * Initiates a connection to an SMTP server. Returns false if the 575 * operation failed. 576 * @access private 577 * @return bool 578 */ 579 function SmtpConnect() { 580 if($this->smtp == NULL) { 581 $this->smtp = new SMTP(); 582 } 583 584 $this->smtp->do_debug = $this->SMTPDebug; 585 $hosts = explode(';', $this->Host); 586 $index = 0; 587 $connection = ($this->smtp->Connected()); 588 589 /* Retry while there is no connection */ 590 while($index < count($hosts) && $connection == false) { 591 $hostinfo = array(); 592 if(eregi('^(.+):([0-9]+)$', $hosts[$index], $hostinfo)) { 593 $host = $hostinfo[1]; 594 $port = $hostinfo[2]; 595 } else { 596 $host = $hosts[$index]; 597 $port = $this->Port; 598 } 599 600 if($this->smtp->Connect(((!empty($this->SMTPSecure))?$this->SMTPSecure.'://':'').$host, $port, $this->Timeout)) { 601 if ($this->Helo != '') { 602 $this->smtp->Hello($this->Helo); 603 } else { 604 $this->smtp->Hello($this->ServerHostname()); 605 } 606 607 $connection = true; 608 if($this->SMTPAuth) { 609 if(!$this->smtp->Authenticate($this->Username, $this->Password)) { 610 $this->SetError($this->Lang('authenticate')); 611 $this->smtp->Reset(); 612 $connection = false; 613 } 614 } 615 } 616 $index++; 617 } 618 if(!$connection) { 619 $this->SetError($this->Lang('connect_host')); 620 } 621 622 return $connection; 623 } 624 625 /** 626 * Closes the active SMTP session if one exists. 627 * @return void 628 */ 629 function SmtpClose() { 630 if($this->smtp != NULL) { 631 if($this->smtp->Connected()) { 632 $this->smtp->Quit(); 633 $this->smtp->Close(); 634 } 635 } 636 } 637 638 /** 639 * Sets the language for all class error messages. Returns false 640 * if it cannot load the language file. The default language type 641 * is English. 642 * @param string $lang_type Type of language (e.g. Portuguese: "br") 643 * @param string $lang_path Path to the language file directory 644 * @access public 645 * @return bool 646 */ 647 function SetLanguage($lang_type, $lang_path = 'language/') { 648 if(file_exists($lang_path.'phpmailer.lang-'.$lang_type.'.php')) { 649 include($lang_path.'phpmailer.lang-'.$lang_type.'.php'); 650 } elseif (file_exists($lang_path.'phpmailer.lang-en.php')) { 651 include($lang_path.'phpmailer.lang-en.php'); 652 } else { 653 $PHPMAILER_LANG = array(); 654 $PHPMAILER_LANG["provide_address"] = 'You must provide at least one ' . 655 $PHPMAILER_LANG["mailer_not_supported"] = ' mailer is not supported.'; 656 $PHPMAILER_LANG["execute"] = 'Could not execute: '; 657 $PHPMAILER_LANG["instantiate"] = 'Could not instantiate mail function.'; 658 $PHPMAILER_LANG["authenticate"] = 'SMTP Error: Could not authenticate.'; 659 $PHPMAILER_LANG["from_failed"] = 'The following From address failed: '; 660 $PHPMAILER_LANG["recipients_failed"] = 'SMTP Error: The following ' . 661 $PHPMAILER_LANG["data_not_accepted"] = 'SMTP Error: Data not accepted.'; 662 $PHPMAILER_LANG["connect_host"] = 'SMTP Error: Could not connect to SMTP host.'; 663 $PHPMAILER_LANG["file_access"] = 'Could not access file: '; 664 $PHPMAILER_LANG["file_open"] = 'File Error: Could not open file: '; 665 $PHPMAILER_LANG["encoding"] = 'Unknown encoding: '; 666 $PHPMAILER_LANG["signing"] = 'Signing Error: '; 667 } 668 $this->language = $PHPMAILER_LANG; 669 670 return true; 671 } 672 673 ///////////////////////////////////////////////// 674 // METHODS, MESSAGE CREATION 675 ///////////////////////////////////////////////// 676 677 /** 678 * Creates recipient headers. 679 * @access private 680 * @return string 681 */ 682 function AddrAppend($type, $addr) { 683 $addr_str = $type . ': '; 684 $addr_str .= $this->AddrFormat($addr[0]); 685 if(count($addr) > 1) { 686 for($i = 1; $i < count($addr); $i++) { 687 $addr_str .= ', ' . $this->AddrFormat($addr[$i]); 688 } 689 } 690 $addr_str .= $this->LE; 691 692 return $addr_str; 693 } 694 695 /** 696 * Formats an address correctly. 697 * @access private 698 * @return string 699 */ 700 function AddrFormat($addr) { 701 if(empty($addr[1])) { 702 $formatted = $this->SecureHeader($addr[0]); 703 } else { 704 $formatted = $this->EncodeHeader($this->SecureHeader($addr[1]), 'phrase') . " <" . $this->SecureHeader($addr[0]) . ">"; 705 } 706 707 return $formatted; 708 } 709 710 /** 711 * Wraps message for use with mailers that do not 712 * automatically perform wrapping and for quoted-printable. 713 * Original written by philippe. 714 * @access private 715 * @return string 716 */ 717 function WrapText($message, $length, $qp_mode = false) { 718 $soft_break = ($qp_mode) ? sprintf(" =%s", $this->LE) : $this->LE; 719 // If utf-8 encoding is used, we will need to make sure we don't 720 // split multibyte characters when we wrap 721 $is_utf8 = (strtolower($this->CharSet) == "utf-8"); 722 723 $message = $this->FixEOL($message); 724 if (substr($message, -1) == $this->LE) { 725 $message = substr($message, 0, -1); 726 } 727 728 $line = explode($this->LE, $message); 729 $message = ''; 730 for ($i=0 ;$i < count($line); $i++) { 731 $line_part = explode(' ', $line[$i]); 732 $buf = ''; 733 for ($e = 0; $e<count($line_part); $e++) { 734 $word = $line_part[$e]; 735 if ($qp_mode and (strlen($word) > $length)) { 736 $space_left = $length - strlen($buf) - 1; 737 if ($e != 0) { 738 if ($space_left > 20) { 739 $len = $space_left; 740 if ($is_utf8) { 741 $len = $this->UTF8CharBoundary($word, $len); 742 } elseif (substr($word, $len - 1, 1) == "=") { 743 $len--; 744 } elseif (substr($word, $len - 2, 1) == "=") { 745 $len -= 2; 746 } 747 $part = substr($word, 0, $len); 748 $word = substr($word, $len); 749 $buf .= ' ' . $part; 750 $message .= $buf . sprintf("=%s", $this->LE); 751 } else { 752 $message .= $buf . $soft_break; 753 } 754 $buf = ''; 755 } 756 while (strlen($word) > 0) { 757 $len = $length; 758 if ($is_utf8) { 759 $len = $this->UTF8CharBoundary($word, $len); 760 } elseif (substr($word, $len - 1, 1) == "=") { 761 $len--; 762 } elseif (substr($word, $len - 2, 1) == "=") { 763 $len -= 2; 764 } 765 $part = substr($word, 0, $len); 766 $word = substr($word, $len); 767 768 if (strlen($word) > 0) { 769 $message .= $part . sprintf("=%s", $this->LE); 770 } else { 771 $buf = $part; 772 } 773 } 774 } else { 775 $buf_o = $buf; 776 $buf .= ($e == 0) ? $word : (' ' . $word); 777 778 if (strlen($buf) > $length and $buf_o != '') { 779 $message .= $buf_o . $soft_break; 780 $buf = $word; 781 } 782 } 783 } 784 $message .= $buf . $this->LE; 785 } 786 787 return $message; 788 } 789 790 /** 791 * Finds last character boundary prior to maxLength in a utf-8 792 * quoted (printable) encoded string. 793 * Original written by Colin Brown. 794 * @access private 795 * @param string $encodedText utf-8 QP text 796 * @param int $maxLength find last character boundary prior to this length 797 * @return int 798 */ 799 function UTF8CharBoundary($encodedText, $maxLength) { 800 $foundSplitPos = false; 801 $lookBack = 3; 802 while (!$foundSplitPos) { 803 $lastChunk = substr($encodedText, $maxLength - $lookBack, $lookBack); 804 $encodedCharPos = strpos($lastChunk, "="); 805 if ($encodedCharPos !== false) { 806 // Found start of encoded character byte within $lookBack block. 807 // Check the encoded byte value (the 2 chars after the '=') 808 $hex = substr($encodedText, $maxLength - $lookBack + $encodedCharPos + 1, 2); 809 $dec = hexdec($hex); 810 if ($dec < 128) { // Single byte character. 811 // If the encoded char was found at pos 0, it will fit 812 // otherwise reduce maxLength to start of the encoded char 813 $maxLength = ($encodedCharPos == 0) ? $maxLength : 814 $maxLength - ($lookBack - $encodedCharPos); 815 $foundSplitPos = true; 816 } elseif ($dec >= 192) { // First byte of a multi byte character 817 // Reduce maxLength to split at start of character 818 $maxLength = $maxLength - ($lookBack - $encodedCharPos); 819 $foundSplitPos = true; 820 } elseif ($dec < 192) { // Middle byte of a multi byte character, look further back 821 $lookBack += 3; 822 } 823 } else { 824 // No encoded character found 825 $foundSplitPos = true; 826 } 827 } 828 return $maxLength; 829 } 830 831 /** 832 * Set the body wrapping. 833 * @access private 834 * @return void 835 */ 836 function SetWordWrap() { 837 if($this->WordWrap < 1) { 838 return; 839 } 840 841 switch($this->message_type) { 842 case 'alt': 843 /* fall through */ 844 case 'alt_attachments': 845 $this->AltBody = $this->WrapText($this->AltBody, $this->WordWrap); 846 break; 847 default: 848 $this->Body = $this->WrapText($this->Body, $this->WordWrap); 849 break; 850 } 851 } 852 853 /** 854 * Assembles message header. 855 * @access private 856 * @return string 857 */ 858 function CreateHeader() { 859 $result = ''; 860 861 /* Set the boundaries */ 862 $uniq_id = md5(uniqid(time())); 863 $this->boundary[1] = 'b1_' . $uniq_id; 864 $this->boundary[2] = 'b2_' . $uniq_id; 865 866 $result .= $this->HeaderLine('Date', $this->RFCDate()); 867 if($this->Sender == '') { 868 $result .= $this->HeaderLine('Return-Path', trim($this->From)); 869 } else { 870 $result .= $this->HeaderLine('Return-Path', trim($this->Sender)); 871 } 872 873 /* To be created automatically by mail() */ 874 if($this->Mailer != 'mail') { 875 if(count($this->to) > 0) { 876 $result .= $this->AddrAppend('To', $this->to); 877 } elseif (count($this->cc) == 0) { 878 $result .= $this->HeaderLine('To', 'undisclosed-recipients:;'); 879 } 880 } 881 882 $from = array(); 883 $from[0][0] = trim($this->From); 884 $from[0][1] = $this->FromName; 885 $result .= $this->AddrAppend('From', $from); 886 887 /* sendmail and mail() extract Cc from the header before sending */ 888 if((($this->Mailer == 'sendmail') || ($this->Mailer == 'mail')) && (count($this->cc) > 0)) { 889 $result .= $this->AddrAppend('Cc', $this->cc); 890 } 891 892 /* sendmail and mail() extract Bcc from the header before sending */ 893 if((($this->Mailer == 'sendmail') || ($this->Mailer == 'mail')) && (count($this->bcc) > 0)) { 894 $result .= $this->AddrAppend('Bcc', $this->bcc); 895 } 896 897 if(count($this->ReplyTo) > 0) { 898 $result .= $this->AddrAppend('Reply-To', $this->ReplyTo); 899 } 900 901 /* mail() sets the subject itself */ 902 if($this->Mailer != 'mail') { 903 $result .= $this->HeaderLine('Subject', $this->EncodeHeader($this->SecureHeader($this->Subject))); 904 } 905 906 if($this->MessageID != '') { 907 $result .= $this->HeaderLine('Message-ID',$this->MessageID); 908 } else { 909 $result .= sprintf("Message-ID: <%s@%s>%s", $uniq_id, $this->ServerHostname(), $this->LE); 910 } 911 $result .= $this->HeaderLine('X-Priority', $this->Priority); 912 $result .= $this->HeaderLine('X-Mailer', 'PHPMailer (phpmailer.sourceforge.net) [version ' . $this->Version . ']'); 913 914 if($this->ConfirmReadingTo != '') { 915 $result .= $this->HeaderLine('Disposition-Notification-To', '<' . trim($this->ConfirmReadingTo) . '>'); 916 } 917 918 // Add custom headers 919 for($index = 0; $index < count($this->CustomHeader); $index++) { 920 $result .= $this->HeaderLine(trim($this->CustomHeader[$index][0]), $this->EncodeHeader(trim($this->CustomHeader[$index][1]))); 921 } 922 if (!$this->sign_key_file) { 923 $result .= $this->HeaderLine('MIME-Version', '1.0'); 924 $result .= $this->GetMailMIME(); 925 } 926 927 return $result; 928 } 929 930 /** 931 * Returns the message MIME. 932 * @access private 933 * @return string 934 */ 935 function GetMailMIME() { 936 $result = ''; 937 switch($this->message_type) { 938 case 'plain': 939 $result .= $this->HeaderLine('Content-Transfer-Encoding', $this->Encoding); 940 $result .= sprintf("Content-Type: %s; charset=\"%s\"", $this->ContentType, $this->CharSet); 941 break; 942 case 'attachments': 943 /* fall through */ 944 case 'alt_attachments': 945 if($this->InlineImageExists()){ 946 $result .= sprintf("Content-Type: %s;%s\ttype=\"text/html\";%s\tboundary=\"%s\"%s", 'multipart/related', $this->LE, $this->LE, $this->boundary[1], $this->LE); 947 } else { 948 $result .= $this->HeaderLine('Content-Type', 'multipart/mixed;'); 949 $result .= $this->TextLine("\tboundary=\"" . $this->boundary[1] . '"'); 950 } 951 break; 952 case 'alt': 953 $result .= $this->HeaderLine('Content-Type', 'multipart/alternative;'); 954 $result .= $this->TextLine("\tboundary=\"" . $this->boundary[1] . '"'); 955 break; 956 } 957 958 if($this->Mailer != 'mail') { 959 $result .= $this->LE.$this->LE; 960 } 961 962 return $result; 963 } 964 965 /** 966 * Assembles the message body. Returns an empty string on failure. 967 * @access private 968 * @return string 969 */ 970 function CreateBody() { 971 $result = ''; 972 if ($this->sign_key_file) { 973 $result .= $this->GetMailMIME(); 974 } 975 976 $this->SetWordWrap(); 977 978 switch($this->message_type) { 979 case 'alt': 980 $result .= $this->GetBoundary($this->boundary[1], '', 'text/plain', ''); 981 $result .= $this->EncodeString($this->AltBody, $this->Encoding); 982 $result .= $this->LE.$this->LE; 983 $result .= $this->GetBoundary($this->boundary[1], '', 'text/html', ''); 984 $result .= $this->EncodeString($this->Body, $this->Encoding); 985 $result .= $this->LE.$this->LE; 986 $result .= $this->EndBoundary($this->boundary[1]); 987 break; 988 case 'plain': 989 $result .= $this->EncodeString($this->Body, $this->Encoding); 990 break; 991 case 'attachments': 992 $result .= $this->GetBoundary($this->boundary[1], '', '', ''); 993 $result .= $this->EncodeString($this->Body, $this->Encoding); 994 $result .= $this->LE; 995 $result .= $this->AttachAll(); 996 break; 997 case 'alt_attachments': 998 $result .= sprintf("--%s%s", $this->boundary[1], $this->LE); 999 $result .= sprintf("Content-Type: %s;%s" . "\tboundary=\"%s\"%s", 'multipart/alternative', $this->LE, $this->boundary[2], $this->LE.$this->LE); 1000 $result .= $this->GetBoundary($this->boundary[2], '', 'text/plain', '') . $this->LE; // Create text body 1001 $result .= $this->EncodeString($this->AltBody, $this->Encoding); 1002 $result .= $this->LE.$this->LE; 1003 $result .= $this->GetBoundary($this->boundary[2], '', 'text/html', '') . $this->LE; // Create the HTML body 1004 $result .= $this->EncodeString($this->Body, $this->Encoding); 1005 $result .= $this->LE.$this->LE; 1006 $result .= $this->EndBoundary($this->boundary[2]); 1007 $result .= $this->AttachAll(); 1008 break; 1009 } 1010 1011 if($this->IsError()) { 1012 $result = ''; 1013 } else if ($this->sign_key_file) { 1014 $file = tempnam("", "mail"); 1015 $fp = fopen($file, "w"); 1016 fwrite($fp, $result); 1017 fclose($fp); 1018 $signed = tempnam("", "signed"); 1019 1020 if (@openssl_pkcs7_sign($file, $signed, "file://".$this->sign_cert_file, array("file://".$this->sign_key_file, $this->sign_key_pass), null)) { 1021 $fp = fopen($signed, "r"); 1022 $result = fread($fp, filesize($this->sign_key_file)); 1023 $result = ''; 1024 while(!feof($fp)){ 1025 $result = $result . fread($fp, 1024); 1026 } 1027 fclose($fp); 1028 } else { 1029 $this->SetError($this->Lang("signing").openssl_error_string()); 1030 $result = ''; 1031 } 1032 1033 unlink($file); 1034 unlink($signed); 1035 } 1036 1037 return $result; 1038 } 1039 1040 /** 1041 * Returns the start of a message boundary. 1042 * @access private 1043 */ 1044 function GetBoundary($boundary, $charSet, $contentType, $encoding) { 1045 $result = ''; 1046 if($charSet == '') { 1047 $charSet = $this->CharSet; 1048 } 1049 if($contentType == '') { 1050 $contentType = $this->ContentType; 1051 } 1052 if($encoding == '') { 1053 $encoding = $this->Encoding; 1054 } 1055 $result .= $this->TextLine('--' . $boundary); 1056 $result .= sprintf("Content-Type: %s; charset = \"%s\"", $contentType, $charSet); 1057 $result .= $this->LE; 1058 $result .= $this->HeaderLine('Content-Transfer-Encoding', $encoding); 1059 $result .= $this->LE; 1060 1061 return $result; 1062 } 1063 1064 /** 1065 * Returns the end of a message boundary. 1066 * @access private 1067 */ 1068 function EndBoundary($boundary) { 1069 return $this->LE . '--' . $boundary . '--' . $this->LE; 1070 } 1071 1072 /** 1073 * Sets the message type. 1074 * @access private 1075 * @return void 1076 */ 1077 function SetMessageType() { 1078 if(count($this->attachment) < 1 && strlen($this->AltBody) < 1) { 1079 $this->message_type = 'plain'; 1080 } else { 1081 if(count($this->attachment) > 0) { 1082 $this->message_type = 'attachments'; 1083 } 1084 if(strlen($this->AltBody) > 0 && count($this->attachment) < 1) { 1085 $this->message_type = 'alt'; 1086 } 1087 if(strlen($this->AltBody) > 0 && count($this->attachment) > 0) { 1088 $this->message_type = 'alt_attachments'; 1089 } 1090 } 1091 } 1092 1093 /* Returns a formatted header line. 1094 * @access private 1095 * @return string 1096 */ 1097 function HeaderLine($name, $value) { 1098 return $name . ': ' . $value . $this->LE; 1099 } 1100 1101 /** 1102 * Returns a formatted mail line. 1103 * @access private 1104 * @return string 1105 */ 1106 function TextLine($value) { 1107 return $value . $this->LE; 1108 } 1109 1110 ///////////////////////////////////////////////// 1111 // CLASS METHODS, ATTACHMENTS 1112 ///////////////////////////////////////////////// 1113 1114 /** 1115 * Adds an attachment from a path on the filesystem. 1116 * Returns false if the file could not be found 1117 * or accessed. 1118 * @param string $path Path to the attachment. 1119 * @param string $name Overrides the attachment name. 1120 * @param string $encoding File encoding (see $Encoding). 1121 * @param string $type File extension (MIME) type. 1122 * @return bool 1123 */ 1124 function AddAttachment($path, $name = '', $encoding = 'base64', $type = 'application/octet-stream') { 1125 if(!@is_file($path)) { 1126 $this->SetError($this->Lang('file_access') . $path); 1127 return false; 1128 } 1129 1130 $filename = basename($path); 1131 if($name == '') { 1132 $name = $filename; 1133 } 1134 1135 $cur = count($this->attachment); 1136 $this->attachment[$cur][0] = $path; 1137 $this->attachment[$cur][1] = $filename; 1138 $this->attachment[$cur][2] = $name; 1139 $this->attachment[$cur][3] = $encoding; 1140 $this->attachment[$cur][4] = $type; 1141 $this->attachment[$cur][5] = false; // isStringAttachment 1142 $this->attachment[$cur][6] = 'attachment'; 1143 $this->attachment[$cur][7] = 0; 1144 1145 return true; 1146 } 1147 1148 /** 1149 * Attaches all fs, string, and binary attachments to the message. 1150 * Returns an empty string on failure. 1151 * @access private 1152 * @return string 1153 */ 1154 function AttachAll() { 1155 /* Return text of body */ 1156 $mime = array(); 1157 1158 /* Add all attachments */ 1159 for($i = 0; $i < count($this->attachment); $i++) { 1160 /* Check for string attachment */ 1161 $bString = $this->attachment[$i][5]; 1162 if ($bString) { 1163 $string = $this->attachment[$i][0]; 1164 } else { 1165 $path = $this->attachment[$i][0]; 1166 } 1167 1168 $filename = $this->attachment[$i][1]; 1169 $name = $this->attachment[$i][2]; 1170 $encoding = $this->attachment[$i][3]; 1171 $type = $this->attachment[$i][4]; 1172 $disposition = $this->attachment[$i][6]; 1173 $cid = $this->attachment[$i][7]; 1174 1175 $mime[] = sprintf("--%s%s", $this->boundary[1], $this->LE); 1176 $mime[] = sprintf("Content-Type: %s; name=\"%s\"%s", $type, $this->EncodeHeader($this->SecureHeader($name)), $this->LE); 1177 $mime[] = sprintf("Content-Transfer-Encoding: %s%s", $encoding, $this->LE); 1178 1179 if($disposition == 'inline') { 1180 $mime[] = sprintf("Content-ID: <%s>%s", $cid, $this->LE); 1181 } 1182 1183 $mime[] = sprintf("Content-Disposition: %s; filename=\"%s\"%s", $disposition, $this->EncodeHeader($this->SecureHeader($name)), $this->LE.$this->LE); 1184 1185 /* Encode as string attachment */ 1186 if($bString) { 1187 $mime[] = $this->EncodeString($string, $encoding); 1188 if($this->IsError()) { 1189 return ''; 1190 } 1191 $mime[] = $this->LE.$this->LE; 1192 } else { 1193 $mime[] = $this->EncodeFile($path, $encoding); 1194 if($this->IsError()) { 1195 return ''; 1196 } 1197 $mime[] = $this->LE.$this->LE; 1198 } 1199 } 1200 1201 $mime[] = sprintf("--%s--%s", $this->boundary[1], $this->LE); 1202 1203 return join('', $mime); 1204 } 1205 1206 /** 1207 * Encodes attachment in requested format. Returns an 1208 * empty string on failure. 1209 * @access private 1210 * @return string 1211 */ 1212 function EncodeFile ($path, $encoding = 'base64') { 1213 if(!@$fd = fopen($path, 'rb')) { 1214 $this->SetError($this->Lang('file_open') . $path); 1215 return ''; 1216 } 1217 $magic_quotes = get_magic_quotes_runtime(); 1218 set_magic_quotes_runtime(0); 1219 $file_buffer = fread($fd, filesize($path)); 1220 $file_buffer = $this->EncodeString($file_buffer, $encoding); 1221 fclose($fd); 1222 set_magic_quotes_runtime($magic_quotes); 1223 1224 return $file_buffer; 1225 } 1226 1227 /** 1228 * Encodes string to requested format. Returns an 1229 * empty string on failure. 1230 * @access private 1231 * @return string 1232 */ 1233 function EncodeString ($str, $encoding = 'base64') { 1234 $encoded = ''; 1235 switch(strtolower($encoding)) { 1236 case 'base64': 1237 /* chunk_split is found in PHP >= 3.0.6 */ 1238 $encoded = chunk_split(base64_encode($str), 76, $this->LE); 1239 break; 1240 case '7bit': 1241 case '8bit': 1242 $encoded = $this->FixEOL($str); 1243 if (substr($encoded, -(strlen($this->LE))) != $this->LE) 1244 $encoded .= $this->LE; 1245 break; 1246 case 'binary': 1247 $encoded = $str; 1248 break; 1249 case 'quoted-printable': 1250 $encoded = $this->EncodeQP($str); 1251 break; 1252 default: 1253 $this->SetError($this->Lang('encoding') . $encoding); 1254 break; 1255 } 1256 return $encoded; 1257 } 1258 1259 /** 1260 * Encode a header string to best of Q, B, quoted or none. 1261 * @access private 1262 * @return string 1263 */ 1264 function EncodeHeader ($str, $position = 'text') { 1265 $x = 0; 1266 1267 switch (strtolower($position)) { 1268 case 'phrase': 1269 if (!preg_match('/[\200-\377]/', $str)) { 1270 /* Can't use addslashes as we don't know what value has magic_quotes_sybase. */ 1271 $encoded = addcslashes($str, "\0..\37\177\\\""); 1272 if (($str == $encoded) && !preg_match('/[^A-Za-z0-9!#$%&\'*+\/=?^_`{|}~ -]/', $str)) { 1273 return ($encoded); 1274 } else { 1275 return ("\"$encoded\""); 1276 } 1277 } 1278 $x = preg_match_all('/[^\040\041\043-\133\135-\176]/', $str, $matches); 1279 break; 1280 case 'comment': 1281 $x = preg_match_all('/[()"]/', $str, $matches); 1282 /* Fall-through */ 1283 case 'text': 1284 default: 1285 $x += preg_match_all('/[\000-\010\013\014\016-\037\177-\377]/', $str, $matches); 1286 break; 1287 } 1288 1289 if ($x == 0) { 1290 return ($str); 1291 } 1292 1293 $maxlen = 75 - 7 - strlen($this->CharSet); 1294 /* Try to select the encoding which should produce the shortest output */ 1295 if (strlen($str)/3 < $x) { 1296 $encoding = 'B'; 1297 if (function_exists('mb_strlen') && $this->HasMultiBytes($str)) { 1298 // Use a custom function which correctly encodes and wraps long 1299 // multibyte strings without breaking lines within a character 1300 $encoded = $this->Base64EncodeWrapMB($str); 1301 } else { 1302 $encoded = base64_encode($str); 1303 $maxlen -= $maxlen % 4; 1304 $encoded = trim(chunk_split($encoded, $maxlen, "\n")); 1305 } 1306 } else { 1307 $encoding = 'Q'; 1308 $encoded = $this->EncodeQ($str, $position); 1309 $encoded = $this->WrapText($encoded, $maxlen, true); 1310 $encoded = str_replace('='.$this->LE, "\n", trim($encoded)); 1311 } 1312 1313 $encoded = preg_replace('/^(.*)$/m', " =?".$this->CharSet."?$encoding?\\1?=", $encoded); 1314 $encoded = trim(str_replace("\n", $this->LE, $encoded)); 1315 1316 return $encoded; 1317 } 1318 1319 /** 1320 * Checks if a string contains multibyte characters. 1321 * @access private 1322 * @param string $str multi-byte text to wrap encode 1323 * @return bool 1324 */ 1325 function HasMultiBytes($str) { 1326 if (function_exists('mb_strlen')) { 1327 return (strlen($str) > mb_strlen($str, $this->CharSet)); 1328 } else { // Assume no multibytes (we can't handle without mbstring functions anyway) 1329 return False; 1330 } 1331 } 1332 1333 /** 1334 * Correctly encodes and wraps long multibyte strings for mail headers 1335 * without breaking lines within a character. 1336 * Adapted from a function by paravoid at http://uk.php.net/manual/en/function.mb-encode-mimeheader.php 1337 * @access private 1338 * @param string $str multi-byte text to wrap encode 1339 * @return string 1340 */ 1341 function Base64EncodeWrapMB($str) { 1342 $start = "=?".$this->CharSet."?B?"; 1343 $end = "?="; 1344 $encoded = ""; 1345 1346 $mb_length = mb_strlen($str, $this->CharSet); 1347 // Each line must have length <= 75, including $start and $end 1348 $length = 75 - strlen($start) - strlen($end); 1349 // Average multi-byte ratio 1350 $ratio = $mb_length / strlen($str); 1351 // Base64 has a 4:3 ratio 1352 $offset = $avgLength = floor($length * $ratio * .75); 1353 1354 for ($i = 0; $i < $mb_length; $i += $offset) { 1355 $lookBack = 0; 1356 1357 do { 1358 $offset = $avgLength - $lookBack; 1359 $chunk = mb_substr($str, $i, $offset, $this->CharSet); 1360 $chunk = base64_encode($chunk); 1361 $lookBack++; 1362 } 1363 while (strlen($chunk) > $length); 1364 1365 $encoded .= $chunk . $this->LE; 1366 } 1367 1368 // Chomp the last linefeed 1369 $encoded = substr($encoded, 0, -strlen($this->LE)); 1370 return $encoded; 1371 } 1372 1373 /** 1374 * Encode string to quoted-printable. 1375 * @access private 1376 * @return string 1377 */ 1378 function EncodeQP( $input = '', $line_max = 76, $space_conv = false ) { 1379 $hex = array('0','1','2','3','4','5','6','7','8','9','A','B','C','D','E','F'); 1380 $lines = preg_split('/(?:\r\n|\r|\n)/', $input); 1381 $eol = "\r\n"; 1382 $escape = '='; 1383 $output = ''; 1384 while( list(, $line) = each($lines) ) { 1385 $linlen = strlen($line); 1386 $newline = ''; 1387 for($i = 0; $i < $linlen; $i++) { 1388 $c = substr( $line, $i, 1 ); 1389 $dec = ord( $c ); 1390 if ( ( $i == 0 ) && ( $dec == 46 ) ) { // convert first point in the line into =2E 1391 $c = '=2E'; 1392 } 1393 if ( $dec == 32 ) { 1394 if ( $i == ( $linlen - 1 ) ) { // convert space at eol only 1395 $c = '=20'; 1396 } else if ( $space_conv ) { 1397 $c = '=20'; 1398 } 1399 } elseif ( ($dec == 61) || ($dec < 32 ) || ($dec > 126) ) { // always encode "\t", which is *not* required 1400 $h2 = floor($dec/16); 1401 $h1 = floor($dec%16); 1402 $c = $escape.$hex[$h2].$hex[$h1]; 1403 } 1404 if ( (strlen($newline) + strlen($c)) >= $line_max ) { // CRLF is not counted 1405 $output .= $newline.$escape.$eol; // soft line break; " =\r\n" is okay 1406 $newline = ''; 1407 // check if newline first character will be point or not 1408 if ( $dec == 46 ) { 1409 $c = '=2E'; 1410 } 1411 } 1412 $newline .= $c; 1413 } // end of for 1414 $output .= $newline.$eol; 1415 } // end of while 1416 return $output; 1417 } 1418 1419 /** 1420 * Callback for converting to "=XX". 1421 * @access private 1422 * @return string 1423 */ 1424 function EncodeQ_callback ($matches) { 1425 return sprintf('=%02X', ord($matches[1])); 1426 } 1427 1428 /** 1429 * Encode string to q encoding. 1430 * @access private 1431 * @return string 1432 */ 1433 function EncodeQ ($str, $position = 'text') { 1434 /* There should not be any EOL in the string */ 1435 $encoded = preg_replace("/[\r\n]/", '', $str); 1436 1437 switch (strtolower($position)) { 1438 case 'phrase': 1439 $encoded = preg_replace_callback("/([^A-Za-z0-9!*+\/ -])/", 1440 array('PHPMailer', 'EncodeQ_callback'), $encoded); 1441 break; 1442 case 'comment': 1443 $encoded = preg_replace_callback("/([\(\)\"])/", 1444 array('PHPMailer', 'EncodeQ_callback'), $encoded); 1445 break; 1446 case 'text': 1447 default: 1448 /* Replace every high ascii, control =, ? and _ characters */ 1449 $encoded = preg_replace_callback('/([\000-\011\013\014\016-\037\075\077\137\177-\377])/', 1450 array('PHPMailer', 'EncodeQ_callback'), $encoded); 1451 break; 1452 } 1453 1454 /* Replace every spaces to _ (more readable than =20) */ 1455 $encoded = str_replace(' ', '_', $encoded); 1456 1457 return $encoded; 1458 } 1459 1460 /** 1461 * Adds a string or binary attachment (non-filesystem) to the list. 1462 * This method can be used to attach ascii or binary data, 1463 * such as a BLOB record from a database. 1464 * @param string $string String attachment data. 1465 * @param string $filename Name of the attachment. 1466 * @param string $encoding File encoding (see $Encoding). 1467 * @param string $type File extension (MIME) type. 1468 * @return void 1469 */ 1470 function AddStringAttachment($string, $filename, $encoding = 'base64', $type = 'application/octet-stream') { 1471 /* Append to $attachment array */ 1472 $cur = count($this->attachment); 1473 $this->attachment[$cur][0] = $string; 1474 $this->attachment[$cur][1] = $filename; 1475 $this->attachment[$cur][2] = $filename; 1476 $this->attachment[$cur][3] = $encoding; 1477 $this->attachment[$cur][4] = $type; 1478 $this->attachment[$cur][5] = true; // isString 1479 $this->attachment[$cur][6] = 'attachment'; 1480 $this->attachment[$cur][7] = 0; 1481 } 1482 1483 /** 1484 * Adds an embedded attachment. This can include images, sounds, and 1485 * just about any other document. Make sure to set the $type to an 1486 * image type. For JPEG images use "image/jpeg" and for GIF images 1487 * use "image/gif". 1488 * @param string $path Path to the attachment. 1489 * @param string $cid Content ID of the attachment. Use this to identify 1490 * the Id for accessing the image in an HTML form. 1491 * @param string $name Overrides the attachment name. 1492 * @param string $encoding File encoding (see $Encoding). 1493 * @param string $type File extension (MIME) type. 1494 * @return bool 1495 */ 1496 function AddEmbeddedImage($path, $cid, $name = '', $encoding = 'base64', $type = 'application/octet-stream') { 1497 1498 if(!@is_file($path)) { 1499 $this->SetError($this->Lang('file_access') . $path); 1500 return false; 1501 } 1502 1503 $filename = basename($path); 1504 if($name == '') { 1505 $name = $filename; 1506 } 1507 1508 /* Append to $attachment array */ 1509 $cur = count($this->attachment); 1510 $this->attachment[$cur][0] = $path; 1511 $this->attachment[$cur][1] = $filename; 1512 $this->attachment[$cur][2] = $name; 1513 $this->attachment[$cur][3] = $encoding; 1514 $this->attachment[$cur][4] = $type; 1515 $this->attachment[$cur][5] = false; 1516 $this->attachment[$cur][6] = 'inline'; 1517 $this->attachment[$cur][7] = $cid; 1518 1519 return true; 1520 } 1521 1522 /** 1523 * Returns true if an inline attachment is present. 1524 * @access private 1525 * @return bool 1526 */ 1527 function InlineImageExists() { 1528 $result = false; 1529 for($i = 0; $i < count($this->attachment); $i++) { 1530 if($this->attachment[$i][6] == 'inline') { 1531 $result = true; 1532 break; 1533 } 1534 } 1535 1536 return $result; 1537 } 1538 1539 ///////////////////////////////////////////////// 1540 // CLASS METHODS, MESSAGE RESET 1541 ///////////////////////////////////////////////// 1542 1543 /** 1544 * Clears all recipients assigned in the TO array. Returns void. 1545 * @return void 1546 */ 1547 function ClearAddresses() { 1548 $this->to = array(); 1549 } 1550 1551 /** 1552 * Clears all recipients assigned in the CC array. Returns void. 1553 * @return void 1554 */ 1555 function ClearCCs() { 1556 $this->cc = array(); 1557 } 1558 1559 /** 1560 * Clears all recipients assigned in the BCC array. Returns void. 1561 * @return void 1562 */ 1563 function ClearBCCs() { 1564 $this->bcc = array(); 1565 } 1566 1567 /** 1568 * Clears all recipients assigned in the ReplyTo array. Returns void. 1569 * @return void 1570 */ 1571 function ClearReplyTos() { 1572 $this->ReplyTo = array(); 1573 } 1574 1575 /** 1576 * Clears all recipients assigned in the TO, CC and BCC 1577 * array. Returns void. 1578 * @return void 1579 */ 1580 function ClearAllRecipients() { 1581 $this->to = array(); 1582 $this->cc = array(); 1583 $this->bcc = array(); 1584 } 1585 1586 /** 1587 * Clears all previously set filesystem, string, and binary 1588 * attachments. Returns void. 1589 * @return void 1590 */ 1591 function ClearAttachments() { 1592 $this->attachment = array(); 1593 } 1594 1595 /** 1596 * Clears all custom headers. Returns void. 1597 * @return void 1598 */ 1599 function ClearCustomHeaders() { 1600 $this->CustomHeader = array(); 1601 } 1602 1603 ///////////////////////////////////////////////// 1604 // CLASS METHODS, MISCELLANEOUS 1605 ///////////////////////////////////////////////// 1606 1607 /** 1608 * Adds the error message to the error container. 1609 * Returns void. 1610 * @access private 1611 * @return void 1612 */ 1613 function SetError($msg) { 1614 $this->error_count++; 1615 $this->ErrorInfo = $msg; 1616 } 1617 1618 /** 1619 * Returns the proper RFC 822 formatted date. 1620 * @access private 1621 * @return string 1622 */ 1623 function RFCDate() { 1624 $tz = date('Z'); 1625 $tzs = ($tz < 0) ? '-' : '+'; 1626 $tz = abs($tz); 1627 $tz = (int)($tz/3600)*100 + ($tz%3600)/60; 1628 $result = sprintf("%s %s%04d", date('D, j M Y H:i:s'), $tzs, $tz); 1629 1630 return $result; 1631 } 1632 1633 /** 1634 * Returns the appropriate server variable. Should work with both 1635 * PHP 4.1.0+ as well as older versions. Returns an empty string 1636 * if nothing is found. 1637 * @access private 1638 * @return mixed 1639 */ 1640 function ServerVar($varName) { 1641 global $HTTP_SERVER_VARS; 1642 global $HTTP_ENV_VARS; 1643 1644 if(!isset($_SERVER)) { 1645 $_SERVER = $HTTP_SERVER_VARS; 1646 if(!isset($_SERVER['REMOTE_ADDR'])) { 1647 $_SERVER = $HTTP_ENV_VARS; // must be Apache 1648 } 1649 } 1650 1651 if(isset($_SERVER[$varName])) { 1652 return $_SERVER[$varName]; 1653 } else { 1654 return ''; 1655 } 1656 } 1657 1658 /** 1659 * Returns the server hostname or 'localhost.localdomain' if unknown. 1660 * @access private 1661 * @return string 1662 */ 1663 function ServerHostname() { 1664 if ($this->Hostname != '') { 1665 $result = $this->Hostname; 1666 } elseif ($this->ServerVar('SERVER_NAME') != '') { 1667 $result = $this->ServerVar('SERVER_NAME'); 1668 } else { 1669 $result = 'localhost.localdomain'; 1670 } 1671 1672 return $result; 1673 } 1674 1675 /** 1676 * Returns a message in the appropriate language. 1677 * @access private 1678 * @return string 1679 */ 1680 function Lang($key) { 1681 if(count($this->language) < 1) { 1682 $this->SetLanguage('en'); // set the default language 1683 } 1684 1685 if(isset($this->language[$key])) { 1686 return $this->language[$key]; 1687 } else { 1688 return 'Language string failed to load: ' . $key; 1689 } 1690 } 1691 1692 /** 1693 * Returns true if an error occurred. 1694 * @return bool 1695 */ 1696 function IsError() { 1697 return ($this->error_count > 0); 1698 } 1699 1700 /** 1701 * Changes every end of line from CR or LF to CRLF. 1702 * @access private 1703 * @return string 1704 */ 1705 function FixEOL($str) { 1706 $str = str_replace("\r\n", "\n", $str); 1707 $str = str_replace("\r", "\n", $str); 1708 $str = str_replace("\n", $this->LE, $str); 1709 return $str; 1710 } 1711 1712 /** 1713 * Adds a custom header. 1714 * @return void 1715 */ 1716 function AddCustomHeader($custom_header) { 1717 $this->CustomHeader[] = explode(':', $custom_header, 2); 1718 } 1719 1720 /** 1721 * Evaluates the message and returns modifications for inline images and backgrounds 1722 * @access public 1723 * @return $message 1724 */ 1725 function MsgHTML($message,$basedir='') { 1726 preg_match_all("/(src|background)=\"(.*)\"/Ui", $message, $images); 1727 if(isset($images[2])) { 1728 foreach($images[2] as $i => $url) { 1729 // do not change urls for absolute images (thanks to corvuscorax) 1730 if (!preg_match('/^[A-z][A-z]*:\/\//',$url)) { 1731 $filename = basename($url); 1732 $directory = dirname($url); 1733 ($directory == '.')?$directory='':''; 1734 $cid = 'cid:' . md5($filename); 1735 $fileParts = split("\.", $filename); 1736 $ext = $fileParts[1]; 1737 $mimeType = $this->_mime_types($ext); 1738 if ( strlen($basedir) > 1 && substr($basedir,-1) != '/') { $basedir .= '/'; } 1739 if ( strlen($directory) > 1 && substr($directory,-1) != '/') { $directory .= '/'; } 1740 if ( $this->AddEmbeddedImage($basedir.$directory.$filename, md5($filename), $filename, 'base64',$mimeType) ) { 1741 $message = preg_replace("/".$images[1][$i]."=\"".preg_quote($url, '/')."\"/Ui", $images[1][$i]."=\"".$cid."\"", $message); 1742 } 1743 } 1744 } 1745 } 1746 $this->IsHTML(true); 1747 $this->Body = $message; 1748 $textMsg = trim(strip_tags(preg_replace('/<(head|title|style|script)[^>]*>.*?<\/\\1>/s','',$message))); 1749 if ( !empty($textMsg) && empty($this->AltBody) ) { 1750 $this->AltBody = html_entity_decode($textMsg); 1751 } 1752 if ( empty($this->AltBody) ) { 1753 $this->AltBody = 'To view this email message, open the email in with HTML compatibility!' . "\n\n"; 1754 } 1755 } 1756 1757 /** 1758 * Gets the mime type of the embedded or inline image 1759 * @access private 1760 * @return mime type of ext 1761 */ 1762 function _mime_types($ext = '') { 1763 $mimes = array( 1764 'ai' => 'application/postscript', 1765 'aif' => 'audio/x-aiff', 1766 'aifc' => 'audio/x-aiff', 1767 'aiff' => 'audio/x-aiff', 1768 'avi' => 'video/x-msvideo', 1769 'bin' => 'application/macbinary', 1770 'bmp' => 'image/bmp', 1771 'class' => 'application/octet-stream', 1772 'cpt' => 'application/mac-compactpro', 1773 'css' => 'text/css', 1774 'dcr' => 'application/x-director', 1775 'dir' => 'application/x-director', 1776 'dll' => 'application/octet-stream', 1777 'dms' => 'application/octet-stream', 1778 'doc' => 'application/msword', 1779 'dvi' => 'application/x-dvi', 1780 'dxr' => 'application/x-director', 1781 'eml' => 'message/rfc822', 1782 'eps' => 'application/postscript', 1783 'exe' => 'application/octet-stream', 1784 'gif' => 'image/gif', 1785 'gtar' => 'application/x-gtar', 1786 'htm' => 'text/html', 1787 'html' => 'text/html', 1788 'jpe' => 'image/jpeg', 1789 'jpeg' => 'image/jpeg', 1790 'jpg' => 'image/jpeg', 1791 'hqx' => 'application/mac-binhex40', 1792 'js' => 'application/x-javascript', 1793 'lha' => 'application/octet-stream', 1794 'log' => 'text/plain', 1795 'lzh' => 'application/octet-stream', 1796 'mid' => 'audio/midi', 1797 'midi' => 'audio/midi', 1798 'mif' => 'application/vnd.mif', 1799 'mov' => 'video/quicktime', 1800 'movie' => 'video/x-sgi-movie', 1801 'mp2' => 'audio/mpeg', 1802 'mp3' => 'audio/mpeg', 1803 'mpe' => 'video/mpeg', 1804 'mpeg' => 'video/mpeg', 1805 'mpg' => 'video/mpeg', 1806 'mpga' => 'audio/mpeg', 1807 'oda' => 'application/oda', 1808 'pdf' => 'application/pdf', 1809 'php' => 'application/x-httpd-php', 1810 'php3' => 'application/x-httpd-php', 1811 'php4' => 'application/x-httpd-php', 1812 'phps' => 'application/x-httpd-php-source', 1813 'phtml' => 'application/x-httpd-php', 1814 'png' => 'image/png', 1815 'ppt' => 'application/vnd.ms-powerpoint', 1816 'ps' => 'application/postscript', 1817 'psd' => 'application/octet-stream', 1818 'qt' => 'video/quicktime', 1819 'ra' => 'audio/x-realaudio', 1820 'ram' => 'audio/x-pn-realaudio', 1821 'rm' => 'audio/x-pn-realaudio', 1822 'rpm' => 'audio/x-pn-realaudio-plugin', 1823 'rtf' => 'text/rtf', 1824 'rtx' => 'text/richtext', 1825 'rv' => 'video/vnd.rn-realvideo', 1826 'sea' => 'application/octet-stream', 1827 'shtml' => 'text/html', 1828 'sit' => 'application/x-stuffit', 1829 'so' => 'application/octet-stream', 1830 'smi' => 'application/smil', 1831 'smil' => 'application/smil', 1832 'swf' => 'application/x-shockwave-flash', 1833 'tar' => 'application/x-tar', 1834 'text' => 'text/plain', 1835 'txt' => 'text/plain', 1836 'tgz' => 'application/x-tar', 1837 'tif' => 'image/tiff', 1838 'tiff' => 'image/tiff', 1839 'wav' => 'audio/x-wav', 1840 'wbxml' => 'application/vnd.wap.wbxml', 1841 'wmlc' => 'application/vnd.wap.wmlc', 1842 'word' => 'application/msword', 1843 'xht' => 'application/xhtml+xml', 1844 'xhtml' => 'application/xhtml+xml', 1845 'xl' => 'application/excel', 1846 'xls' => 'application/vnd.ms-excel', 1847 'xml' => 'text/xml', 1848 'xsl' => 'text/xml', 1849 'zip' => 'application/zip' 1850 ); 1851 return ( ! isset($mimes[strtolower($ext)])) ? 'application/octet-stream' : $mimes[strtolower($ext)]; 1852 } 1853 1854 /** 1855 * Set (or reset) Class Objects (variables) 1856 * 1857 * Usage Example: 1858 * $page->set('X-Priority', '3'); 1859 * 1860 * @access public 1861 * @param string $name Parameter Name 1862 * @param mixed $value Parameter Value 1863 * NOTE: will not work with arrays, there are no arrays to set/reset 1864 */ 1865 function set ( $name, $value = '' ) { 1866 if ( isset($this->$name) ) { 1867 $this->$name = $value; 1868 } else { 1869 $this->SetError('Cannot set or reset variable ' . $name); 1870 return false; 1871 } 1872 } 1873 1874 /** 1875 * Read a file from a supplied filename and return it. 1876 * 1877 * @access public 1878 * @param string $filename Parameter File Name 1879 */ 1880 function getFile($filename) { 1881 $return = ''; 1882 if ($fp = fopen($filename, 'rb')) { 1883 while (!feof($fp)) { 1884 $return .= fread($fp, 1024); 1885 } 1886 fclose($fp); 1887 return $return; 1888 } else { 1889 return false; 1890 } 1891 } 1892 1893 /** 1894 * Strips newlines to prevent header injection. 1895 * @access private 1896 * @param string $str String 1897 * @return string 1898 */ 1899 function SecureHeader($str) { 1900 $str = trim($str); 1901 $str = str_replace("\r", "", $str); 1902 $str = str_replace("\n", "", $str); 1903 return $str; 1904 } 1905 1906 /** 1907 * Set the private key file and password to sign the message. 1908 * 1909 * @access public 1910 * @param string $key_filename Parameter File Name 1911 * @param string $key_pass Password for private key 1912 */ 1913 function Sign($cert_filename, $key_filename, $key_pass) { 1914 $this->sign_cert_file = $cert_filename; 1915 $this->sign_key_file = $key_filename; 1916 $this->sign_key_pass = $key_pass; 1917 } 1918 1919 } 1920 1921 ?>
title
Description
Body
title
Description
Body
title
Description
Body
title
Body
| Generated: Fri Jan 8 00:19:48 2010 | Cross-referenced by PHPXref 0.7 |