Index: src/wp-includes/class-phpmailer.php =================================================================== --- src/wp-includes/class-phpmailer.php (revision 33091) +++ src/wp-includes/class-phpmailer.php (working copy) @@ -1,15 +1,14 @@ + * @link https://github.com/PHPMailer/PHPMailer/ The PHPMailer GitHub project + * @author Marcus Bointon (Synchro/coolbru) * @author Jim Jagielski (jimjag) * @author Andy Prevost (codeworxtech) * @author Brent R. Matzelle (original founder) - * @copyright 2013 Marcus Bointon + * @copyright 2012 - 2014 Marcus Bointon * @copyright 2010 - 2012 Jim Jagielski * @copyright 2004 - 2009 Andy Prevost * @license http://www.gnu.org/copyleft/lesser.html GNU Lesser General Public License @@ -18,21 +17,13 @@ * FITNESS FOR A PARTICULAR PURPOSE. */ -if (version_compare(PHP_VERSION, '5.0.0', '<')) { - exit("Sorry, PHPMailer will only run on PHP version 5 or greater!\n"); -} - /** * PHPMailer - PHP email creation and transport class. - * PHP Version 5.0.0 * @package PHPMailer - * @author Marcus Bointon (coolbru) + * @author Marcus Bointon (Synchro/coolbru) * @author Jim Jagielski (jimjag) * @author Andy Prevost (codeworxtech) * @author Brent R. Matzelle (original founder) - * @copyright 2013 Marcus Bointon - * @copyright 2010 - 2012 Jim Jagielski - * @copyright 2004 - 2009 Andy Prevost */ class PHPMailer { @@ -40,12 +31,12 @@ * The PHPMailer Version number. * @type string */ - public $Version = '5.2.7'; + public $Version = '5.2.10'; /** * Email priority. * Options: 1 = High, 3 = Normal, 5 = low. - * @type int + * @type integer */ public $Priority = 3; @@ -97,6 +88,9 @@ * The Return-Path of the message. * If empty, it will be set to either From or Sender. * @type string + * @deprecated Email senders should never set a return-path header; + * it's the receiver's job (RFC5321 section 4.4), so this no longer does anything. + * @link https://tools.ietf.org/html/rfc5321#section-4.4 RFC5321 reference */ public $ReturnPath = ''; @@ -155,7 +149,8 @@ /** * Word-wrap the message body to this number of chars. - * @type int + * Set to 0 to not wrap. A useful value here is 78, for RFC2822 section 2.1.1 compliance. + * @type integer */ public $WordWrap = 0; @@ -175,7 +170,7 @@ /** * Whether mail() uses a fully sendmail-compatible MTA. * One which supports sendmail's "-oi -f" options. - * @type bool + * @type boolean */ public $UseSendmailOptions = true; @@ -222,6 +217,8 @@ * You can also specify a different port * for each host by using this format: [hostname:port] * (e.g. "smtp1.example.com:25;smtp2.example.com"). + * You can also specify encryption type, for example: + * (e.g. "tls://smtp1.example.com:587;ssl://smtp2.example.com:465"). * Hosts will be tried in order. * @type string */ @@ -229,8 +226,8 @@ /** * The default SMTP server port. - * @type int - * @Todo Why is this needed when the SMTP class takes care of it? + * @type integer + * @TODO Why is this needed when the SMTP class takes care of it? */ public $Port = 25; @@ -243,22 +240,36 @@ public $Helo = ''; /** - * The secure connection prefix. - * Options: "", "ssl" or "tls" + * What kind of encryption to use on the SMTP connection. + * Options: '', 'ssl' or 'tls' * @type string */ public $SMTPSecure = ''; /** + * Whether to enable TLS encryption automatically if a server supports it, + * even if `SMTPSecure` is not set to 'tls'. + * Be aware that in PHP >= 5.6 this requires that the server's certificates are valid. + * @type boolean + */ + public $SMTPAutoTLS = true; + + /** * Whether to use SMTP authentication. * Uses the Username and Password properties. - * @type bool + * @type boolean * @see PHPMailer::$Username * @see PHPMailer::$Password */ public $SMTPAuth = false; /** + * Options array passed to stream_context_create when connecting via SMTP. + * @type array + */ + public $SMTPOptions = array(); + + /** * SMTP username. * @type string */ @@ -293,45 +304,60 @@ /** * The SMTP server timeout in seconds. - * @type int + * Default of 5 minutes (300sec) is from RFC2821 section 4.5.3.2 + * @type integer */ - public $Timeout = 10; + public $Timeout = 300; /** * SMTP class debug output mode. - * Options: 0 = off, 1 = commands, 2 = commands and data - * @type int + * Debug output level. + * Options: + * * `0` No output + * * `1` Commands + * * `2` Data and commands + * * `3` As 2 plus connection status + * * `4` Low-level data output + * @type integer * @see SMTP::$do_debug */ public $SMTPDebug = 0; /** - * The function/method to use for debugging output. - * Options: "echo" or "error_log" - * @type string + * How to handle debug output. + * Options: + * * `echo` Output plain-text as-is, appropriate for CLI + * * `html` Output escaped, line breaks converted to `
`, appropriate for browser output + * * `error_log` Output to error log as configured in php.ini + * + * Alternatively, you can provide a callable expecting two params: a message string and the debug level: + * + * $mail->Debugoutput = function($str, $level) {echo "debug level $level; message: $str";}; + * + * @type string|callable * @see SMTP::$Debugoutput */ - public $Debugoutput = "echo"; + public $Debugoutput = 'echo'; /** * Whether to keep SMTP connection open after each message. * If this is set to true then to close the connection * requires an explicit call to smtpClose(). - * @type bool + * @type boolean */ public $SMTPKeepAlive = false; /** * Whether to split multiple to addresses into multiple messages * or send them all in one message. - * @type bool + * @type boolean */ public $SingleTo = false; /** * Storage for addresses when SingleTo is enabled. * @type array - * @todo This should really not be public + * @TODO This should really not be public */ public $SingleToArray = array(); @@ -339,13 +365,14 @@ * Whether to generate VERP addresses on send. * Only applicable when sending via SMTP. * @link http://en.wikipedia.org/wiki/Variable_envelope_return_path - * @type bool + * @link http://www.postfix.org/VERP_README.html Postfix VERP info + * @type boolean */ public $do_verp = false; /** * Whether to allow sending messages with an empty body. - * @type bool + * @type boolean */ public $AllowEmpty = false; @@ -396,28 +423,23 @@ * The function that handles the result of the send email action. * It is called out by send() for each email sent. * - * Value can be: - * - 'function_name' for function names - * - 'Class::Method' for static method calls - * - array($object, 'Method') for calling methods on $object - * See http://php.net/is_callable manual page for more details. + * Value can be any php callable: http://www.php.net/is_callable * * Parameters: - * bool $result result of the send action + * boolean $result result of the send action * string $to email address of the recipient * string $cc cc email addresses * string $bcc bcc email addresses * string $subject the subject * string $body the email body * string $from email address of sender - * * @type string */ public $action_function = ''; /** - * What to use in the X-Mailer header. - * Options: null for default, whitespace for none, or a string to use + * What to put in the X-Mailer header. + * Options: An empty string for PHPMailer default, whitespace for none, or a string to use * @type string */ public $XMailer = ''; @@ -459,7 +481,7 @@ /** * An array of all kinds of addresses. - * Includes all of $to, $cc, $bcc, $replyto + * Includes all of $to, $cc, $bcc * @type array * @access protected */ @@ -529,6 +551,13 @@ protected $sign_key_file = ''; /** + * The optional S/MIME extra certificates ("CA Chain") file path. + * @type string + * @access protected + */ + protected $sign_extracerts_file = ''; + + /** * The S/MIME password for the key. * Used only if the key is encrypted. * @type string @@ -538,38 +567,51 @@ /** * Whether to throw exceptions for errors. - * @type bool + * @type boolean * @access protected */ protected $exceptions = false; /** - * Error severity: message only, continue processing + * Unique ID used for message ID and boundaries. + * @type string + * @access protected */ + protected $uniqueid = ''; + + /** + * Error severity: message only, continue processing. + */ const STOP_MESSAGE = 0; /** - * Error severity: message, likely ok to continue processing + * Error severity: message, likely ok to continue processing. */ const STOP_CONTINUE = 1; /** - * Error severity: message, plus full stop, critical error reached + * Error severity: message, plus full stop, critical error reached. */ const STOP_CRITICAL = 2; /** - * SMTP RFC standard line ending + * SMTP RFC standard line ending. */ const CRLF = "\r\n"; /** - * Constructor - * @param bool $exceptions Should we throw external exceptions? + * The maximum line length allowed by RFC 2822 section 2.1.1 + * @type integer */ + const MAX_LINE_LENGTH = 998; + + /** + * Constructor. + * @param boolean $exceptions Should we throw external exceptions? + */ public function __construct($exceptions = false) { - $this->exceptions = ($exceptions == true); + $this->exceptions = (boolean)$exceptions; } /** @@ -577,7 +619,8 @@ */ public function __destruct() { - if ($this->Mailer == 'smtp') { //close any open SMTP connection nicely + //Close any open SMTP connection nicely + if ($this->Mailer == 'smtp') { $this->smtpClose(); } } @@ -593,53 +636,75 @@ * @param string $header Additional Header(s) * @param string $params Params * @access private - * @return bool + * @return boolean */ private function mailPassthru($to, $subject, $body, $header, $params) { + //Check overloading of mail function to avoid double-encoding + if (ini_get('mbstring.func_overload') & 1) { + $subject = $this->secureHeader($subject); + } else { + $subject = $this->encodeHeader($this->secureHeader($subject)); + } if (ini_get('safe_mode') || !($this->UseSendmailOptions)) { - $rt = @mail($to, $this->encodeHeader($this->secureHeader($subject)), $body, $header); + $result = @mail($to, $subject, $body, $header); } else { - $rt = @mail($to, $this->encodeHeader($this->secureHeader($subject)), $body, $header, $params); + $result = @mail($to, $subject, $body, $header, $params); } - return $rt; + return $result; } /** * Output debugging info via user-defined method. - * Only if debug output is enabled. + * Only generates output if SMTP debug output is enabled (@see SMTP::$do_debug). * @see PHPMailer::$Debugoutput * @see PHPMailer::$SMTPDebug * @param string $str */ protected function edebug($str) { - if (!$this->SMTPDebug) { + if ($this->SMTPDebug <= 0) { return; } + //Avoid clash with built-in function names + if (!in_array($this->Debugoutput, array('error_log', 'html', 'echo')) and is_callable($this->Debugoutput)) { + call_user_func($this->Debugoutput, $str, $this->SMTPDebug); + return; + } switch ($this->Debugoutput) { case 'error_log': + //Don't output, just log error_log($str); break; case 'html': - //Cleans up output a bit for a better looking display that's HTML-safe - echo htmlentities(preg_replace('/[\r\n]+/', '', $str), ENT_QUOTES, $this->CharSet) . "
\n"; + //Cleans up output a bit for a better looking, HTML-safe output + echo htmlentities( + preg_replace('/[\r\n]+/', '', $str), + ENT_QUOTES, + 'UTF-8' + ) + . "
\n"; break; case 'echo': default: - //Just echoes exactly what was received - echo $str; + //Normalize line breaks + $str = preg_replace('/(\r\n|\r|\n)/ms', "\n", $str); + echo gmdate('Y-m-d H:i:s') . "\t" . str_replace( + "\n", + "\n \t ", + trim($str) + ) . "\n"; } } /** * Sets message type to HTML or plain. - * @param bool $ishtml True for HTML mode. + * @param boolean $isHtml True for HTML mode. * @return void */ - public function isHTML($ishtml = true) + public function isHTML($isHtml = true) { - if ($ishtml) { + if ($isHtml) { $this->ContentType = 'text/html'; } else { $this->ContentType = 'text/plain'; @@ -670,8 +735,12 @@ */ public function isSendmail() { - if (!stristr(ini_get('sendmail_path'), 'sendmail')) { - $this->Sendmail = '/var/qmail/bin/sendmail'; + $ini_sendmail_path = ini_get('sendmail_path'); + + if (!stristr($ini_sendmail_path, 'sendmail')) { + $this->Sendmail = '/usr/sbin/sendmail'; + } else { + $this->Sendmail = $ini_sendmail_path; } $this->Mailer = 'sendmail'; } @@ -682,17 +751,21 @@ */ public function isQmail() { - if (stristr(ini_get('sendmail_path'), 'qmail')) { - $this->Sendmail = '/var/qmail/bin/sendmail'; + $ini_sendmail_path = ini_get('sendmail_path'); + + if (!stristr($ini_sendmail_path, 'qmail')) { + $this->Sendmail = '/var/qmail/bin/qmail-inject'; + } else { + $this->Sendmail = $ini_sendmail_path; } - $this->Mailer = 'sendmail'; + $this->Mailer = 'qmail'; } /** * Add a "To" address. * @param string $address * @param string $name - * @return bool true on success, false if address already used + * @return boolean true on success, false if address already used */ public function addAddress($address, $name = '') { @@ -704,7 +777,7 @@ * @note: This function works with the SMTP mailer on win32, not with the "mail" mailer. * @param string $address * @param string $name - * @return bool true on success, false if address already used + * @return boolean true on success, false if address already used */ public function addCC($address, $name = '') { @@ -716,7 +789,7 @@ * @note: This function works with the SMTP mailer on win32, not with the "mail" mailer. * @param string $address * @param string $name - * @return bool true on success, false if address already used + * @return boolean true on success, false if address already used */ public function addBCC($address, $name = '') { @@ -727,7 +800,7 @@ * Add a "Reply-to" address. * @param string $address * @param string $name - * @return bool + * @return boolean */ public function addReplyTo($address, $name = '') { @@ -741,27 +814,27 @@ * @param string $address The email address to send to * @param string $name * @throws phpmailerException - * @return bool true on success, false if address already used or invalid in some way + * @return boolean true on success, false if address already used or invalid in some way * @access protected */ protected function addAnAddress($kind, $address, $name = '') { if (!preg_match('/^(to|cc|bcc|Reply-To)$/', $kind)) { $this->setError($this->lang('Invalid recipient array') . ': ' . $kind); + $this->edebug($this->lang('Invalid recipient array') . ': ' . $kind); if ($this->exceptions) { throw new phpmailerException('Invalid recipient array: ' . $kind); } - $this->edebug($this->lang('Invalid recipient array') . ': ' . $kind); return false; } $address = trim($address); $name = trim(preg_replace('/[\r\n]+/', '', $name)); //Strip breaks and trim if (!$this->validateAddress($address)) { $this->setError($this->lang('invalid_address') . ': ' . $address); + $this->edebug($this->lang('invalid_address') . ': ' . $address); if ($this->exceptions) { throw new phpmailerException($this->lang('invalid_address') . ': ' . $address); } - $this->edebug($this->lang('invalid_address') . ': ' . $address); return false; } if ($kind != 'Reply-To') { @@ -783,9 +856,9 @@ * Set the From and FromName properties. * @param string $address * @param string $name - * @param bool $auto Whether to also set the Sender address, defaults to true + * @param boolean $auto Whether to also set the Sender address, defaults to true * @throws phpmailerException - * @return bool + * @return boolean */ public function setFrom($address, $name = '', $auto = true) { @@ -793,10 +866,10 @@ $name = trim(preg_replace('/[\r\n]+/', '', $name)); //Strip breaks and trim if (!$this->validateAddress($address)) { $this->setError($this->lang('invalid_address') . ': ' . $address); + $this->edebug($this->lang('invalid_address') . ': ' . $address); if ($this->exceptions) { throw new phpmailerException($this->lang('invalid_address') . ': ' . $address); } - $this->edebug($this->lang('invalid_address') . ': ' . $address); return false; } $this->From = $address; @@ -825,27 +898,31 @@ * Check that a string looks like an email address. * @param string $address The email address to check * @param string $patternselect A selector for the validation pattern to use : - * 'auto' - pick best one automatically; - * 'pcre8' - use the squiloople.com pattern, requires PCRE > 8.0, PHP >= 5.3.2, 5.2.14; - * 'pcre' - use old PCRE implementation; - * 'php' - use PHP built-in FILTER_VALIDATE_EMAIL; faster, less thorough; - * 'noregex' - super fast, really dumb. - * @return bool + * * `auto` Pick strictest one automatically; + * * `pcre8` Use the squiloople.com pattern, requires PCRE > 8.0, PHP >= 5.3.2, 5.2.14; + * * `pcre` Use old PCRE implementation; + * * `php` Use PHP built-in FILTER_VALIDATE_EMAIL; same as pcre8 but does not allow 'dotless' domains; + * * `html5` Use the pattern given by the HTML5 spec for 'email' type form input elements. + * * `noregex` Don't use a regex: super fast, really dumb. + * @return boolean * @static * @access public */ public static function validateAddress($address, $patternselect = 'auto') { - if ($patternselect == 'auto') { - if (defined( - 'PCRE_VERSION' - ) - ) { //Check this instead of extension_loaded so it works when that function is disabled - if (version_compare(PCRE_VERSION, '8.0') >= 0) { + if (!$patternselect or $patternselect == 'auto') { + //Check this constant first so it works when extension_loaded() is disabled by safe mode + //Constant was added in PHP 5.2.4 + if (defined('PCRE_VERSION')) { + //This pattern can get stuck in a recursive loop in PCRE <= 8.0.2 + if (version_compare(PCRE_VERSION, '8.0.3') >= 0) { $patternselect = 'pcre8'; } else { $patternselect = 'pcre'; } + } elseif (function_exists('extension_loaded') and extension_loaded('pcre')) { + //Fall back to older PCRE + $patternselect = 'pcre'; } else { //Filter_var appeared in PHP 5.2.0 and does not require the PCRE extension if (version_compare(PHP_VERSION, '5.2.0') >= 0) { @@ -858,14 +935,12 @@ switch ($patternselect) { case 'pcre8': /** - * Conforms to RFC5322: Uses *correct* regex on which FILTER_VALIDATE_EMAIL is - * based; So why not use FILTER_VALIDATE_EMAIL? Because it was broken to - * not allow a@b type valid addresses :( + * Uses the same RFC5322 regex on which FILTER_VALIDATE_EMAIL is based, but allows dotless domains. * @link http://squiloople.com/2009/12/20/email-address-validation/ * @copyright 2009-2010 Michael Rushton * Feel free to use and redistribute this code. But please keep this copyright notice. */ - return (bool)preg_match( + return (boolean)preg_match( '/^(?!(?>(?1)"?(?>\\\[ -~]|[^"])"?(?1)){255,})(?!(?>(?1)"?(?>\\\[ -~]|[^"])"?(?1)){65,}@)' . '((?>(?>(?>((?>(?>(?>\x0D\x0A)?[\t ])+|(?>[\t ]*\x0D\x0A)?[\t ]+)?)(\((?>(?2)' . '(?>[\x01-\x08\x0B\x0C\x0E-\'*-\[\]-\x7F]|\\\[\x00-\x7F]|(?3)))*(?2)\)))+(?2))|(?2))?)' . @@ -877,10 +952,9 @@ '|[1-9]?[0-9])(?>\.(?9)){3}))\])(?1)$/isD', $address ); - break; case 'pcre': //An older regex that doesn't need a recent PCRE - return (bool)preg_match( + return (boolean)preg_match( '/^(?!(?>"?(?>\\\[ -~]|[^"])"?){255,})(?!(?>"?(?>\\\[ -~]|[^"])"?){65,}@)(?>' . '[!#-\'*+\/-9=?^-~-]+|"(?>(?>[\x01-\x08\x0B\x0C\x0E-!#-\[\]-\x7F]|\\\[\x00-\xFF]))*")' . '(?>\.(?>[!#-\'*+\/-9=?^-~-]+|"(?>(?>[\x01-\x08\x0B\x0C\x0E-!#-\[\]-\x7F]|\\\[\x00-\xFF]))*"))*' . @@ -893,27 +967,33 @@ '|[1-9]?[0-9])(?>\.(?>25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])){3}))\])$/isD', $address ); - break; - case 'php': - default: - return (bool)filter_var($address, FILTER_VALIDATE_EMAIL); - break; + case 'html5': + /** + * This is the pattern used in the HTML5 spec for validation of 'email' type form input elements. + * @link http://www.whatwg.org/specs/web-apps/current-work/#e-mail-state-(type=email) + */ + return (boolean)preg_match( + '/^[a-zA-Z0-9.!#$%&\'*+\/=?^_`{|}~-]+@[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}' . + '[a-zA-Z0-9])?(?:\.[a-zA-Z0-9](?:[a-zA-Z0-9-]{0,61}[a-zA-Z0-9])?)*$/sD', + $address + ); case 'noregex': //No PCRE! Do something _very_ approximate! //Check the address is 3 chars or longer and contains an @ that's not the first or last char return (strlen($address) >= 3 and strpos($address, '@') >= 1 and strpos($address, '@') != strlen($address) - 1); - break; + case 'php': + default: + return (boolean)filter_var($address, FILTER_VALIDATE_EMAIL); } } /** * Create a message and send it. * Uses the sending method specified by $Mailer. - * Returns false on error - Use the ErrorInfo variable to view description of the error. * @throws phpmailerException - * @return bool + * @return boolean false on error - See the ErrorInfo property for details of the error. */ public function send() { @@ -922,11 +1002,11 @@ return false; } return $this->postSend(); - } catch (phpmailerException $e) { + } catch (phpmailerException $exc) { $this->mailHeader = ''; - $this->setError($e->getMessage()); + $this->setError($exc->getMessage()); if ($this->exceptions) { - throw $e; + throw $exc; } return false; } @@ -935,12 +1015,12 @@ /** * Prepare a message for sending. * @throws phpmailerException - * @return bool + * @return boolean */ public function preSend() { try { - $this->mailHeader = ""; + $this->mailHeader = ''; if ((count($this->to) + count($this->cc) + count($this->bcc)) < 1) { throw new phpmailerException($this->lang('provide_address'), self::STOP_CRITICAL); } @@ -950,23 +1030,28 @@ $this->ContentType = 'multipart/alternative'; } - $this->error_count = 0; // reset errors + $this->error_count = 0; // Reset errors $this->setMessageType(); // Refuse to send an empty message unless we are specifically allowing it if (!$this->AllowEmpty and empty($this->Body)) { throw new phpmailerException($this->lang('empty_message'), self::STOP_CRITICAL); } + // Create body before headers in case body makes changes to headers (e.g. altering transfer encoding) + $this->MIMEHeader = ''; + $this->MIMEBody = $this->createBody(); + // createBody may have added some headers, so retain them + $tempheaders = $this->MIMEHeader; $this->MIMEHeader = $this->createHeader(); - $this->MIMEBody = $this->createBody(); + $this->MIMEHeader .= $tempheaders; // To capture the complete message when using mail(), create // an extra header list which createHeader() doesn't fold in if ($this->Mailer == 'mail') { if (count($this->to) > 0) { - $this->mailHeader .= $this->addrAppend("To", $this->to); + $this->mailHeader .= $this->addrAppend('To', $this->to); } else { - $this->mailHeader .= $this->headerLine("To", "undisclosed-recipients:;"); + $this->mailHeader .= $this->headerLine('To', 'undisclosed-recipients:;'); } $this->mailHeader .= $this->headerLine( 'Subject', @@ -978,7 +1063,6 @@ if (!empty($this->DKIM_domain) && !empty($this->DKIM_private) && !empty($this->DKIM_selector) - && !empty($this->DKIM_domain) && file_exists($this->DKIM_private)) { $header_dkim = $this->DKIM_Add( $this->MIMEHeader . $this->mailHeader, @@ -989,11 +1073,10 @@ str_replace("\r\n", "\n", $header_dkim) . self::CRLF; } return true; - - } catch (phpmailerException $e) { - $this->setError($e->getMessage()); + } catch (phpmailerException $exc) { + $this->setError($exc->getMessage()); if ($this->exceptions) { - throw $e; + throw $exc; } return false; } @@ -1003,7 +1086,7 @@ * Actually send a message. * Send the email via the selected mechanism * @throws phpmailerException - * @return bool + * @return boolean */ public function postSend() { @@ -1011,20 +1094,26 @@ // Choose the mailer and send through it switch ($this->Mailer) { case 'sendmail': + case 'qmail': return $this->sendmailSend($this->MIMEHeader, $this->MIMEBody); case 'smtp': return $this->smtpSend($this->MIMEHeader, $this->MIMEBody); case 'mail': return $this->mailSend($this->MIMEHeader, $this->MIMEBody); default: + $sendMethod = $this->Mailer.'Send'; + if (method_exists($this, $sendMethod)) { + return $this->$sendMethod($this->MIMEHeader, $this->MIMEBody); + } + return $this->mailSend($this->MIMEHeader, $this->MIMEBody); } - } catch (phpmailerException $e) { - $this->setError($e->getMessage()); + } catch (phpmailerException $exc) { + $this->setError($exc->getMessage()); + $this->edebug($exc->getMessage()); if ($this->exceptions) { - throw $e; + throw $exc; } - $this->edebug($e->getMessage() . "\n"); } return false; } @@ -1036,27 +1125,41 @@ * @see PHPMailer::$Sendmail * @throws phpmailerException * @access protected - * @return bool + * @return boolean */ protected function sendmailSend($header, $body) { if ($this->Sender != '') { - $sendmail = sprintf("%s -oi -f%s -t", escapeshellcmd($this->Sendmail), escapeshellarg($this->Sender)); + if ($this->Mailer == 'qmail') { + $sendmail = sprintf('%s -f%s', escapeshellcmd($this->Sendmail), escapeshellarg($this->Sender)); + } else { + $sendmail = sprintf('%s -oi -f%s -t', escapeshellcmd($this->Sendmail), escapeshellarg($this->Sender)); + } } else { - $sendmail = sprintf("%s -oi -t", escapeshellcmd($this->Sendmail)); + if ($this->Mailer == 'qmail') { + $sendmail = sprintf('%s', escapeshellcmd($this->Sendmail)); + } else { + $sendmail = sprintf('%s -oi -t', escapeshellcmd($this->Sendmail)); + } } - if ($this->SingleTo === true) { - foreach ($this->SingleToArray as $val) { + if ($this->SingleTo) { + foreach ($this->SingleToArray as $toAddr) { if (!@$mail = popen($sendmail, 'w')) { throw new phpmailerException($this->lang('execute') . $this->Sendmail, self::STOP_CRITICAL); } - fputs($mail, "To: " . $val . "\n"); + fputs($mail, 'To: ' . $toAddr . "\n"); fputs($mail, $header); fputs($mail, $body); $result = pclose($mail); - // implement call back function if it exists - $isSent = ($result == 0) ? 1 : 0; - $this->doCallback($isSent, $val, $this->cc, $this->bcc, $this->Subject, $body, $this->From); + $this->doCallback( + ($result == 0), + array($toAddr), + $this->cc, + $this->bcc, + $this->Subject, + $body, + $this->From + ); if ($result != 0) { throw new phpmailerException($this->lang('execute') . $this->Sendmail, self::STOP_CRITICAL); } @@ -1068,9 +1171,7 @@ fputs($mail, $header); fputs($mail, $body); $result = pclose($mail); - // implement call back function if it exists - $isSent = ($result == 0) ? 1 : 0; - $this->doCallback($isSent, $this->to, $this->cc, $this->bcc, $this->Subject, $body, $this->From); + $this->doCallback(($result == 0), $this->to, $this->cc, $this->bcc, $this->Subject, $body, $this->From); if ($result != 0) { throw new phpmailerException($this->lang('execute') . $this->Sendmail, self::STOP_CRITICAL); } @@ -1085,43 +1186,39 @@ * @link http://www.php.net/manual/en/book.mail.php * @throws phpmailerException * @access protected - * @return bool + * @return boolean */ protected function mailSend($header, $body) { $toArr = array(); - foreach ($this->to as $t) { - $toArr[] = $this->addrFormat($t); + foreach ($this->to as $toaddr) { + $toArr[] = $this->addrFormat($toaddr); } $to = implode(', ', $toArr); if (empty($this->Sender)) { - $params = " "; + $params = ' '; } else { - $params = sprintf("-f%s", $this->Sender); + $params = sprintf('-f%s', $this->Sender); } if ($this->Sender != '' and !ini_get('safe_mode')) { $old_from = ini_get('sendmail_from'); ini_set('sendmail_from', $this->Sender); } - $rt = false; - if ($this->SingleTo === true && count($toArr) > 1) { - foreach ($toArr as $val) { - $rt = $this->mailPassthru($val, $this->Subject, $body, $header, $params); - // implement call back function if it exists - $isSent = ($rt == 1) ? 1 : 0; - $this->doCallback($isSent, $val, $this->cc, $this->bcc, $this->Subject, $body, $this->From); + $result = false; + if ($this->SingleTo && count($toArr) > 1) { + foreach ($toArr as $toAddr) { + $result = $this->mailPassthru($toAddr, $this->Subject, $body, $header, $params); + $this->doCallback($result, array($toAddr), $this->cc, $this->bcc, $this->Subject, $body, $this->From); } } else { - $rt = $this->mailPassthru($to, $this->Subject, $body, $header, $params); - // implement call back function if it exists - $isSent = ($rt == 1) ? 1 : 0; - $this->doCallback($isSent, $to, $this->cc, $this->bcc, $this->Subject, $body, $this->From); + $result = $this->mailPassthru($to, $this->Subject, $body, $header, $params); + $this->doCallback($result, $this->to, $this->cc, $this->bcc, $this->Subject, $body, $this->From); } if (isset($old_from)) { ini_set('sendmail_from', $old_from); } - if (!$rt) { + if (!$result) { throw new phpmailerException($this->lang('instantiate'), self::STOP_CRITICAL); } return true; @@ -1135,7 +1232,7 @@ public function getSMTPInstance() { if (!is_object($this->smtp)) { - require_once 'class-smtp.php'; + require_once( 'class-smtp.php' ); $this->smtp = new SMTP; } return $this->smtp; @@ -1151,62 +1248,59 @@ * @throws phpmailerException * @uses SMTP * @access protected - * @return bool + * @return boolean */ protected function smtpSend($header, $body) { $bad_rcpt = array(); - - if (!$this->smtpConnect()) { + if (!$this->smtpConnect($this->SMTPOptions)) { throw new phpmailerException($this->lang('smtp_connect_failed'), self::STOP_CRITICAL); } - $smtp_from = ($this->Sender == '') ? $this->From : $this->Sender; + if ('' == $this->Sender) { + $smtp_from = $this->From; + } else { + $smtp_from = $this->Sender; + } if (!$this->smtp->mail($smtp_from)) { $this->setError($this->lang('from_failed') . $smtp_from . ' : ' . implode(',', $this->smtp->getError())); throw new phpmailerException($this->ErrorInfo, self::STOP_CRITICAL); } - // Attempt to send attach all recipients - foreach ($this->to as $to) { - if (!$this->smtp->recipient($to[0])) { - $bad_rcpt[] = $to[0]; - $isSent = 0; - } else { - $isSent = 1; + // Attempt to send to all recipients + foreach (array($this->to, $this->cc, $this->bcc) as $togroup) { + foreach ($togroup as $to) { + if (!$this->smtp->recipient($to[0])) { + $error = $this->smtp->getError(); + $bad_rcpt[] = array('to' => $to[0], 'error' => $error['detail']); + $isSent = false; + } else { + $isSent = true; + } + $this->doCallback($isSent, array($to[0]), array(), array(), $this->Subject, $body, $this->From); } - $this->doCallback($isSent, $to[0], '', '', $this->Subject, $body, $this->From); } - foreach ($this->cc as $cc) { - if (!$this->smtp->recipient($cc[0])) { - $bad_rcpt[] = $cc[0]; - $isSent = 0; - } else { - $isSent = 1; - } - $this->doCallback($isSent, '', $cc[0], '', $this->Subject, $body, $this->From); - } - foreach ($this->bcc as $bcc) { - if (!$this->smtp->recipient($bcc[0])) { - $bad_rcpt[] = $bcc[0]; - $isSent = 0; - } else { - $isSent = 1; - } - $this->doCallback($isSent, '', '', $bcc[0], $this->Subject, $body, $this->From); - } - if (count($bad_rcpt) > 0) { //Create error message for any bad addresses - throw new phpmailerException($this->lang('recipients_failed') . implode(', ', $bad_rcpt)); - } - if (!$this->smtp->data($header . $body)) { + // Only send the DATA command if we have viable recipients + if ((count($this->all_recipients) > count($bad_rcpt)) and !$this->smtp->data($header . $body)) { throw new phpmailerException($this->lang('data_not_accepted'), self::STOP_CRITICAL); } - if ($this->SMTPKeepAlive == true) { + if ($this->SMTPKeepAlive) { $this->smtp->reset(); } else { $this->smtp->quit(); $this->smtp->close(); } + //Create error message for any bad addresses + if (count($bad_rcpt) > 0) { + $errstr = ''; + foreach ($bad_rcpt as $bad) { + $errstr .= $bad['to'] . ': ' . $bad['error']; + } + throw new phpmailerException( + $this->lang('recipients_failed') . $errstr, + self::STOP_CONTINUE + ); + } return true; } @@ -1217,7 +1311,7 @@ * @uses SMTP * @access public * @throws phpmailerException - * @return bool + * @return boolean */ public function smtpConnect($options = array()) { @@ -1225,7 +1319,7 @@ $this->smtp = $this->getSMTPInstance(); } - //Already connected? + // Already connected? if ($this->smtp->connected()) { return true; } @@ -1234,25 +1328,47 @@ $this->smtp->setDebugLevel($this->SMTPDebug); $this->smtp->setDebugOutput($this->Debugoutput); $this->smtp->setVerp($this->do_verp); - $tls = ($this->SMTPSecure == 'tls'); - $ssl = ($this->SMTPSecure == 'ssl'); $hosts = explode(';', $this->Host); $lastexception = null; foreach ($hosts as $hostentry) { $hostinfo = array(); - $host = $hostentry; + if (!preg_match('/^((ssl|tls):\/\/)*([a-zA-Z0-9\.-]*):?([0-9]*)$/', trim($hostentry), $hostinfo)) { + // Not a valid host entry + continue; + } + // $hostinfo[2]: optional ssl or tls prefix + // $hostinfo[3]: the hostname + // $hostinfo[4]: optional port number + // The host string prefix can temporarily override the current setting for SMTPSecure + // If it's not specified, the default value is used + $prefix = ''; + $secure = $this->SMTPSecure; + $tls = ($this->SMTPSecure == 'tls'); + if ('ssl' == $hostinfo[2] or ('' == $hostinfo[2] and 'ssl' == $this->SMTPSecure)) { + $prefix = 'ssl://'; + $tls = false; // Can't have SSL and TLS at the same time + $secure = 'ssl'; + } elseif ($hostinfo[2] == 'tls') { + $tls = true; + // tls doesn't use a prefix + $secure = 'tls'; + } + //Do we need the OpenSSL extension? + $sslext = defined('OPENSSL_ALGO_SHA1'); + if ('tls' === $secure or 'ssl' === $secure) { + //Check for an OpenSSL constant rather than using extension_loaded, which is sometimes disabled + if (!$sslext) { + throw new phpmailerException($this->lang('extension_missing').'openssl', self::STOP_CRITICAL); + } + } + $host = $hostinfo[3]; $port = $this->Port; - if (preg_match( - '/^(.+):([0-9]+)$/', - $hostentry, - $hostinfo - ) - ) { //If $hostentry contains 'address:port', override default - $host = $hostinfo[1]; - $port = $hostinfo[2]; + $tport = (integer)$hostinfo[4]; + if ($tport > 0 and $tport < 65536) { + $port = $tport; } - if ($this->smtp->connect(($ssl ? 'ssl://' : '') . $host, $port, $this->Timeout, $options)) { + if ($this->smtp->connect($prefix . $host, $port, $this->Timeout, $options)) { try { if ($this->Helo) { $hello = $this->Helo; @@ -1260,12 +1376,19 @@ $hello = $this->serverHostname(); } $this->smtp->hello($hello); - + //Automatically enable TLS encryption if: + // * it's not disabled + // * we have openssl extension + // * we are not already using SSL + // * the server offers STARTTLS + if ($this->SMTPAutoTLS and $sslext and $secure != 'ssl' and $this->smtp->getServerExt('STARTTLS')) { + $tls = true; + } if ($tls) { if (!$this->smtp->startTLS()) { throw new phpmailerException($this->lang('connect_host')); } - //We must resend HELO after tls negotiation + // We must resend HELO after tls negotiation $this->smtp->hello($hello); } if ($this->SMTPAuth) { @@ -1281,16 +1404,17 @@ } } return true; - } catch (phpmailerException $e) { - $lastexception = $e; - //We must have connected, but then failed TLS or Auth, so close connection nicely + } catch (phpmailerException $exc) { + $lastexception = $exc; + $this->edebug($exc->getMessage()); + // We must have connected, but then failed TLS or Auth, so close connection nicely $this->smtp->quit(); } } } - //If we get here, all connection attempts have failed, so close connection hard + // If we get here, all connection attempts have failed, so close connection hard $this->smtp->close(); - //As we've caught all exceptions, just report whatever the last one was + // As we've caught all exceptions, just report whatever the last one was if ($this->exceptions and !is_null($lastexception)) { throw $lastexception; } @@ -1317,12 +1441,12 @@ * The default language is English. * @param string $langcode ISO 639-1 2-character language code (e.g. French is "fr") * @param string $lang_path Path to the language file directory, with trailing separator (slash) - * @return bool + * @return boolean * @access public */ - public function setLanguage($langcode = 'en', $lang_path = 'language/') + public function setLanguage($langcode = 'en', $lang_path = '') { - //Define full set of translatable strings + // Define full set of translatable strings in English $PHPMAILER_LANG = array( 'authenticate' => 'SMTP Error: Could not authenticate.', 'connect_host' => 'SMTP Error: Could not connect to SMTP host.', @@ -1341,16 +1465,28 @@ 'signing' => 'Signing Error: ', 'smtp_connect_failed' => 'SMTP connect() failed.', 'smtp_error' => 'SMTP server error: ', - 'variable_set' => 'Cannot set or reset variable: ' + 'variable_set' => 'Cannot set or reset variable: ', + 'extension_missing' => 'Extension missing: ' ); - //Overwrite language-specific strings. - //This way we'll never have missing translations - no more "language string failed to load"! - $l = true; - if ($langcode != 'en') { //There is no English translation file - $l = @include $lang_path . 'phpmailer.lang-' . $langcode . '.php'; + if (empty($lang_path)) { + // Calculate an absolute path so it can work if CWD is not here + $lang_path = dirname(__FILE__). DIRECTORY_SEPARATOR . 'language'. DIRECTORY_SEPARATOR; } + $foundlang = true; + $lang_file = $lang_path . 'phpmailer.lang-' . $langcode . '.php'; + // There is no English translation file + if ($langcode != 'en') { + // Make sure language file path is readable + if (!is_readable($lang_file)) { + $foundlang = false; + } else { + // Overwrite language-specific strings. + // This way we'll never have missing translation keys. + $foundlang = include $lang_file; + } + } $this->language = $PHPMAILER_LANG; - return ($l == true); //Returns false if language not found + return (boolean)$foundlang; // Returns false if language not found } /** @@ -1375,8 +1511,8 @@ public function addrAppend($type, $addr) { $addresses = array(); - foreach ($addr as $a) { - $addresses[] = $this->addrFormat($a); + foreach ($addr as $address) { + $addresses[] = $this->addrFormat($address); } return $type . ': ' . implode(', ', $addresses) . $this->LE; } @@ -1393,9 +1529,9 @@ if (empty($addr[1])) { // No name provided return $this->secureHeader($addr[0]); } else { - return $this->encodeHeader($this->secureHeader($addr[1]), 'phrase') . " <" . $this->secureHeader( + return $this->encodeHeader($this->secureHeader($addr[1]), 'phrase') . ' <' . $this->secureHeader( $addr[0] - ) . ">"; + ) . '>'; } } @@ -1406,47 +1542,54 @@ * Original written by philippe. * @param string $message The message to wrap * @param integer $length The line length to wrap to - * @param bool $qp_mode Whether to run in Quoted-Printable mode + * @param boolean $qp_mode Whether to run in Quoted-Printable mode * @access public * @return string */ public function wrapText($message, $length, $qp_mode = false) { - $soft_break = ($qp_mode) ? sprintf(" =%s", $this->LE) : $this->LE; + if ($qp_mode) { + $soft_break = sprintf(' =%s', $this->LE); + } else { + $soft_break = $this->LE; + } // If utf-8 encoding is used, we will need to make sure we don't // split multibyte characters when we wrap - $is_utf8 = (strtolower($this->CharSet) == "utf-8"); + $is_utf8 = (strtolower($this->CharSet) == 'utf-8'); $lelen = strlen($this->LE); $crlflen = strlen(self::CRLF); $message = $this->fixEOL($message); + //Remove a trailing line break if (substr($message, -$lelen) == $this->LE) { $message = substr($message, 0, -$lelen); } - $line = explode($this->LE, $message); // Magic. We know fixEOL uses $LE + //Split message into lines + $lines = explode($this->LE, $message); + //Message will be rebuilt in here $message = ''; - for ($i = 0; $i < count($line); $i++) { - $line_part = explode(' ', $line[$i]); + foreach ($lines as $line) { + $words = explode(' ', $line); $buf = ''; - for ($e = 0; $e < count($line_part); $e++) { - $word = $line_part[$e]; + $firstword = true; + foreach ($words as $word) { if ($qp_mode and (strlen($word) > $length)) { $space_left = $length - strlen($buf) - $crlflen; - if ($e != 0) { + if (!$firstword) { if ($space_left > 20) { $len = $space_left; if ($is_utf8) { $len = $this->utf8CharBoundary($word, $len); - } elseif (substr($word, $len - 1, 1) == "=") { + } elseif (substr($word, $len - 1, 1) == '=') { $len--; - } elseif (substr($word, $len - 2, 1) == "=") { + } elseif (substr($word, $len - 2, 1) == '=') { $len -= 2; } $part = substr($word, 0, $len); $word = substr($word, $len); $buf .= ' ' . $part; - $message .= $buf . sprintf("=%s", self::CRLF); + $message .= $buf . sprintf('=%s', self::CRLF); } else { $message .= $buf . $soft_break; } @@ -1459,29 +1602,33 @@ $len = $length; if ($is_utf8) { $len = $this->utf8CharBoundary($word, $len); - } elseif (substr($word, $len - 1, 1) == "=") { + } elseif (substr($word, $len - 1, 1) == '=') { $len--; - } elseif (substr($word, $len - 2, 1) == "=") { + } elseif (substr($word, $len - 2, 1) == '=') { $len -= 2; } $part = substr($word, 0, $len); $word = substr($word, $len); if (strlen($word) > 0) { - $message .= $part . sprintf("=%s", self::CRLF); + $message .= $part . sprintf('=%s', self::CRLF); } else { $buf = $part; } } } else { $buf_o = $buf; - $buf .= ($e == 0) ? $word : (' ' . $word); + if (!$firstword) { + $buf .= ' '; + } + $buf .= $word; if (strlen($buf) > $length and $buf_o != '') { $message .= $buf_o . $soft_break; $buf = $word; } } + $firstword = false; } $message .= $buf . self::CRLF; } @@ -1491,12 +1638,12 @@ /** * Find the last character boundary prior to $maxLength in a utf-8 - * quoted (printable) encoded string. + * quoted-printable encoded string. * Original written by Colin Brown. * @access public * @param string $encodedText utf-8 QP text - * @param int $maxLength find last character boundary prior to this length - * @return int + * @param integer $maxLength Find the last character boundary prior to this length + * @return integer */ public function utf8CharBoundary($encodedText, $maxLength) { @@ -1504,23 +1651,27 @@ $lookBack = 3; while (!$foundSplitPos) { $lastChunk = substr($encodedText, $maxLength - $lookBack, $lookBack); - $encodedCharPos = strpos($lastChunk, "="); - if ($encodedCharPos !== false) { + $encodedCharPos = strpos($lastChunk, '='); + if (false !== $encodedCharPos) { // Found start of encoded character byte within $lookBack block. // Check the encoded byte value (the 2 chars after the '=') $hex = substr($encodedText, $maxLength - $lookBack + $encodedCharPos + 1, 2); $dec = hexdec($hex); - if ($dec < 128) { // Single byte character. + if ($dec < 128) { + // Single byte character. // If the encoded char was found at pos 0, it will fit // otherwise reduce maxLength to start of the encoded char - $maxLength = ($encodedCharPos == 0) ? $maxLength : - $maxLength - ($lookBack - $encodedCharPos); + if ($encodedCharPos > 0) { + $maxLength = $maxLength - ($lookBack - $encodedCharPos); + } $foundSplitPos = true; - } elseif ($dec >= 192) { // First byte of a multi byte character + } elseif ($dec >= 192) { + // First byte of a multi byte character // Reduce maxLength to split at start of character $maxLength = $maxLength - ($lookBack - $encodedCharPos); $foundSplitPos = true; - } elseif ($dec < 192) { // Middle byte of a multi byte character, look further back + } elseif ($dec < 192) { + // Middle byte of a multi byte character, look further back $lookBack += 3; } } else { @@ -1531,9 +1682,11 @@ return $maxLength; } - /** - * Set the body wrapping. + * Apply word wrapping to the message body. + * Wraps the message body to the number of chars set in the WordWrap property. + * You should only do this to plain-text bodies as wrapping HTML tags may break them. + * This is called automatically by createBody(), so you don't need to call it yourself. * @access public * @return void */ @@ -1565,38 +1718,26 @@ { $result = ''; - // Set the boundaries - $uniq_id = md5(uniqid(time())); - $this->boundary[1] = 'b1_' . $uniq_id; - $this->boundary[2] = 'b2_' . $uniq_id; - $this->boundary[3] = 'b3_' . $uniq_id; - if ($this->MessageDate == '') { - $result .= $this->headerLine('Date', self::rfcDate()); - } else { - $result .= $this->headerLine('Date', $this->MessageDate); + $this->MessageDate = self::rfcDate(); } + $result .= $this->headerLine('Date', $this->MessageDate); - if ($this->ReturnPath) { - $result .= $this->headerLine('Return-Path', '<' . trim($this->ReturnPath) . '>'); - } elseif ($this->Sender == '') { - $result .= $this->headerLine('Return-Path', '<' . trim($this->From) . '>'); - } else { - $result .= $this->headerLine('Return-Path', '<' . trim($this->Sender) . '>'); - } // To be created automatically by mail() - if ($this->Mailer != 'mail') { - if ($this->SingleTo === true) { - foreach ($this->to as $t) { - $this->SingleToArray[] = $this->addrFormat($t); + if ($this->SingleTo) { + if ($this->Mailer != 'mail') { + foreach ($this->to as $toaddr) { + $this->SingleToArray[] = $this->addrFormat($toaddr); } - } else { - if (count($this->to) > 0) { + } + } else { + if (count($this->to) > 0) { + if ($this->Mailer != 'mail') { $result .= $this->addrAppend('To', $this->to); - } elseif (count($this->cc) == 0) { - $result .= $this->headerLine('To', 'undisclosed-recipients:;'); } + } elseif (count($this->cc) == 0) { + $result .= $this->headerLine('To', 'undisclosed-recipients:;'); } } @@ -1608,7 +1749,11 @@ } // sendmail and mail() extract Bcc from the header before sending - if ((($this->Mailer == 'sendmail') || ($this->Mailer == 'mail')) && (count($this->bcc) > 0)) { + if (( + $this->Mailer == 'sendmail' or $this->Mailer == 'qmail' or $this->Mailer == 'mail' + ) + and count($this->bcc) > 0 + ) { $result .= $this->addrAppend('Bcc', $this->bcc); } @@ -1624,9 +1769,9 @@ if ($this->MessageID != '') { $this->lastMessageID = $this->MessageID; } else { - $this->lastMessageID = sprintf("<%s@%s>", $uniq_id, $this->ServerHostname()); + $this->lastMessageID = sprintf('<%s@%s>', $this->uniqueid, $this->ServerHostname()); } - $result .= $this->HeaderLine('Message-ID', $this->lastMessageID); + $result .= $this->headerLine('Message-ID', $this->lastMessageID); $result .= $this->headerLine('X-Priority', $this->Priority); if ($this->XMailer == '') { $result .= $this->headerLine( @@ -1645,10 +1790,10 @@ } // Add custom headers - for ($index = 0; $index < count($this->CustomHeader); $index++) { + foreach ($this->CustomHeader as $header) { $result .= $this->headerLine( - trim($this->CustomHeader[$index][0]), - $this->encodeHeader(trim($this->CustomHeader[$index][1])) + trim($header[0]), + $this->encodeHeader(trim($header[1])) ); } if (!$this->sign_key_file) { @@ -1667,6 +1812,7 @@ public function getMailMIME() { $result = ''; + $ismultipart = true; switch ($this->message_type) { case 'inline': $result .= $this->headerLine('Content-Type', 'multipart/related;'); @@ -1687,11 +1833,20 @@ default: // Catches case 'plain': and case '': $result .= $this->textLine('Content-Type: ' . $this->ContentType . '; charset=' . $this->CharSet); + $ismultipart = false; break; } - //RFC1341 part 5 says 7bit is assumed if not specified + // RFC1341 part 5 says 7bit is assumed if not specified if ($this->Encoding != '7bit') { - $result .= $this->headerLine('Content-Transfer-Encoding', $this->Encoding); + // RFC 2045 section 6.4 says multipart MIME parts may only use 7bit, 8bit or binary CTE + if ($ismultipart) { + if ($this->Encoding == '8bit') { + $result .= $this->headerLine('Content-Transfer-Encoding', '8bit'); + } + // The only remaining alternatives are quoted-printable and base64, which are both 7bit compatible + } else { + $result .= $this->headerLine('Content-Transfer-Encoding', $this->Encoding); + } } if ($this->Mailer != 'mail') { @@ -1704,8 +1859,8 @@ /** * Returns the whole MIME message. * Includes complete headers and body. - * Only valid post PreSend(). - * @see PHPMailer::PreSend() + * Only valid post preSend(). + * @see PHPMailer::preSend() * @access public * @return string */ @@ -1714,7 +1869,6 @@ return $this->MIMEHeader . $this->mailHeader . self::CRLF . $this->MIMEBody; } - /** * Assemble the message body. * Returns an empty string on failure. @@ -1725,6 +1879,11 @@ public function createBody() { $body = ''; + //Create unique IDs and preset boundaries + $this->uniqueid = md5(uniqid(time())); + $this->boundary[1] = 'b1_' . $this->uniqueid; + $this->boundary[2] = 'b2_' . $this->uniqueid; + $this->boundary[3] = 'b3_' . $this->uniqueid; if ($this->sign_key_file) { $body .= $this->getMailMIME() . $this->LE; @@ -1732,37 +1891,67 @@ $this->setWordWrap(); + $bodyEncoding = $this->Encoding; + $bodyCharSet = $this->CharSet; + //Can we do a 7-bit downgrade? + if ($bodyEncoding == '8bit' and !$this->has8bitChars($this->Body)) { + $bodyEncoding = '7bit'; + $bodyCharSet = 'us-ascii'; + } + //If lines are too long, change to quoted-printable transfer encoding + if (self::hasLineLongerThanMax($this->Body)) { + $this->Encoding = 'quoted-printable'; + $bodyEncoding = 'quoted-printable'; + } + + $altBodyEncoding = $this->Encoding; + $altBodyCharSet = $this->CharSet; + //Can we do a 7-bit downgrade? + if ($altBodyEncoding == '8bit' and !$this->has8bitChars($this->AltBody)) { + $altBodyEncoding = '7bit'; + $altBodyCharSet = 'us-ascii'; + } + //If lines are too long, change to quoted-printable transfer encoding + if (self::hasLineLongerThanMax($this->AltBody)) { + $altBodyEncoding = 'quoted-printable'; + } + //Use this as a preamble in all multipart message types + $mimepre = "This is a multi-part message in MIME format." . $this->LE . $this->LE; switch ($this->message_type) { case 'inline': - $body .= $this->getBoundary($this->boundary[1], '', '', ''); - $body .= $this->encodeString($this->Body, $this->Encoding); + $body .= $mimepre; + $body .= $this->getBoundary($this->boundary[1], $bodyCharSet, '', $bodyEncoding); + $body .= $this->encodeString($this->Body, $bodyEncoding); $body .= $this->LE . $this->LE; $body .= $this->attachAll('inline', $this->boundary[1]); break; case 'attach': - $body .= $this->getBoundary($this->boundary[1], '', '', ''); - $body .= $this->encodeString($this->Body, $this->Encoding); + $body .= $mimepre; + $body .= $this->getBoundary($this->boundary[1], $bodyCharSet, '', $bodyEncoding); + $body .= $this->encodeString($this->Body, $bodyEncoding); $body .= $this->LE . $this->LE; $body .= $this->attachAll('attachment', $this->boundary[1]); break; case 'inline_attach': + $body .= $mimepre; $body .= $this->textLine('--' . $this->boundary[1]); $body .= $this->headerLine('Content-Type', 'multipart/related;'); $body .= $this->textLine("\tboundary=\"" . $this->boundary[2] . '"'); $body .= $this->LE; - $body .= $this->getBoundary($this->boundary[2], '', '', ''); - $body .= $this->encodeString($this->Body, $this->Encoding); + $body .= $this->getBoundary($this->boundary[2], $bodyCharSet, '', $bodyEncoding); + $body .= $this->encodeString($this->Body, $bodyEncoding); $body .= $this->LE . $this->LE; $body .= $this->attachAll('inline', $this->boundary[2]); $body .= $this->LE; $body .= $this->attachAll('attachment', $this->boundary[1]); break; case 'alt': - $body .= $this->getBoundary($this->boundary[1], '', 'text/plain', ''); - $body .= $this->encodeString($this->AltBody, $this->Encoding); + $body .= $mimepre; + $body .= $this->getBoundary($this->boundary[1], $altBodyCharSet, 'text/plain', $altBodyEncoding); + $body .= $this->encodeString($this->AltBody, $altBodyEncoding); $body .= $this->LE . $this->LE; - $body .= $this->getBoundary($this->boundary[1], '', 'text/html', ''); - $body .= $this->encodeString($this->Body, $this->Encoding); + $body .= $this->getBoundary($this->boundary[1], $bodyCharSet, 'text/html', $bodyEncoding); + $body .= $this->encodeString($this->Body, $bodyEncoding); $body .= $this->LE . $this->LE; if (!empty($this->Ical)) { $body .= $this->getBoundary($this->boundary[1], '', 'text/calendar; method=REQUEST', ''); @@ -1772,49 +1961,52 @@ $body .= $this->endBoundary($this->boundary[1]); break; case 'alt_inline': - $body .= $this->getBoundary($this->boundary[1], '', 'text/plain', ''); - $body .= $this->encodeString($this->AltBody, $this->Encoding); + $body .= $mimepre; + $body .= $this->getBoundary($this->boundary[1], $altBodyCharSet, 'text/plain', $altBodyEncoding); + $body .= $this->encodeString($this->AltBody, $altBodyEncoding); $body .= $this->LE . $this->LE; $body .= $this->textLine('--' . $this->boundary[1]); $body .= $this->headerLine('Content-Type', 'multipart/related;'); $body .= $this->textLine("\tboundary=\"" . $this->boundary[2] . '"'); $body .= $this->LE; - $body .= $this->getBoundary($this->boundary[2], '', 'text/html', ''); - $body .= $this->encodeString($this->Body, $this->Encoding); + $body .= $this->getBoundary($this->boundary[2], $bodyCharSet, 'text/html', $bodyEncoding); + $body .= $this->encodeString($this->Body, $bodyEncoding); $body .= $this->LE . $this->LE; $body .= $this->attachAll('inline', $this->boundary[2]); $body .= $this->LE; $body .= $this->endBoundary($this->boundary[1]); break; case 'alt_attach': + $body .= $mimepre; $body .= $this->textLine('--' . $this->boundary[1]); $body .= $this->headerLine('Content-Type', 'multipart/alternative;'); $body .= $this->textLine("\tboundary=\"" . $this->boundary[2] . '"'); $body .= $this->LE; - $body .= $this->getBoundary($this->boundary[2], '', 'text/plain', ''); - $body .= $this->encodeString($this->AltBody, $this->Encoding); + $body .= $this->getBoundary($this->boundary[2], $altBodyCharSet, 'text/plain', $altBodyEncoding); + $body .= $this->encodeString($this->AltBody, $altBodyEncoding); $body .= $this->LE . $this->LE; - $body .= $this->getBoundary($this->boundary[2], '', 'text/html', ''); - $body .= $this->encodeString($this->Body, $this->Encoding); + $body .= $this->getBoundary($this->boundary[2], $bodyCharSet, 'text/html', $bodyEncoding); + $body .= $this->encodeString($this->Body, $bodyEncoding); $body .= $this->LE . $this->LE; $body .= $this->endBoundary($this->boundary[2]); $body .= $this->LE; $body .= $this->attachAll('attachment', $this->boundary[1]); break; case 'alt_inline_attach': + $body .= $mimepre; $body .= $this->textLine('--' . $this->boundary[1]); $body .= $this->headerLine('Content-Type', 'multipart/alternative;'); $body .= $this->textLine("\tboundary=\"" . $this->boundary[2] . '"'); $body .= $this->LE; - $body .= $this->getBoundary($this->boundary[2], '', 'text/plain', ''); - $body .= $this->encodeString($this->AltBody, $this->Encoding); + $body .= $this->getBoundary($this->boundary[2], $altBodyCharSet, 'text/plain', $altBodyEncoding); + $body .= $this->encodeString($this->AltBody, $altBodyEncoding); $body .= $this->LE . $this->LE; $body .= $this->textLine('--' . $this->boundary[2]); $body .= $this->headerLine('Content-Type', 'multipart/related;'); $body .= $this->textLine("\tboundary=\"" . $this->boundary[3] . '"'); $body .= $this->LE; - $body .= $this->getBoundary($this->boundary[3], '', 'text/html', ''); - $body .= $this->encodeString($this->Body, $this->Encoding); + $body .= $this->getBoundary($this->boundary[3], $bodyCharSet, 'text/html', $bodyEncoding); + $body .= $this->encodeString($this->Body, $bodyEncoding); $body .= $this->LE . $this->LE; $body .= $this->attachAll('inline', $this->boundary[3]); $body .= $this->LE; @@ -1824,7 +2016,7 @@ break; default: // catch case 'plain' and case '' - $body .= $this->encodeString($this->Body, $this->Encoding); + $body .= $this->encodeString($this->Body, $bodyEncoding); break; } @@ -1833,31 +2025,51 @@ } elseif ($this->sign_key_file) { try { if (!defined('PKCS7_TEXT')) { - throw new phpmailerException($this->lang('signing') . ' OpenSSL extension missing.'); + throw new phpmailerException($this->lang('extension_missing') . 'openssl'); } + // @TODO would be nice to use php://temp streams here, but need to wrap for PHP < 5.1 $file = tempnam(sys_get_temp_dir(), 'mail'); - file_put_contents($file, $body); //TODO check this worked + if (false === file_put_contents($file, $body)) { + throw new phpmailerException($this->lang('signing') . ' Could not write temp file'); + } $signed = tempnam(sys_get_temp_dir(), 'signed'); - if (@openssl_pkcs7_sign( - $file, - $signed, - 'file://' . realpath($this->sign_cert_file), - array('file://' . realpath($this->sign_key_file), $this->sign_key_pass), - null - ) - ) { + //Workaround for PHP bug https://bugs.php.net/bug.php?id=69197 + if (empty($this->sign_extracerts_file)) { + $sign = @openssl_pkcs7_sign( + $file, + $signed, + 'file://' . realpath($this->sign_cert_file), + array('file://' . realpath($this->sign_key_file), $this->sign_key_pass), + null + ); + } else { + $sign = @openssl_pkcs7_sign( + $file, + $signed, + 'file://' . realpath($this->sign_cert_file), + array('file://' . realpath($this->sign_key_file), $this->sign_key_pass), + null, + PKCS7_DETACHED, + $this->sign_extracerts_file + ); + } + if ($sign) { @unlink($file); $body = file_get_contents($signed); @unlink($signed); + //The message returned by openssl contains both headers and body, so need to split them up + $parts = explode("\n\n", $body, 2); + $this->MIMEHeader .= $parts[0] . $this->LE . $this->LE; + $body = $parts[1]; } else { @unlink($file); @unlink($signed); throw new phpmailerException($this->lang('signing') . openssl_error_string()); } - } catch (phpmailerException $e) { + } catch (phpmailerException $exc) { $body = ''; if ($this->exceptions) { - throw $e; + throw $exc; } } } @@ -1886,9 +2098,12 @@ $encoding = $this->Encoding; } $result .= $this->textLine('--' . $boundary); - $result .= sprintf("Content-Type: %s; charset=%s", $contentType, $charSet); + $result .= sprintf('Content-Type: %s; charset=%s', $contentType, $charSet); $result .= $this->LE; - $result .= $this->headerLine('Content-Transfer-Encoding', $encoding); + // RFC1341 part 5 says 7bit is assumed if not specified + if ($encoding != '7bit') { + $result .= $this->headerLine('Content-Transfer-Encoding', $encoding); + } $result .= $this->LE; return $result; @@ -1914,19 +2129,19 @@ */ protected function setMessageType() { - $this->message_type = array(); + $type = array(); if ($this->alternativeExists()) { - $this->message_type[] = "alt"; + $type[] = 'alt'; } if ($this->inlineImageExists()) { - $this->message_type[] = "inline"; + $type[] = 'inline'; } if ($this->attachmentExists()) { - $this->message_type[] = "attach"; + $type[] = 'attach'; } - $this->message_type = implode("_", $this->message_type); - if ($this->message_type == "") { - $this->message_type = "plain"; + $this->message_type = implode('_', $type); + if ($this->message_type == '') { + $this->message_type = 'plain'; } } @@ -1962,7 +2177,7 @@ * @param string $type File extension (MIME) type. * @param string $disposition Disposition to use * @throws phpmailerException - * @return bool + * @return boolean */ public function addAttachment($path, $name = '', $encoding = 'base64', $type = '', $disposition = 'attachment') { @@ -1971,7 +2186,7 @@ throw new phpmailerException($this->lang('file_access') . $path, self::STOP_CONTINUE); } - //If a MIME type is not specified, try to work it out from the file name + // If a MIME type is not specified, try to work it out from the file name if ($type == '') { $type = self::filenameToType($path); } @@ -1992,12 +2207,12 @@ 7 => 0 ); - } catch (phpmailerException $e) { - $this->setError($e->getMessage()); + } catch (phpmailerException $exc) { + $this->setError($exc->getMessage()); + $this->edebug($exc->getMessage()); if ($this->exceptions) { - throw $e; + throw $exc; } - $this->edebug($e->getMessage() . "\n"); return false; } return true; @@ -2056,17 +2271,20 @@ } $cidUniq[$cid] = true; - $mime[] = sprintf("--%s%s", $boundary, $this->LE); + $mime[] = sprintf('--%s%s', $boundary, $this->LE); $mime[] = sprintf( - "Content-Type: %s; name=\"%s\"%s", + 'Content-Type: %s; name="%s"%s', $type, $this->encodeHeader($this->secureHeader($name)), $this->LE ); - $mime[] = sprintf("Content-Transfer-Encoding: %s%s", $encoding, $this->LE); + // RFC1341 part 5 says 7bit is assumed if not specified + if ($encoding != '7bit') { + $mime[] = sprintf('Content-Transfer-Encoding: %s%s', $encoding, $this->LE); + } if ($disposition == 'inline') { - $mime[] = sprintf("Content-ID: <%s>%s", $cid, $this->LE); + $mime[] = sprintf('Content-ID: <%s>%s', $cid, $this->LE); } // If a filename contains any of these chars, it should be quoted, @@ -2074,18 +2292,19 @@ // Fixes a warning in IETF's msglint MIME checker // Allow for bypassing the Content-Disposition header totally if (!(empty($disposition))) { - if (preg_match('/[ \(\)<>@,;:\\"\/\[\]\?=]/', $name)) { + $encoded_name = $this->encodeHeader($this->secureHeader($name)); + if (preg_match('/[ \(\)<>@,;:\\"\/\[\]\?=]/', $encoded_name)) { $mime[] = sprintf( - "Content-Disposition: %s; filename=\"%s\"%s", + 'Content-Disposition: %s; filename="%s"%s', $disposition, - $this->encodeHeader($this->secureHeader($name)), + $encoded_name, $this->LE . $this->LE ); } else { $mime[] = sprintf( - "Content-Disposition: %s; filename=%s%s", + 'Content-Disposition: %s; filename=%s%s', $disposition, - $this->encodeHeader($this->secureHeader($name)), + $encoded_name, $this->LE . $this->LE ); } @@ -2110,9 +2329,9 @@ } } - $mime[] = sprintf("--%s--%s", $boundary, $this->LE); + $mime[] = sprintf('--%s--%s', $boundary, $this->LE); - return implode("", $mime); + return implode('', $mime); } /** @@ -2134,9 +2353,12 @@ $magic_quotes = get_magic_quotes_runtime(); if ($magic_quotes) { if (version_compare(PHP_VERSION, '5.3.0', '<')) { - set_magic_quotes_runtime(0); + set_magic_quotes_runtime(false); } else { - ini_set('magic_quotes_runtime', 0); + //Doesn't exist in PHP 5.4, but we don't need to check because + //get_magic_quotes_runtime always returns false in 5.4+ + //so it will never get here + ini_set('magic_quotes_runtime', false); } } $file_buffer = file_get_contents($path); @@ -2149,8 +2371,8 @@ } } return $file_buffer; - } catch (Exception $e) { - $this->setError($e->getMessage()); + } catch (Exception $exc) { + $this->setError($exc->getMessage()); return ''; } } @@ -2173,7 +2395,7 @@ case '7bit': case '8bit': $encoded = $this->fixEOL($str); - //Make sure it ends with a line break + // Make sure it ends with a line break if (substr($encoded, -(strlen($this->LE))) != $this->LE) { $encoded .= $this->LE; } @@ -2201,11 +2423,11 @@ */ public function encodeHeader($str, $position = 'text') { - $x = 0; + $matchcount = 0; switch (strtolower($position)) { case 'phrase': if (!preg_match('/[\200-\377]/', $str)) { - // Can't use addslashes as we don't know what value has magic_quotes_sybase + // Can't use addslashes as we don't know the value of magic_quotes_sybase $encoded = addcslashes($str, "\0..\37\177\\\""); if (($str == $encoded) && !preg_match('/[^A-Za-z0-9!#$%&\'*+\/=?^_`{|}~ -]/', $str)) { return ($encoded); @@ -2213,26 +2435,27 @@ return ("\"$encoded\""); } } - $x = preg_match_all('/[^\040\041\043-\133\135-\176]/', $str, $matches); + $matchcount = preg_match_all('/[^\040\041\043-\133\135-\176]/', $str, $matches); break; /** @noinspection PhpMissingBreakStatementInspection */ case 'comment': - $x = preg_match_all('/[()"]/', $str, $matches); + $matchcount = preg_match_all('/[()"]/', $str, $matches); // Intentional fall-through case 'text': default: - $x += preg_match_all('/[\000-\010\013\014\016-\037\177-\377]/', $str, $matches); + $matchcount += preg_match_all('/[\000-\010\013\014\016-\037\177-\377]/', $str, $matches); break; } - if ($x == 0) { //There are no chars that need encoding + //There are no chars that need encoding + if ($matchcount == 0) { return ($str); } $maxlen = 75 - 7 - strlen($this->CharSet); // Try to select the encoding which should produce the shortest output - if ($x > strlen($str) / 3) { - //More than a third of the content will need encoding, so B encoding will be most efficient + if ($matchcount > strlen($str) / 3) { + // More than a third of the content will need encoding, so B encoding will be most efficient $encoding = 'B'; if (function_exists('mb_strlen') && $this->hasMultiBytes($str)) { // Use a custom function which correctly encodes and wraps long @@ -2250,7 +2473,7 @@ $encoded = str_replace('=' . self::CRLF, "\n", trim($encoded)); } - $encoded = preg_replace('/^(.*)$/m', " =?" . $this->CharSet . "?$encoding?\\1?=", $encoded); + $encoded = preg_replace('/^(.*)$/m', ' =?' . $this->CharSet . "?$encoding?\\1?=", $encoded); $encoded = trim(str_replace("\n", $this->LE, $encoded)); return $encoded; @@ -2260,7 +2483,7 @@ * Check if a string contains multi-byte characters. * @access public * @param string $str multi-byte text to wrap encode - * @return bool + * @return boolean */ public function hasMultiBytes($str) { @@ -2272,21 +2495,32 @@ } /** + * Does a string contain any 8-bit chars (in any charset)? + * @param string $text + * @return boolean + */ + public function has8bitChars($text) + { + return (boolean)preg_match('/[\x80-\xFF]/', $text); + } + + /** * Encode and wrap long multibyte strings for mail headers * without breaking lines within a character. - * Adapted from a function by paravoid at http://uk.php.net/manual/en/function.mb-encode-mimeheader.php + * Adapted from a function by paravoid + * @link http://www.php.net/manual/en/function.mb-encode-mimeheader.php#60283 * @access public * @param string $str multi-byte text to wrap encode - * @param string $lf string to use as linefeed/end-of-line + * @param string $linebreak string to use as linefeed/end-of-line * @return string */ - public function base64EncodeWrapMB($str, $lf = null) + public function base64EncodeWrapMB($str, $linebreak = null) { - $start = "=?" . $this->CharSet . "?B?"; - $end = "?="; - $encoded = ""; - if ($lf === null) { - $lf = $this->LE; + $start = '=?' . $this->CharSet . '?B?'; + $end = '?='; + $encoded = ''; + if ($linebreak === null) { + $linebreak = $this->LE; } $mb_length = mb_strlen($str, $this->CharSet); @@ -2305,11 +2539,11 @@ $chunk = base64_encode($chunk); $lookBack++; } while (strlen($chunk) > $length); - $encoded .= $chunk . $lf; + $encoded .= $chunk . $linebreak; } // Chomp the last linefeed - $encoded = substr($encoded, 0, -strlen($lf)); + $encoded = substr($encoded, 0, -strlen($linebreak)); return $encoded; } @@ -2320,21 +2554,22 @@ * @param string $string The text to encode * @param integer $line_max Number of chars allowed on a line before wrapping * @return string - * @link PHP version adapted from http://www.php.net/manual/en/function.quoted-printable-decode.php#89417 + * @link http://www.php.net/manual/en/function.quoted-printable-decode.php#89417 Adapted from this comment */ public function encodeQP($string, $line_max = 76) { - if (function_exists('quoted_printable_encode')) { //Use native function if it's available (>= PHP5.3) - return quoted_printable_encode($string); + // Use native function if it's available (>= PHP5.3) + if (function_exists('quoted_printable_encode')) { + return $this->fixEOL(quoted_printable_encode($string)); } - //Fall back to a pure PHP implementation + // Fall back to a pure PHP implementation $string = str_replace( array('%20', '%0D%0A.', '%0D%0A', '%'), array(' ', "\r\n=2E", "\r\n", '='), rawurlencode($string) ); $string = preg_replace('/[^\r\n]{' . ($line_max - 3) . '}[^=\r\n]{2}/', "$0=\r\n", $string); - return $string; + return $this->fixEOL($string); } /** @@ -2343,7 +2578,7 @@ * @access public * @param string $string * @param integer $line_max - * @param bool $space_conv + * @param boolean $space_conv * @return string * @deprecated Use encodeQP instead. */ @@ -2365,41 +2600,41 @@ */ public function encodeQ($str, $position = 'text') { - //There should not be any EOL in the string + // There should not be any EOL in the string $pattern = ''; $encoded = str_replace(array("\r", "\n"), '', $str); switch (strtolower($position)) { case 'phrase': - //RFC 2047 section 5.3 + // RFC 2047 section 5.3 $pattern = '^A-Za-z0-9!*+\/ -'; break; /** @noinspection PhpMissingBreakStatementInspection */ case 'comment': - //RFC 2047 section 5.2 + // RFC 2047 section 5.2 $pattern = '\(\)"'; - //intentional fall-through - //for this reason we build the $pattern without including delimiters and [] + // intentional fall-through + // for this reason we build the $pattern without including delimiters and [] case 'text': default: - //RFC 2047 section 5.1 - //Replace every high ascii, control, =, ? and _ characters + // RFC 2047 section 5.1 + // Replace every high ascii, control, =, ? and _ characters $pattern = '\000-\011\013\014\016-\037\075\077\137\177-\377' . $pattern; break; } $matches = array(); if (preg_match_all("/[{$pattern}]/", $encoded, $matches)) { - //If the string contains an '=', make sure it's the first thing we replace - //so as to avoid double-encoding - $s = array_search('=', $matches[0]); - if ($s !== false) { - unset($matches[0][$s]); + // If the string contains an '=', make sure it's the first thing we replace + // so as to avoid double-encoding + $eqkey = array_search('=', $matches[0]); + if (false !== $eqkey) { + unset($matches[0][$eqkey]); array_unshift($matches[0], '='); } foreach (array_unique($matches[0]) as $char) { $encoded = str_replace($char, '=' . sprintf('%02X', ord($char)), $encoded); } } - //Replace every spaces to _ (more readable than =20) + // Replace every spaces to _ (more readable than =20) return str_replace(' ', '_', $encoded); } @@ -2422,7 +2657,7 @@ $type = '', $disposition = 'attachment' ) { - //If a MIME type is not specified, try to work it out from the file name + // If a MIME type is not specified, try to work it out from the file name if ($type == '') { $type = self::filenameToType($filename); } @@ -2442,7 +2677,7 @@ /** * Add an embedded (inline) attachment from a file. * This can include images, sounds, and just about any other document type. - * These differ from 'regular' attachmants in that they are intended to be + * These differ from 'regular' attachments in that they are intended to be * displayed inline with the message, not just attached for download. * This is used in HTML messages that embed the images * the HTML refers to using the $cid value. @@ -2453,7 +2688,7 @@ * @param string $encoding File encoding (see $Encoding). * @param string $type File MIME type. * @param string $disposition Disposition to use - * @return bool True on successfully adding an attachment + * @return boolean True on successfully adding an attachment */ public function addEmbeddedImage($path, $cid, $name = '', $encoding = 'base64', $type = '', $disposition = 'inline') { @@ -2462,7 +2697,7 @@ return false; } - //If a MIME type is not specified, try to work it out from the file name + // If a MIME type is not specified, try to work it out from the file name if ($type == '') { $type = self::filenameToType($path); } @@ -2498,7 +2733,7 @@ * @param string $encoding File encoding (see $Encoding). * @param string $type MIME type. * @param string $disposition Disposition to use - * @return bool True on successfully adding an attachment + * @return boolean True on successfully adding an attachment */ public function addStringEmbeddedImage( $string, @@ -2508,7 +2743,7 @@ $type = '', $disposition = 'inline' ) { - //If a MIME type is not specified, try to work it out from the name + // If a MIME type is not specified, try to work it out from the name if ($type == '') { $type = self::filenameToType($name); } @@ -2530,7 +2765,7 @@ /** * Check if an inline attachment is present. * @access public - * @return bool + * @return boolean */ public function inlineImageExists() { @@ -2544,7 +2779,7 @@ /** * Check if an attachment (non-inline) is present. - * @return bool + * @return boolean */ public function attachmentExists() { @@ -2558,7 +2793,7 @@ /** * Check if this message has an alternative body set. - * @return bool + * @return boolean */ public function alternativeExists() { @@ -2651,8 +2886,17 @@ $this->error_count++; if ($this->Mailer == 'smtp' and !is_null($this->smtp)) { $lasterror = $this->smtp->getError(); - if (!empty($lasterror) and array_key_exists('smtp_msg', $lasterror)) { - $msg .= '

' . $this->lang('smtp_error') . $lasterror['smtp_msg'] . "

\n"; + if (!empty($lasterror['error'])) { + $msg .= $this->lang('smtp_error') . $lasterror['error']; + if (!empty($lasterror['detail'])) { + $msg .= ' Detail: '. $lasterror['detail']; + } + if (!empty($lasterror['smtp_code'])) { + $msg .= ' SMTP code: ' . $lasterror['smtp_code']; + } + if (!empty($lasterror['smtp_code_ex'])) { + $msg .= ' Additional SMTP info: ' . $lasterror['smtp_code_ex']; + } } } $this->ErrorInfo = $msg; @@ -2666,8 +2910,8 @@ */ public static function rfcDate() { - //Set the time zone to whatever the default is to avoid 500 errors - //Will default to UTC if it's not set properly in php.ini + // Set the time zone to whatever the default is to avoid 500 errors + // Will default to UTC if it's not set properly in php.ini date_default_timezone_set(@date_default_timezone_get()); return date('D, j M Y H:i:s O'); } @@ -2680,14 +2924,16 @@ */ protected function serverHostname() { + $result = 'localhost.localdomain'; if (!empty($this->Hostname)) { $result = $this->Hostname; - } elseif (isset($_SERVER['SERVER_NAME'])) { + } elseif (isset($_SERVER) and array_key_exists('SERVER_NAME', $_SERVER) and !empty($_SERVER['SERVER_NAME'])) { $result = $_SERVER['SERVER_NAME']; - } else { - $result = 'localhost.localdomain'; + } elseif (function_exists('gethostname') && gethostname() !== false) { + $result = gethostname(); + } elseif (php_uname('n') !== false) { + $result = php_uname('n'); } - return $result; } @@ -2703,17 +2949,24 @@ $this->setLanguage('en'); // set the default language } - if (isset($this->language[$key])) { + if (array_key_exists($key, $this->language)) { + if ($key == 'smtp_connect_failed') { + //Include a link to troubleshooting docs on SMTP connection failure + //this is by far the biggest cause of support questions + //but it's usually not PHPMailer's fault. + return $this->language[$key] . ' https://github.com/PHPMailer/PHPMailer/wiki/Troubleshooting'; + } return $this->language[$key]; } else { - return 'Language string failed to load: ' . $key; + //Return the key as a fallback + return $key; } } /** * Check if an error occurred. * @access public - * @return bool True if an error did occur. + * @return boolean True if an error did occur. */ public function isError() { @@ -2758,6 +3011,16 @@ } /** + * Returns all custom headers + * + * @return array + */ + public function getCustomHeaders() + { + return $this->CustomHeader; + } + + /** * Create a message from an HTML string. * Automatically makes modifications for inline images and backgrounds * and creates a plain-text version by converting the HTML. @@ -2765,22 +3028,39 @@ * @access public * @param string $message HTML message string * @param string $basedir baseline directory for path - * @param bool $advanced Whether to use the advanced HTML to text converter + * @param boolean|callable $advanced Whether to use the internal HTML to text converter + * or your own custom converter @see html2text() * @return string $message */ public function msgHTML($message, $basedir = '', $advanced = false) { - preg_match_all("/(src|background)=[\"'](.*)[\"']/Ui", $message, $images); + preg_match_all('/(src|background)=["\'](.*)["\']/Ui', $message, $images); if (isset($images[2])) { - foreach ($images[2] as $i => $url) { - // do not change urls for absolute images (thanks to corvuscorax) - if (!preg_match('#^[A-z]+://#', $url)) { + foreach ($images[2] as $imgindex => $url) { + // Convert data URIs into embedded images + if (preg_match('#^data:(image[^;,]*)(;base64)?,#', $url, $match)) { + $data = substr($url, strpos($url, ',')); + if ($match[2]) { + $data = base64_decode($data); + } else { + $data = rawurldecode($data); + } + $cid = md5($url) . '@phpmailer.0'; // RFC2392 S 2 + if ($this->addStringEmbeddedImage($data, $cid, '', 'base64', $match[1])) { + $message = str_replace( + $images[0][$imgindex], + $images[1][$imgindex] . '="cid:' . $cid . '"', + $message + ); + } + } elseif (!preg_match('#^[A-z]+://#', $url)) { + // Do not change urls for absolute images (thanks to corvuscorax) $filename = basename($url); $directory = dirname($url); if ($directory == '.') { $directory = ''; } - $cid = md5($url) . '@phpmailer.0'; //RFC2392 S 2 + $cid = md5($url) . '@phpmailer.0'; // RFC2392 S 2 if (strlen($basedir) > 1 && substr($basedir, -1) != '/') { $basedir .= '/'; } @@ -2792,12 +3072,12 @@ $cid, $filename, 'base64', - self::_mime_types(self::mb_pathinfo($filename, PATHINFO_EXTENSION)) + self::_mime_types((string)self::mb_pathinfo($filename, PATHINFO_EXTENSION)) ) ) { $message = preg_replace( - "/" . $images[1][$i] . "=[\"']" . preg_quote($url, '/') . "[\"']/Ui", - $images[1][$i] . "=\"cid:" . $cid . "\"", + '/' . $images[1][$imgindex] . '=["\']' . preg_quote($url, '/') . '["\']/Ui', + $images[1][$imgindex] . '="cid:' . $cid . '"', $message ); } @@ -2805,27 +3085,40 @@ } } $this->isHTML(true); + // Convert all message body line breaks to CRLF, makes quoted-printable encoding work much better + $this->Body = $this->normalizeBreaks($message); + $this->AltBody = $this->normalizeBreaks($this->html2text($message, $advanced)); if (empty($this->AltBody)) { - $this->AltBody = 'To view this email message, open it in a program that understands HTML!' . "\n\n"; + $this->AltBody = 'To view this email message, open it in a program that understands HTML!' . + self::CRLF . self::CRLF; } - //Convert all message body line breaks to CRLF, makes quoted-printable encoding work much better - $this->Body = $this->normalizeBreaks($message); - $this->AltBody = $this->normalizeBreaks($this->html2text($message, $advanced)); return $this->Body; } /** * Convert an HTML string into plain text. + * This is used by msgHTML(). + * Note - older versions of this function used a bundled advanced converter + * which was been removed for license reasons in #232 + * Example usage: + * + * // Use default conversion + * $plain = $mail->html2text($html); + * // Use your own custom converter + * $plain = $mail->html2text($html, function($html) { + * $converter = new MyHtml2text($html); + * return $converter->get_text(); + * }); + * * @param string $html The HTML text to convert - * @param bool $advanced Should this use the more complex html2text converter or just a simple one? + * @param boolean|callable $advanced Any boolean value to use the internal converter, + * or provide your own callable for custom conversion. * @return string */ public function html2text($html, $advanced = false) { - if ($advanced) { - require_once 'extras/class.html2text.php'; - $h = new html2text($html); - return $h->get_text(); + if (is_callable($advanced)) { + return call_user_func($advanced, $html); } return html_entity_decode( trim(strip_tags(preg_replace('/<(head|title|style|script)[^>]*>.*?<\/\\1>/si', '', $html))), @@ -2844,94 +3137,99 @@ public static function _mime_types($ext = '') { $mimes = array( - 'xl' => 'application/excel', - 'hqx' => 'application/mac-binhex40', - 'cpt' => 'application/mac-compactpro', - 'bin' => 'application/macbinary', - 'doc' => 'application/msword', - 'word' => 'application/msword', + 'xl' => 'application/excel', + 'js' => 'application/javascript', + 'hqx' => 'application/mac-binhex40', + 'cpt' => 'application/mac-compactpro', + 'bin' => 'application/macbinary', + 'doc' => 'application/msword', + 'word' => 'application/msword', 'class' => 'application/octet-stream', - 'dll' => 'application/octet-stream', - 'dms' => 'application/octet-stream', - 'exe' => 'application/octet-stream', - 'lha' => 'application/octet-stream', - 'lzh' => 'application/octet-stream', - 'psd' => 'application/octet-stream', - 'sea' => 'application/octet-stream', - 'so' => 'application/octet-stream', - 'oda' => 'application/oda', - 'pdf' => 'application/pdf', - 'ai' => 'application/postscript', - 'eps' => 'application/postscript', - 'ps' => 'application/postscript', - 'smi' => 'application/smil', - 'smil' => 'application/smil', - 'mif' => 'application/vnd.mif', - 'xls' => 'application/vnd.ms-excel', - 'ppt' => 'application/vnd.ms-powerpoint', + 'dll' => 'application/octet-stream', + 'dms' => 'application/octet-stream', + 'exe' => 'application/octet-stream', + 'lha' => 'application/octet-stream', + 'lzh' => 'application/octet-stream', + 'psd' => 'application/octet-stream', + 'sea' => 'application/octet-stream', + 'so' => 'application/octet-stream', + 'oda' => 'application/oda', + 'pdf' => 'application/pdf', + 'ai' => 'application/postscript', + 'eps' => 'application/postscript', + 'ps' => 'application/postscript', + 'smi' => 'application/smil', + 'smil' => 'application/smil', + 'mif' => 'application/vnd.mif', + 'xls' => 'application/vnd.ms-excel', + 'ppt' => 'application/vnd.ms-powerpoint', 'wbxml' => 'application/vnd.wap.wbxml', - 'wmlc' => 'application/vnd.wap.wmlc', - 'dcr' => 'application/x-director', - 'dir' => 'application/x-director', - 'dxr' => 'application/x-director', - 'dvi' => 'application/x-dvi', - 'gtar' => 'application/x-gtar', - 'php3' => 'application/x-httpd-php', - 'php4' => 'application/x-httpd-php', - 'php' => 'application/x-httpd-php', + 'wmlc' => 'application/vnd.wap.wmlc', + 'dcr' => 'application/x-director', + 'dir' => 'application/x-director', + 'dxr' => 'application/x-director', + 'dvi' => 'application/x-dvi', + 'gtar' => 'application/x-gtar', + 'php3' => 'application/x-httpd-php', + 'php4' => 'application/x-httpd-php', + 'php' => 'application/x-httpd-php', 'phtml' => 'application/x-httpd-php', - 'phps' => 'application/x-httpd-php-source', - 'js' => 'application/x-javascript', - 'swf' => 'application/x-shockwave-flash', - 'sit' => 'application/x-stuffit', - 'tar' => 'application/x-tar', - 'tgz' => 'application/x-tar', - 'xht' => 'application/xhtml+xml', + 'phps' => 'application/x-httpd-php-source', + 'swf' => 'application/x-shockwave-flash', + 'sit' => 'application/x-stuffit', + 'tar' => 'application/x-tar', + 'tgz' => 'application/x-tar', + 'xht' => 'application/xhtml+xml', 'xhtml' => 'application/xhtml+xml', - 'zip' => 'application/zip', - 'mid' => 'audio/midi', - 'midi' => 'audio/midi', - 'mp2' => 'audio/mpeg', - 'mp3' => 'audio/mpeg', - 'mpga' => 'audio/mpeg', - 'aif' => 'audio/x-aiff', - 'aifc' => 'audio/x-aiff', - 'aiff' => 'audio/x-aiff', - 'ram' => 'audio/x-pn-realaudio', - 'rm' => 'audio/x-pn-realaudio', - 'rpm' => 'audio/x-pn-realaudio-plugin', - 'ra' => 'audio/x-realaudio', - 'wav' => 'audio/x-wav', - 'bmp' => 'image/bmp', - 'gif' => 'image/gif', - 'jpeg' => 'image/jpeg', - 'jpe' => 'image/jpeg', - 'jpg' => 'image/jpeg', - 'png' => 'image/png', - 'tiff' => 'image/tiff', - 'tif' => 'image/tiff', - 'eml' => 'message/rfc822', - 'css' => 'text/css', - 'html' => 'text/html', - 'htm' => 'text/html', + 'zip' => 'application/zip', + 'mid' => 'audio/midi', + 'midi' => 'audio/midi', + 'mp2' => 'audio/mpeg', + 'mp3' => 'audio/mpeg', + 'mpga' => 'audio/mpeg', + 'aif' => 'audio/x-aiff', + 'aifc' => 'audio/x-aiff', + 'aiff' => 'audio/x-aiff', + 'ram' => 'audio/x-pn-realaudio', + 'rm' => 'audio/x-pn-realaudio', + 'rpm' => 'audio/x-pn-realaudio-plugin', + 'ra' => 'audio/x-realaudio', + 'wav' => 'audio/x-wav', + 'bmp' => 'image/bmp', + 'gif' => 'image/gif', + 'jpeg' => 'image/jpeg', + 'jpe' => 'image/jpeg', + 'jpg' => 'image/jpeg', + 'png' => 'image/png', + 'tiff' => 'image/tiff', + 'tif' => 'image/tiff', + 'eml' => 'message/rfc822', + 'css' => 'text/css', + 'html' => 'text/html', + 'htm' => 'text/html', 'shtml' => 'text/html', - 'log' => 'text/plain', - 'text' => 'text/plain', - 'txt' => 'text/plain', - 'rtx' => 'text/richtext', - 'rtf' => 'text/rtf', - 'xml' => 'text/xml', - 'xsl' => 'text/xml', - 'mpeg' => 'video/mpeg', - 'mpe' => 'video/mpeg', - 'mpg' => 'video/mpeg', - 'mov' => 'video/quicktime', - 'qt' => 'video/quicktime', - 'rv' => 'video/vnd.rn-realvideo', - 'avi' => 'video/x-msvideo', + 'log' => 'text/plain', + 'text' => 'text/plain', + 'txt' => 'text/plain', + 'rtx' => 'text/richtext', + 'rtf' => 'text/rtf', + 'vcf' => 'text/vcard', + 'vcard' => 'text/vcard', + 'xml' => 'text/xml', + 'xsl' => 'text/xml', + 'mpeg' => 'video/mpeg', + 'mpe' => 'video/mpeg', + 'mpg' => 'video/mpeg', + 'mov' => 'video/quicktime', + 'qt' => 'video/quicktime', + 'rv' => 'video/vnd.rn-realvideo', + 'avi' => 'video/x-msvideo', 'movie' => 'video/x-sgi-movie' ); - return (array_key_exists(strtolower($ext), $mimes) ? $mimes[strtolower($ext)]: 'application/octet-stream'); + if (array_key_exists(strtolower($ext), $mimes)) { + return $mimes[strtolower($ext)]; + } + return 'application/octet-stream'; } /** @@ -2943,9 +3241,9 @@ */ public static function filenameToType($filename) { - //In case the path is a URL, strip any query string before getting extension + // In case the path is a URL, strip any query string before getting extension $qpos = strpos($filename, '?'); - if ($qpos !== false) { + if (false !== $qpos) { $filename = substr($filename, 0, $qpos); } $pathinfo = self::mb_pathinfo($filename); @@ -2966,37 +3264,34 @@ public static function mb_pathinfo($path, $options = null) { $ret = array('dirname' => '', 'basename' => '', 'extension' => '', 'filename' => ''); - $m = array(); - preg_match('%^(.*?)[\\\\/]*(([^/\\\\]*?)(\.([^\.\\\\/]+?)|))[\\\\/\.]*$%im', $path, $m); - if (array_key_exists(1, $m)) { - $ret['dirname'] = $m[1]; + $pathinfo = array(); + if (preg_match('%^(.*?)[\\\\/]*(([^/\\\\]*?)(\.([^\.\\\\/]+?)|))[\\\\/\.]*$%im', $path, $pathinfo)) { + if (array_key_exists(1, $pathinfo)) { + $ret['dirname'] = $pathinfo[1]; + } + if (array_key_exists(2, $pathinfo)) { + $ret['basename'] = $pathinfo[2]; + } + if (array_key_exists(5, $pathinfo)) { + $ret['extension'] = $pathinfo[5]; + } + if (array_key_exists(3, $pathinfo)) { + $ret['filename'] = $pathinfo[3]; + } } - if (array_key_exists(2, $m)) { - $ret['basename'] = $m[2]; - } - if (array_key_exists(5, $m)) { - $ret['extension'] = $m[5]; - } - if (array_key_exists(3, $m)) { - $ret['filename'] = $m[3]; - } switch ($options) { case PATHINFO_DIRNAME: case 'dirname': return $ret['dirname']; - break; case PATHINFO_BASENAME: case 'basename': return $ret['basename']; - break; case PATHINFO_EXTENSION: case 'extension': return $ret['extension']; - break; case PATHINFO_FILENAME: case 'filename': return $ret['filename']; - break; default: return $ret; } @@ -3004,33 +3299,27 @@ /** * Set or reset instance properties. - * + * You should avoid this function - it's more verbose, less efficient, more error-prone and + * harder to debug than setting properties directly. * Usage Example: - * $page->set('X-Priority', '3'); - * + * `$mail->set('SMTPSecure', 'tls');` + * is the same as: + * `$mail->SMTPSecure = 'tls';` * @access public - * @param string $name - * @param mixed $value - * NOTE: will not work with arrays, there are no arrays to set/reset - * @throws phpmailerException - * @return bool - * @todo Should this not be using __set() magic function? + * @param string $name The property name to set + * @param mixed $value The value to set the property to + * @return boolean + * @TODO Should this not be using the __set() magic function? */ public function set($name, $value = '') { - try { - if (isset($this->$name)) { - $this->$name = $value; - } else { - throw new phpmailerException($this->lang('variable_set') . $name, self::STOP_CRITICAL); - } - } catch (Exception $e) { - $this->setError($e->getMessage()); - if ($e->getCode() == self::STOP_CRITICAL) { - return false; - } + if (property_exists($this, $name)) { + $this->$name = $value; + return true; + } else { + $this->setError($this->lang('variable_set') . $name); + return false; } - return true; } /** @@ -3061,17 +3350,19 @@ /** - * Set the private key file and password for S/MIME signing. + * Set the public and private key files and password for S/MIME signing. * @access public * @param string $cert_filename * @param string $key_filename * @param string $key_pass Password for private key + * @param string $extracerts_filename Optional path to chain certificate */ - public function sign($cert_filename, $key_filename, $key_pass) + public function sign($cert_filename, $key_filename, $key_pass, $extracerts_filename = '') { $this->sign_cert_file = $cert_filename; $this->sign_key_file = $key_filename; $this->sign_key_pass = $key_pass; + $this->sign_extracerts_file = $extracerts_filename; } /** @@ -3088,7 +3379,7 @@ if (((0x21 <= $ord) && ($ord <= 0x3A)) || $ord == 0x3C || ((0x3E <= $ord) && ($ord <= 0x7E))) { $line .= $txt[$i]; } else { - $line .= "=" . sprintf("%02X", $ord); + $line .= '=' . sprintf('%02X', $ord); } } return $line; @@ -3097,15 +3388,15 @@ /** * Generate a DKIM signature. * @access public - * @param string $s Header + * @param string $signHeader * @throws phpmailerException * @return string */ - public function DKIM_Sign($s) + public function DKIM_Sign($signHeader) { if (!defined('PKCS7_TEXT')) { if ($this->exceptions) { - throw new phpmailerException($this->lang("signing") . ' OpenSSL extension missing.'); + throw new phpmailerException($this->lang('extension_missing') . 'openssl'); } return ''; } @@ -3115,7 +3406,7 @@ } else { $privKey = $privKeyStr; } - if (openssl_sign($s, $signature, $privKey)) { + if (openssl_sign($signHeader, $signature, $privKey)) { return base64_encode($signature); } return ''; @@ -3124,21 +3415,21 @@ /** * Generate a DKIM canonicalization header. * @access public - * @param string $s Header + * @param string $signHeader Header * @return string */ - public function DKIM_HeaderC($s) + public function DKIM_HeaderC($signHeader) { - $s = preg_replace("/\r\n\s+/", " ", $s); - $lines = explode("\r\n", $s); + $signHeader = preg_replace('/\r\n\s+/', ' ', $signHeader); + $lines = explode("\r\n", $signHeader); foreach ($lines as $key => $line) { - list($heading, $value) = explode(":", $line, 2); + list($heading, $value) = explode(':', $line, 2); $heading = strtolower($heading); - $value = preg_replace("/\s+/", " ", $value); // Compress useless spaces - $lines[$key] = $heading . ":" . trim($value); // Don't forget to remove WSP around the value + $value = preg_replace('/\s+/', ' ', $value); // Compress useless spaces + $lines[$key] = $heading . ':' . trim($value); // Don't forget to remove WSP around the value } - $s = implode("\r\n", $lines); - return $s; + $signHeader = implode("\r\n", $lines); + return $signHeader; } /** @@ -3189,8 +3480,8 @@ $to_header = $header; $current = 'to_header'; } else { - if ($current && strpos($header, ' =?') === 0) { - $current .= $header; + if (!empty($$current) && strpos($header, ' =?') === 0) { + $$current .= $header; } else { $current = ''; } @@ -3205,17 +3496,21 @@ ); // Copied header fields (dkim-quoted-printable) $body = $this->DKIM_BodyC($body); $DKIMlen = strlen($body); // Length of body - $DKIMb64 = base64_encode(pack("H*", sha1($body))); // Base64 of packed binary SHA-1 hash of body - $ident = ($this->DKIM_identity == '') ? '' : " i=" . $this->DKIM_identity . ";"; - $dkimhdrs = "DKIM-Signature: v=1; a=" . - $DKIMsignatureType . "; q=" . - $DKIMquery . "; l=" . - $DKIMlen . "; s=" . + $DKIMb64 = base64_encode(pack('H*', sha1($body))); // Base64 of packed binary SHA-1 hash of body + if ('' == $this->DKIM_identity) { + $ident = ''; + } else { + $ident = ' i=' . $this->DKIM_identity . ';'; + } + $dkimhdrs = 'DKIM-Signature: v=1; a=' . + $DKIMsignatureType . '; q=' . + $DKIMquery . '; l=' . + $DKIMlen . '; s=' . $this->DKIM_selector . ";\r\n" . - "\tt=" . $DKIMtime . "; c=" . $DKIMcanonicalization . ";\r\n" . + "\tt=" . $DKIMtime . '; c=' . $DKIMcanonicalization . ";\r\n" . "\th=From:To:Subject;\r\n" . - "\td=" . $this->DKIM_domain . ";" . $ident . "\r\n" . + "\td=" . $this->DKIM_domain . ';' . $ident . "\r\n" . "\tz=$from\r\n" . "\t|$to\r\n" . "\t|$subject;\r\n" . @@ -3229,16 +3524,78 @@ } /** + * Detect if a string contains a line longer than the maximum line length allowed. + * @param string $str + * @return boolean + * @static + */ + public static function hasLineLongerThanMax($str) + { + //+2 to include CRLF line break for a 1000 total + return (boolean)preg_match('/^(.{'.(self::MAX_LINE_LENGTH + 2).',})/m', $str); + } + + /** + * Allows for public read access to 'to' property. + * @access public + * @return array + */ + public function getToAddresses() + { + return $this->to; + } + + /** + * Allows for public read access to 'cc' property. + * @access public + * @return array + */ + public function getCcAddresses() + { + return $this->cc; + } + + /** + * Allows for public read access to 'bcc' property. + * @access public + * @return array + */ + public function getBccAddresses() + { + return $this->bcc; + } + + /** + * Allows for public read access to 'ReplyTo' property. + * @access public + * @return array + */ + public function getReplyToAddresses() + { + return $this->ReplyTo; + } + + /** + * Allows for public read access to 'all_recipients' property. + * @access public + * @return array + */ + public function getAllRecipientAddresses() + { + return $this->all_recipients; + } + + /** * Perform a callback. - * @param bool $isSent - * @param string $to - * @param string $cc - * @param string $bcc + * @param boolean $isSent + * @param array $to + * @param array $cc + * @param array $bcc * @param string $subject * @param string $body * @param string $from */ - protected function doCallback($isSent, $to, $cc, $bcc, $subject, $body, $from = null) + protected function doCallback($isSent, $to, $cc, $bcc, $subject, $body, $from) { if (!empty($this->action_function) && is_callable($this->action_function)) { $params = array($isSent, $to, $cc, $bcc, $subject, $body, $from); Index: src/wp-includes/class-smtp.php =================================================================== --- src/wp-includes/class-smtp.php (revision 33091) +++ src/wp-includes/class-smtp.php (working copy) @@ -1,108 +1,154 @@ + * PHP Version 5 + * @package PHPMailer + * @link https://github.com/PHPMailer/PHPMailer/ The PHPMailer GitHub project + * @author Marcus Bointon (Synchro/coolbru) * @author Jim Jagielski (jimjag) * @author Andy Prevost (codeworxtech) - * @copyright 2013 Marcus Bointon - * @copyright 2004 - 2008 Andy Prevost + * @author Brent R. Matzelle (original founder) + * @copyright 2014 Marcus Bointon * @copyright 2010 - 2012 Jim Jagielski - * @license http://www.gnu.org/copyleft/lesser.html Distributed under the Lesser General Public License (LGPL) + * @copyright 2004 - 2009 Andy Prevost + * @license http://www.gnu.org/copyleft/lesser.html GNU Lesser General Public License + * @note This program is distributed in the hope that it will be useful - WITHOUT + * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or + * FITNESS FOR A PARTICULAR PURPOSE. */ /** * PHPMailer RFC821 SMTP email transport class. - * - * Implements RFC 821 SMTP commands - * and provides some utility methods for sending mail to an SMTP server. - * - * PHP Version 5.0.0 - * - * @category PHP - * @package PHPMailer - * @link https://github.com/PHPMailer/PHPMailer/blob/master/class.smtp.php - * @author Chris Ryan - * @author Marcus Bointon - * @license http://www.gnu.org/copyleft/lesser.html Distributed under the Lesser General Public License (LGPL) + * Implements RFC 821 SMTP commands and provides some utility methods for sending mail to an SMTP server. + * @package PHPMailer + * @author Chris Ryan + * @author Marcus Bointon */ - class SMTP { /** - * The PHPMailer SMTP Version number. + * The PHPMailer SMTP version number. + * @type string */ - const VERSION = '5.2.7'; + const VERSION = '5.2.10'; /** * SMTP line break constant. + * @type string */ const CRLF = "\r\n"; /** * The SMTP port to use if one is not specified. + * @type integer */ const DEFAULT_SMTP_PORT = 25; /** + * The maximum line length allowed by RFC 2822 section 2.1.1 + * @type integer + */ + const MAX_LINE_LENGTH = 998; + + /** + * Debug level for no output + */ + const DEBUG_OFF = 0; + + /** + * Debug level to show client -> server messages + */ + const DEBUG_CLIENT = 1; + + /** + * Debug level to show client -> server and server -> client messages + */ + const DEBUG_SERVER = 2; + + /** + * Debug level to show connection status, client -> server and server -> client messages + */ + const DEBUG_CONNECTION = 3; + + /** + * Debug level to show all messages + */ + const DEBUG_LOWLEVEL = 4; + + /** * The PHPMailer SMTP Version number. * @type string - * @deprecated This should be a constant + * @deprecated Use the `VERSION` constant instead * @see SMTP::VERSION */ - public $Version = '5.2.7'; + public $Version = '5.2.10'; /** * SMTP server port number. - * @type int - * @deprecated This is only ever ued as default value, so should be a constant + * @type integer + * @deprecated This is only ever used as a default value, so use the `DEFAULT_SMTP_PORT` constant instead * @see SMTP::DEFAULT_SMTP_PORT */ public $SMTP_PORT = 25; /** - * SMTP reply line ending + * SMTP reply line ending. * @type string - * @deprecated Use the class constant instead + * @deprecated Use the `CRLF` constant instead * @see SMTP::CRLF */ public $CRLF = "\r\n"; /** * Debug output level. - * Options: 0 for no output, 1 for commands, 2 for data and commands - * @type int + * Options: + * * self::DEBUG_OFF (`0`) No debug output, default + * * self::DEBUG_CLIENT (`1`) Client commands + * * self::DEBUG_SERVER (`2`) Client commands and server responses + * * self::DEBUG_CONNECTION (`3`) As DEBUG_SERVER plus connection status + * * self::DEBUG_LOWLEVEL (`4`) Low-level data output, all messages + * @type integer */ - public $do_debug = 0; + public $do_debug = self::DEBUG_OFF; /** - * The function/method to use for debugging output. - * Options: 'echo', 'html' or 'error_log' - * @type string + * How to handle debug output. + * Options: + * * `echo` Output plain-text as-is, appropriate for CLI + * * `html` Output escaped, line breaks converted to `
`, appropriate for browser output + * * `error_log` Output to error log as configured in php.ini + * + * Alternatively, you can provide a callable expecting two params: a message string and the debug level: + * + * $smtp->Debugoutput = function($str, $level) {echo "debug level $level; message: $str";}; + * + * @type string|callable */ public $Debugoutput = 'echo'; /** * Whether to use VERP. - * @type bool + * @link http://en.wikipedia.org/wiki/Variable_envelope_return_path + * @link http://www.postfix.org/VERP_README.html Info on VERP + * @type boolean */ public $do_verp = false; /** - * The SMTP timeout value for reads, in seconds. - * @type int + * The timeout value for connection, in seconds. + * Default of 5 minutes (300sec) is from RFC2821 section 4.5.3.2 + * This needs to be quite high to function correctly with hosts using greetdelay as an anti-spam measure. + * @link http://tools.ietf.org/html/rfc2821#section-4.5.3.2 + * @type integer */ - public $Timeout = 15; + public $Timeout = 300; /** - * The SMTP timelimit value for reads, in seconds. - * @type int + * How long to wait for commands to complete, in seconds. + * Default of 5 minutes (300sec) is from RFC2821 section 4.5.3.2 + * @type integer */ - public $Timelimit = 30; + public $Timelimit = 300; /** * The socket for the server connection. @@ -111,43 +157,58 @@ protected $smtp_conn; /** - * Error message, if any, for the last call. - * @type string + * Error information, if any, for the last SMTP command. + * @type array */ - protected $error = ''; + protected $error = array( + 'error' => '', + 'detail' => '', + 'smtp_code' => '', + 'smtp_code_ex' => '' + ); /** * The reply the server sent to us for HELO. - * @type string + * If null, no HELO string has yet been received. + * @type string|null */ - protected $helo_rply = ''; + protected $helo_rply = null; /** + * The set of SMTP extensions sent in reply to EHLO command. + * Indexes of the array are extension names. + * Value at index 'HELO' or 'EHLO' (according to command that was sent) + * represents the server name. In case of HELO it is the only element of the array. + * Other values can be boolean TRUE or an array containing extension options. + * If null, no HELO/EHLO string has yet been received. + * @type array|null + */ + protected $server_caps = null; + + /** * The most recent reply received from the server. * @type string */ protected $last_reply = ''; /** - * Constructor. - * @access public - */ - public function __construct() - { - $this->smtp_conn = 0; - $this->error = null; - $this->helo_rply = null; - - $this->do_debug = 0; - } - - /** * Output debugging info via a user-selected method. + * @see SMTP::$Debugoutput + * @see SMTP::$do_debug * @param string $str Debug string to output + * @param integer $level The debug level of this message; see DEBUG_* constants * @return void */ - protected function edebug($str) + protected function edebug($str, $level = 0) { + if ($level > $this->do_debug) { + return; + } + //Avoid clash with built-in function names + if (!in_array($this->Debugoutput, array('error_log', 'html', 'echo')) and is_callable($this->Debugoutput)) { + call_user_func($this->Debugoutput, $str, $this->do_debug); + return; + } switch ($this->Debugoutput) { case 'error_log': //Don't output, just log @@ -164,94 +225,115 @@ break; case 'echo': default: - //Just echoes whatever was received - echo $str; + //Normalize line breaks + $str = preg_replace('/(\r\n|\r|\n)/ms', "\n", $str); + echo gmdate('Y-m-d H:i:s') . "\t" . str_replace( + "\n", + "\n \t ", + trim($str) + )."\n"; } } /** * Connect to an SMTP server. - * @param string $host SMTP server IP or host name - * @param int $port The port number to connect to - * @param int $timeout How long to wait for the connection to open + * @param string $host SMTP server IP or host name + * @param integer $port The port number to connect to + * @param integer $timeout How long to wait for the connection to open * @param array $options An array of options for stream_context_create() * @access public - * @return bool + * @return boolean */ public function connect($host, $port = null, $timeout = 30, $options = array()) { + static $streamok; + //This is enabled by default since 5.0.0 but some providers disable it + //Check this once and cache the result + if (is_null($streamok)) { + $streamok = function_exists('stream_socket_client'); + } // Clear errors to avoid confusion - $this->error = null; - + $this->setError(''); // Make sure we are __not__ connected if ($this->connected()) { // Already connected, generate error - $this->error = array('error' => 'Already connected to a server'); + $this->setError('Already connected to a server'); return false; } - if (empty($port)) { $port = self::DEFAULT_SMTP_PORT; } - // Connect to the SMTP server + $this->edebug( + "Connection: opening to $host:$port, timeout=$timeout, options=".var_export($options, true), + self::DEBUG_CONNECTION + ); $errno = 0; $errstr = ''; - $socket_context = stream_context_create($options); - //Suppress errors; connection failures are handled at a higher level - $this->smtp_conn = @stream_socket_client( - $host . ":" . $port, - $errno, - $errstr, - $timeout, - STREAM_CLIENT_CONNECT, - $socket_context - ); - + if ($streamok) { + $socket_context = stream_context_create($options); + //Suppress errors; connection failures are handled at a higher level + $this->smtp_conn = @stream_socket_client( + $host . ":" . $port, + $errno, + $errstr, + $timeout, + STREAM_CLIENT_CONNECT, + $socket_context + ); + } else { + //Fall back to fsockopen which should work in more places, but is missing some features + $this->edebug( + "Connection: stream_socket_client not available, falling back to fsockopen", + self::DEBUG_CONNECTION + ); + $this->smtp_conn = fsockopen( + $host, + $port, + $errno, + $errstr, + $timeout + ); + } // Verify we connected properly - if (empty($this->smtp_conn)) { - $this->error = array( - 'error' => 'Failed to connect to server', - 'errno' => $errno, - 'errstr' => $errstr + if (!is_resource($this->smtp_conn)) { + $this->setError( + 'Failed to connect to server', + $errno, + $errstr ); - if ($this->do_debug >= 1) { - $this->edebug( - 'SMTP -> ERROR: ' . $this->error['error'] - . ": $errstr ($errno)" - ); - } + $this->edebug( + 'SMTP ERROR: ' . $this->error['error'] + . ": $errstr ($errno)", + self::DEBUG_CLIENT + ); return false; } - + $this->edebug('Connection: opened', self::DEBUG_CONNECTION); // SMTP server can take longer to respond, give longer timeout for first read // Windows does not have support for this timeout function if (substr(PHP_OS, 0, 3) != 'WIN') { $max = ini_get('max_execution_time'); - if ($max != 0 && $timeout > $max) { // Don't bother if unlimited + // Don't bother if unlimited + if ($max != 0 && $timeout > $max) { @set_time_limit($timeout); } stream_set_timeout($this->smtp_conn, $timeout, 0); } - // Get any announcement $announce = $this->get_lines(); - - if ($this->do_debug >= 2) { - $this->edebug('SMTP -> FROM SERVER:' . $announce); - } - + $this->edebug('SERVER -> CLIENT: ' . $announce, self::DEBUG_SERVER); return true; } /** * Initiate a TLS (encrypted) session. * @access public - * @return bool + * @return boolean */ public function startTLS() { - if (!$this->sendCommand("STARTTLS", "STARTTLS", 220)) { + if (!$this->sendCommand('STARTTLS', 'STARTTLS', 220)) { return false; } // Begin encrypted connection @@ -259,8 +341,7 @@ $this->smtp_conn, true, STREAM_CRYPTO_METHOD_TLS_CLIENT - ) - ) { + )) { return false; } return true; @@ -276,19 +357,57 @@ * @param string $realm The auth realm for NTLM * @param string $workstation The auth workstation for NTLM * @access public - * @return bool True if successfully authenticated. + * @return boolean True if successfully authenticated. */ public function authenticate( $username, $password, - $authtype = 'LOGIN', + $authtype = null, $realm = '', $workstation = '' ) { - if (empty($authtype)) { + if (!$this->server_caps) { + $this->setError('Authentication is not allowed before HELO/EHLO'); + return false; + } + + if (array_key_exists('EHLO', $this->server_caps)) { + // SMTP extensions are available. Let's try to find a proper authentication method + + if (!array_key_exists('AUTH', $this->server_caps)) { + $this->setError('Authentication is not allowed at this stage'); + // 'at this stage' means that auth may be allowed after the stage changes + // e.g. after STARTTLS + return false; + } + + self::edebug('Auth method requested: ' . ($authtype ? $authtype : 'UNKNOWN'), self::DEBUG_LOWLEVEL); + self::edebug( + 'Auth methods available on the server: ' . implode(',', $this->server_caps['AUTH']), + self::DEBUG_LOWLEVEL + ); + + if (empty($authtype)) { + foreach (array('LOGIN', 'CRAM-MD5', 'PLAIN') as $method) { + if (in_array($method, $this->server_caps['AUTH'])) { + $authtype = $method; + break; + } + } + if (empty($authtype)) { + $this->setError('No supported authentication methods found'); + return false; + } + self::edebug('Auth method selected: '.$authtype, self::DEBUG_LOWLEVEL); + } + + if (!in_array($authtype, $this->server_caps['AUTH'])) { + $this->setError("The requested authentication method \"$authtype\" is not supported by the server"); + return false; + } + } elseif (empty($authtype)) { $authtype = 'LOGIN'; } - switch ($authtype) { case 'PLAIN': // Start authentication @@ -317,59 +436,6 @@ return false; } break; - case 'NTLM': - /* - * ntlm_sasl_client.php - * Bundled with Permission - * - * How to telnet in windows: - * http://technet.microsoft.com/en-us/library/aa995718%28EXCHG.65%29.aspx - * PROTOCOL Docs http://curl.haxx.se/rfc/ntlm.html#ntlmSmtpAuthentication - */ - require_once 'extras/ntlm_sasl_client.php'; - $temp = new stdClass(); - $ntlm_client = new ntlm_sasl_client_class; - //Check that functions are available - if (!$ntlm_client->Initialize($temp)) { - $this->error = array('error' => $temp->error); - if ($this->do_debug >= 1) { - $this->edebug( - 'You need to enable some modules in your php.ini file: ' - . $this->error['error'] - ); - } - return false; - } - //msg1 - $msg1 = $ntlm_client->TypeMsg1($realm, $workstation); //msg1 - - if (!$this->sendCommand( - 'AUTH NTLM', - 'AUTH NTLM ' . base64_encode($msg1), - 334 - ) - ) { - return false; - } - - //Though 0 based, there is a white space after the 3 digit number - //msg2 - $challenge = substr($this->last_reply, 3); - $challenge = base64_decode($challenge); - $ntlm_res = $ntlm_client->NTLMResponse( - substr($challenge, 24, 8), - $password - ); - //msg3 - $msg3 = $ntlm_client->TypeMsg3( - $ntlm_res, - $username, - $realm, - $workstation - ); - // send encoded username - return $this->sendCommand('Username', base64_encode($msg3), 235); - break; case 'CRAM-MD5': // Start authentication if (!$this->sendCommand('AUTH CRAM-MD5', 'AUTH CRAM-MD5', 334)) { @@ -383,7 +449,9 @@ // send encoded credentials return $this->sendCommand('Username', base64_encode($response), 235); - break; + default: + $this->setError("Authentication method \"$authtype\" is not supported"); + return false; } return true; } @@ -411,13 +479,13 @@ // Eliminates the need to install mhash to compute a HMAC // by Lance Rushing - $b = 64; // byte length for md5 - if (strlen($key) > $b) { + $bytelen = 64; // byte length for md5 + if (strlen($key) > $bytelen) { $key = pack('H*', md5($key)); } - $key = str_pad($key, $b, chr(0x00)); - $ipad = str_pad('', $b, chr(0x36)); - $opad = str_pad('', $b, chr(0x5c)); + $key = str_pad($key, $bytelen, chr(0x00)); + $ipad = str_pad('', $bytelen, chr(0x36)); + $opad = str_pad('', $bytelen, chr(0x5c)); $k_ipad = $key ^ $ipad; $k_opad = $key ^ $opad; @@ -427,19 +495,18 @@ /** * Check connection state. * @access public - * @return bool True if connected. + * @return boolean True if connected. */ public function connected() { - if (!empty($this->smtp_conn)) { + if (is_resource($this->smtp_conn)) { $sock_status = stream_get_meta_data($this->smtp_conn); if ($sock_status['eof']) { - // the socket is valid but we are not connected - if ($this->do_debug >= 1) { - $this->edebug( - 'SMTP -> NOTICE: EOF caught while checking if connected' - ); - } + // The socket is valid but we are not connected + $this->edebug( + 'SMTP NOTICE: EOF caught while checking if connected', + self::DEBUG_CLIENT + ); $this->close(); return false; } @@ -457,12 +524,14 @@ */ public function close() { - $this->error = null; // so there is no confusion + $this->setError(''); + $this->server_caps = null; $this->helo_rply = null; - if (!empty($this->smtp_conn)) { + if (is_resource($this->smtp_conn)) { // close the connection and cleanup fclose($this->smtp_conn); - $this->smtp_conn = 0; + $this->smtp_conn = null; //Makes for cleaner serialization + $this->edebug('Connection: closed', self::DEBUG_CONNECTION); } } @@ -476,111 +545,101 @@ * Implements rfc 821: DATA * @param string $msg_data Message data to send * @access public - * @return bool + * @return boolean */ public function data($msg_data) { + //This will use the standard timelimit if (!$this->sendCommand('DATA', 'DATA', 354)) { return false; } /* The server is ready to accept data! - * according to rfc821 we should not send more than 1000 - * including the CRLF - * characters on a single line so we will break the data up - * into lines by \r and/or \n then if needed we will break - * each of those into smaller lines to fit within the limit. - * in addition we will be looking for lines that start with - * a period '.' and append and additional period '.' to that - * line. NOTE: this does not count towards limit. + * According to rfc821 we should not send more than 1000 characters on a single line (including the CRLF) + * so we will break the data up into lines by \r and/or \n then if needed we will break each of those into + * smaller lines to fit within the limit. + * We will also look for lines that start with a '.' and prepend an additional '.'. + * NOTE: this does not count towards line-length limit. */ - // Normalize the line breaks before exploding - $msg_data = str_replace("\r\n", "\n", $msg_data); - $msg_data = str_replace("\r", "\n", $msg_data); - $lines = explode("\n", $msg_data); + // Normalize line breaks before exploding + $lines = explode("\n", str_replace(array("\r\n", "\r"), "\n", $msg_data)); - /* We need to find a good way to determine if headers are - * in the msg_data or if it is a straight msg body - * currently I am assuming rfc822 definitions of msg headers - * and if the first field of the first line (':' separated) - * does not contain a space then it _should_ be a header - * and we can process all lines before a blank "" line as - * headers. + /* To distinguish between a complete RFC822 message and a plain message body, we check if the first field + * of the first line (':' separated) does not contain a space then it _should_ be a header and we will + * process all lines before a blank line as headers. */ $field = substr($lines[0], 0, strpos($lines[0], ':')); $in_headers = false; - if (!empty($field) && !strstr($field, ' ')) { + if (!empty($field) && strpos($field, ' ') === false) { $in_headers = true; } - //RFC 2822 section 2.1.1 limit - $max_line_length = 998; - foreach ($lines as $line) { - $lines_out = null; - if ($line == '' && $in_headers) { + $lines_out = array(); + if ($in_headers and $line == '') { $in_headers = false; } - // ok we need to break this line up into several smaller lines - while (strlen($line) > $max_line_length) { - $pos = strrpos(substr($line, 0, $max_line_length), ' '); - - // Patch to fix DOS attack + //Break this line up into several smaller lines if it's too long + //Micro-optimisation: isset($str[$len]) is faster than (strlen($str) > $len), + while (isset($line[self::MAX_LINE_LENGTH])) { + //Working backwards, try to find a space within the last MAX_LINE_LENGTH chars of the line to break on + //so as to avoid breaking in the middle of a word + $pos = strrpos(substr($line, 0, self::MAX_LINE_LENGTH), ' '); + //Deliberately matches both false and 0 if (!$pos) { - $pos = $max_line_length - 1; + //No nice break found, add a hard break + $pos = self::MAX_LINE_LENGTH - 1; $lines_out[] = substr($line, 0, $pos); $line = substr($line, $pos); } else { + //Break at the found point $lines_out[] = substr($line, 0, $pos); + //Move along by the amount we dealt with $line = substr($line, $pos + 1); } - - /* If processing headers add a LWSP-char to the front of new line - * rfc822 on long msg headers - */ + //If processing headers add a LWSP-char to the front of new line RFC822 section 3.1.1 if ($in_headers) { $line = "\t" . $line; } } $lines_out[] = $line; - // send the lines to the server - while (list(, $line_out) = @each($lines_out)) { - if (strlen($line_out) > 0) { - if (substr($line_out, 0, 1) == '.') { - $line_out = '.' . $line_out; - } + //Send the lines to the server + foreach ($lines_out as $line_out) { + //RFC2821 section 4.5.2 + if (!empty($line_out) and $line_out[0] == '.') { + $line_out = '.' . $line_out; } $this->client_send($line_out . self::CRLF); } } - // Message data has been sent, complete the command - return $this->sendCommand('DATA END', '.', 250); + //Message data has been sent, complete the command + //Increase timelimit for end of DATA command + $savetimelimit = $this->Timelimit; + $this->Timelimit = $this->Timelimit * 2; + $result = $this->sendCommand('DATA END', '.', 250); + //Restore timelimit + $this->Timelimit = $savetimelimit; + return $result; } /** * Send an SMTP HELO or EHLO command. * Used to identify the sending server to the receiving server. * This makes sure that client and server are in a known state. - * Implements from RFC 821: HELO + * Implements RFC 821: HELO * and RFC 2821 EHLO. * @param string $host The host name or IP to connect to * @access public - * @return bool + * @return boolean */ public function hello($host = '') { - // Try extended hello first (RFC 2821) - if (!$this->sendHello('EHLO', $host)) { - if (!$this->sendHello('HELO', $host)) { - return false; - } - } - - return true; + //Try extended hello first (RFC 2821) + return (boolean)($this->sendHello('EHLO', $host) or $this->sendHello('HELO', $host)); } /** @@ -588,18 +647,54 @@ * Low-level implementation used by hello() * @see hello() * @param string $hello The HELO string - * @param string $host The hostname to say we are + * @param string $host The hostname to say we are * @access protected - * @return bool + * @return boolean */ protected function sendHello($hello, $host) { $noerror = $this->sendCommand($hello, $hello . ' ' . $host, 250); $this->helo_rply = $this->last_reply; + if ($noerror) { + $this->parseHelloFields($hello); + } else { + $this->server_caps = null; + } return $noerror; } /** + * Parse a reply to HELO/EHLO command to discover server extensions. + * In case of HELO, the only parameter that can be discovered is a server name. + * @access protected + * @param string $type - 'HELO' or 'EHLO' + */ + protected function parseHelloFields($type) + { + $this->server_caps = array(); + $lines = explode("\n", $this->last_reply); + foreach ($lines as $n => $s) { + $s = trim(substr($s, 4)); + if (!$s) { + continue; + } + $fields = explode(' ', $s); + if (!empty($fields)) { + if (!$n) { + $name = $type; + $fields = $fields[0]; + } else { + $name = array_shift($fields); + if ($name == 'SIZE') { + $fields = ($fields) ? $fields[0] : 0; + } + } + $this->server_caps[$name] = ($fields ? $fields : true); + } + } + } + + /** * Send an SMTP MAIL command. * Starts a mail transaction from the email address specified in * $from. Returns true if successful or false otherwise. If True @@ -608,7 +703,7 @@ * Implements rfc 821: MAIL FROM: * @param string $from Source address of this message * @access public - * @return bool + * @return boolean */ public function mail($from) { @@ -624,35 +719,35 @@ * Send an SMTP QUIT command. * Closes the socket if there is no error or the $close_on_error argument is true. * Implements from rfc 821: QUIT - * @param bool $close_on_error Should the connection close if an error occurs? + * @param boolean $close_on_error Should the connection close if an error occurs? * @access public - * @return bool + * @return boolean */ public function quit($close_on_error = true) { $noerror = $this->sendCommand('QUIT', 'QUIT', 221); - $e = $this->error; //Save any error + $err = $this->error; //Save any error if ($noerror or $close_on_error) { $this->close(); - $this->error = $e; //Restore any error from the quit command + $this->error = $err; //Restore any error from the quit command } return $noerror; } /** * Send an SMTP RCPT command. - * Sets the TO argument to $to. + * Sets the TO argument to $toaddr. * Returns true if the recipient was accepted false if it was rejected. * Implements from rfc 821: RCPT TO: - * @param string $to The address the message is being sent to + * @param string $toaddr The address the message is being sent to * @access public - * @return bool + * @return boolean */ - public function recipient($to) + public function recipient($toaddr) { return $this->sendCommand( - 'RCPT TO ', - 'RCPT TO:<' . $to . '>', + 'RCPT TO', + 'RCPT TO:<' . $toaddr . '>', array(250, 251) ); } @@ -662,7 +757,7 @@ * Abort any transaction that is currently in progress. * Implements rfc 821: RSET * @access public - * @return bool True on success. + * @return boolean True on success. */ public function reset() { @@ -673,44 +768,54 @@ * Send a command to an SMTP server and check its return code. * @param string $command The command name - not sent to the server * @param string $commandstring The actual command to send - * @param int|array $expect One or more expected integer success codes + * @param integer|array $expect One or more expected integer success codes * @access protected - * @return bool True on success. + * @return boolean True on success. */ protected function sendCommand($command, $commandstring, $expect) { if (!$this->connected()) { - $this->error = array( - "error" => "Called $command without being connected" - ); + $this->setError("Called $command without being connected"); return false; } $this->client_send($commandstring . self::CRLF); - $reply = $this->get_lines(); - $code = substr($reply, 0, 3); - - if ($this->do_debug >= 2) { - $this->edebug('SMTP -> FROM SERVER:' . $reply); + $this->last_reply = $this->get_lines(); + // Fetch SMTP code and possible error code explanation + $matches = array(); + if (preg_match("/^([0-9]{3})[ -](?:([0-9]\\.[0-9]\\.[0-9]) )?/", $this->last_reply, $matches)) { + $code = $matches[1]; + $code_ex = (count($matches) > 2 ? $matches[2] : null); + // Cut off error code from each response line + $detail = preg_replace( + "/{$code}[ -]".($code_ex ? str_replace('.', '\\.', $code_ex).' ' : '')."/m", + '', + $this->last_reply + ); + } else { + // Fall back to simple parsing if regex fails + $code = substr($this->last_reply, 0, 3); + $code_ex = null; + $detail = substr($this->last_reply, 4); } + $this->edebug('SERVER -> CLIENT: ' . $this->last_reply, self::DEBUG_SERVER); + if (!in_array($code, (array)$expect)) { - $this->last_reply = null; - $this->error = array( - "error" => "$command command failed", - "smtp_code" => $code, - "detail" => substr($reply, 4) + $this->setError( + "$command command failed", + $detail, + $code, + $code_ex ); - if ($this->do_debug >= 1) { - $this->edebug( - 'SMTP -> ERROR: ' . $this->error['error'] . ': ' . $reply - ); - } + $this->edebug( + 'SMTP ERROR: ' . $this->error['error'] . ': ' . $this->last_reply, + self::DEBUG_CLIENT + ); return false; } - $this->last_reply = $reply; - $this->error = null; + $this->setError(''); return true; } @@ -725,52 +830,48 @@ * Implements rfc 821: SAML FROM: * @param string $from The address the message is from * @access public - * @return bool + * @return boolean */ public function sendAndMail($from) { - return $this->sendCommand("SAML", "SAML FROM:$from", 250); + return $this->sendCommand('SAML', "SAML FROM:$from", 250); } /** * Send an SMTP VRFY command. * @param string $name The name to verify * @access public - * @return bool + * @return boolean */ public function verify($name) { - return $this->sendCommand("VRFY", "VRFY $name", array(250, 251)); + return $this->sendCommand('VRFY', "VRFY $name", array(250, 251)); } /** * Send an SMTP NOOP command. * Used to keep keep-alives alive, doesn't actually do anything * @access public - * @return bool + * @return boolean */ public function noop() { - return $this->sendCommand("NOOP", "NOOP", 250); + return $this->sendCommand('NOOP', 'NOOP', 250); } /** * Send an SMTP TURN command. * This is an optional command for SMTP that this class does not support. - * This method is here to make the RFC821 Definition - * complete for this class and __may__ be implemented in future + * This method is here to make the RFC821 Definition complete for this class + * and _may_ be implemented in future * Implements from rfc 821: TURN * @access public - * @return bool + * @return boolean */ public function turn() { - $this->error = array( - 'error' => 'The SMTP TURN command is not implemented' - ); - if ($this->do_debug >= 1) { - $this->edebug('SMTP -> NOTICE: ' . $this->error['error']); - } + $this->setError('The SMTP TURN command is not implemented'); + $this->edebug('SMTP NOTICE: ' . $this->error['error'], self::DEBUG_CLIENT); return false; } @@ -778,13 +879,11 @@ * Send raw data to the server. * @param string $data The data to send * @access public - * @return int|bool The number of bytes sent to the server or FALSE on error + * @return integer|boolean The number of bytes sent to the server or false on error */ public function client_send($data) { - if ($this->do_debug >= 1) { - $this->edebug("CLIENT -> SMTP: $data"); - } + $this->edebug("CLIENT -> SERVER: $data", self::DEBUG_CLIENT); return fwrite($this->smtp_conn, $data); } @@ -799,6 +898,57 @@ } /** + * Get SMTP extensions available on the server + * @access public + * @return array|null + */ + public function getServerExtList() + { + return $this->server_caps; + } + + /** + * A multipurpose method + * The method works in three ways, dependent on argument value and current state + * 1. HELO/EHLO was not sent - returns null and set up $this->error + * 2. HELO was sent + * $name = 'HELO': returns server name + * $name = 'EHLO': returns boolean false + * $name = any string: returns null and set up $this->error + * 3. EHLO was sent + * $name = 'HELO'|'EHLO': returns server name + * $name = any string: if extension $name exists, returns boolean True + * or its options. Otherwise returns boolean False + * In other words, one can use this method to detect 3 conditions: + * - null returned: handshake was not or we don't know about ext (refer to $this->error) + * - false returned: the requested feature exactly not exists + * - positive value returned: the requested feature exists + * @param string $name Name of SMTP extension or 'HELO'|'EHLO' + * @return mixed + */ + public function getServerExt($name) + { + if (!$this->server_caps) { + $this->setError('No HELO/EHLO was sent'); + return null; + } + + // the tight logic knot ;) + if (!array_key_exists($name, $this->server_caps)) { + if ($name == 'HELO') { + return $this->server_caps['EHLO']; + } + if ($name == 'EHLO' || array_key_exists('EHLO', $this->server_caps)) { + return false; + } + $this->setError('HELO handshake was used. Client knows nothing about server extensions'); + return null; + } + + return $this->server_caps[$name]; + } + + /** * Get the last reply from the server. * @access public * @return string @@ -819,51 +969,43 @@ */ protected function get_lines() { + // If the connection is bad, give up straight away + if (!is_resource($this->smtp_conn)) { + return ''; + } $data = ''; $endtime = 0; - // If the connection is bad, give up now - if (!is_resource($this->smtp_conn)) { - return $data; - } stream_set_timeout($this->smtp_conn, $this->Timeout); if ($this->Timelimit > 0) { $endtime = time() + $this->Timelimit; } while (is_resource($this->smtp_conn) && !feof($this->smtp_conn)) { $str = @fgets($this->smtp_conn, 515); - if ($this->do_debug >= 4) { - $this->edebug("SMTP -> get_lines(): \$data was \"$data\""); - $this->edebug("SMTP -> get_lines(): \$str is \"$str\""); - } + $this->edebug("SMTP -> get_lines(): \$data was \"$data\"", self::DEBUG_LOWLEVEL); + $this->edebug("SMTP -> get_lines(): \$str is \"$str\"", self::DEBUG_LOWLEVEL); $data .= $str; - if ($this->do_debug >= 4) { - $this->edebug("SMTP -> get_lines(): \$data is \"$data\""); - } - // if 4th character is a space, we are done reading, break the loop - if (substr($str, 3, 1) == ' ') { + $this->edebug("SMTP -> get_lines(): \$data is \"$data\"", self::DEBUG_LOWLEVEL); + // If 4th character is a space, we are done reading, break the loop, micro-optimisation over strlen + if ((isset($str[3]) and $str[3] == ' ')) { break; } // Timed-out? Log and break $info = stream_get_meta_data($this->smtp_conn); if ($info['timed_out']) { - if ($this->do_debug >= 4) { - $this->edebug( - 'SMTP -> get_lines(): timed-out (' . $this->Timeout . ' sec)' - ); - } + $this->edebug( + 'SMTP -> get_lines(): timed-out (' . $this->Timeout . ' sec)', + self::DEBUG_LOWLEVEL + ); break; } // Now check if reads took too long - if ($endtime) { - if (time() > $endtime) { - if ($this->do_debug >= 4) { - $this->edebug( - 'SMTP -> get_lines(): timelimit reached (' - . $this->Timelimit . ' sec)' - ); - } - break; - } + if ($endtime and time() > $endtime) { + $this->edebug( + 'SMTP -> get_lines(): timelimit reached ('. + $this->Timelimit . ' sec)', + self::DEBUG_LOWLEVEL + ); + break; } } return $data; @@ -871,7 +1013,7 @@ /** * Enable or disable VERP address generation. - * @param bool $enabled + * @param boolean $enabled */ public function setVerp($enabled = false) { @@ -880,7 +1022,7 @@ /** * Get VERP address generation mode. - * @return bool + * @return boolean */ public function getVerp() { @@ -888,8 +1030,25 @@ } /** + * Set error messages and codes. + * @param string $message The error message + * @param string $detail Further detail on the error + * @param string $smtp_code An associated SMTP error code + * @param string $smtp_code_ex Extended SMTP code + */ + protected function setError($message, $detail = '', $smtp_code = '', $smtp_code_ex = '') + { + $this->error = array( + 'error' => $message, + 'detail' => $detail, + 'smtp_code' => $smtp_code, + 'smtp_code_ex' => $smtp_code_ex + ); + } + + /** * Set debug output method. - * @param string $method The function/method to use for debugging output. + * @param string|callable $method The name of the mechanism to use for debugging output, or a callable to handle it. */ public function setDebugOutput($method = 'echo') { @@ -907,7 +1066,7 @@ /** * Set debug output level. - * @param int $level + * @param integer $level */ public function setDebugLevel($level = 0) { @@ -916,7 +1075,7 @@ /** * Get debug output level. - * @return int + * @return integer */ public function getDebugLevel() { @@ -925,7 +1084,7 @@ /** * Set SMTP timeout. - * @param int $timeout + * @param integer $timeout */ public function setTimeout($timeout = 0) { @@ -934,7 +1093,7 @@ /** * Get SMTP timeout. - * @return int + * @return integer */ public function getTimeout() { Index: src/wp-includes/css/dashicons.css =================================================================== --- src/wp-includes/css/dashicons.css (revision 33091) +++ src/wp-includes/css/dashicons.css (working copy) @@ -5,7 +5,7 @@ @font-face { font-family: "dashicons"; - src: url(data:application/x-font-woff;charset=utf-8;base64,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) format('woff'), + src: url(data:application/font-woff;charset=utf-8;base64,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) format('woff'), url(../fonts/dashicons.ttf) format("truetype"), url(../fonts/dashicons.svg#dashicons) format("svg"); font-weight: normal; @@ -93,7 +93,19 @@ content: "\f148"; } +.dashicons-filter:before { + content: "\f536"; +} +.dashicons-admin-customizer:before { + content: "\f540"; +} + +.dashicons-admin-multisite:before { + content: "\f541"; +} + + /* Both Admin Menu and Post Formats */ .dashicons-admin-links:before, @@ -176,6 +188,11 @@ content: "\f165"; } +.dashicons-image-rotate:before { + content: "\f531"; +} + + .dashicons-image-rotate-left:before { content: "\f166"; } @@ -192,7 +209,11 @@ content: "\f169"; } +.dashicons-image-filter:before { + content: "\f533"; +} + /* Both Image Editing and TinyMCE */ .dashicons-undo:before { @@ -326,6 +347,10 @@ content: "\f476"; } +.dashicons-editor-table:before { + content: "\f535"; +} + /* Post Icons */ .dashicons-align-left:before { @@ -348,6 +373,10 @@ content: "\f160"; } +.dashicons-unlock:before { + content: "\f528"; +} + .dashicons-calendar:before { content: "\f145"; } @@ -360,6 +389,10 @@ content: "\f177"; } +.dashicons-hidden:before { + content: "\f530"; +} + .dashicons-post-status:before { content: "\f173"; } @@ -373,7 +406,11 @@ content: "\f182"; } +.dashicons-sticky:before { + content: "\f537"; +} + /* Sorting */ .dashicons-external:before { @@ -527,10 +564,6 @@ content: "\f180"; } -.dashicons-info:before { - content: "\f348"; -} - .dashicons-cart:before { content: "\f174"; } @@ -707,7 +740,15 @@ content: "\f227"; } +.dashicons-info:before { + content: "\f348"; +} +.dashicons-warning:before { + content: "\f534"; +} + + /* Social Icons */ .dashicons-share:before { @@ -956,3 +997,15 @@ .dashicons-money:before { content: "\f526"; } + +.dashicons-thumbsup:before { + content: "\f529"; +} + +.dashicons-thumbsdown:before { + content: "\f529.001"; +} + +.dashicons-layout:before { + content: "\f538"; +}