~canonical-sysadmins/wordpress/4.8.3

 * PHP Version 5

 * @link https://github.com/PHPMailer/PHPMailer/ The PHPMailer GitHub project

 * @author Marcus Bointon (Synchro/coolbru) <phpmailer@synchromedia.co.uk>

 * @copyright 2012 - 2014 Marcus Bointon

 * @author Marcus Bointon (Synchro/coolbru) <phpmailer@synchromedia.co.uk>

    public $Version = '5.2.10';

     * @type integer

     * @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

     * Set to 0 to not wrap. A useful value here is 78, for RFC2822 section 2.1.1 compliance.

     * @type integer

     * @type boolean

     * You can also specify encryption type, for example:

     * (e.g. "tls://smtp1.example.com:587;ssl://smtp2.example.com:465").

     * @type integer

     * @TODO Why is this needed when the SMTP class takes care of it?

     * What kind of encryption to use on the SMTP connection.

     * Options: '', 'ssl' or 'tls'

     * 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;

 

    /**

     * @type boolean

     * Options array passed to stream_context_create when connecting via SMTP.

     * @type array

     */

    public $SMTPOptions = array();

 

    /**

     * Default of 5 minutes (300sec) is from RFC2821 section 4.5.3.2

     * @type integer

    public $Timeout = 300;

     * 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

     * How to handle debug output.

     * Options:

     * * `echo` Output plain-text as-is, appropriate for CLI

     * * `html` Output escaped, line breaks converted to `<br>`, 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:

     * <code>

     * $mail->Debugoutput = function($str, $level) {echo "debug level $level; message: $str";};

     * </code>

     * @type string|callable

    public $Debugoutput = 'echo';

     * @type boolean

     * @type boolean

     * @TODO This should really not be public

     * @link http://www.postfix.org/VERP_README.html Postfix VERP info

     * @type boolean

     * @type boolean

     * Value can be any php callable: http://www.php.net/is_callable

     *   boolean $result        result of the send action

     * What to put in the X-Mailer header.

     * Options: An empty string for PHPMailer default, whitespace for none, or a string to use

     * Includes all of $to, $cc, $bcc

     * The optional S/MIME extra certificates ("CA Chain") file path.

     * @type string

     * @access protected

     */

    protected $sign_extracerts_file = '';

 

    /**

     * @type boolean

     * Unique ID used for message ID and boundaries.

     * @type string

     * @access protected

     */

    protected $uniqueid = '';

 

    /**

     * Error severity: message only, continue processing.

     * Error severity: message, likely ok to continue processing.

     * Error severity: message, plus full stop, critical error reached.

     * SMTP RFC standard line ending.

     * 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?

        $this->exceptions = (boolean)$exceptions;

        //Close any open SMTP connection nicely

        if ($this->Mailer == 'smtp') {

     * @return boolean

        //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));

        }

            $result = @mail($to, $subject, $body, $header);

            $result = @mail($to, $subject, $body, $header, $params);

        return $result;

     * Only generates output if SMTP debug output is enabled (@see SMTP::$do_debug).

        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);

                //Don't output, just log

                //Cleans up output a bit for a better looking, HTML-safe output

                echo htmlentities(

                    preg_replace('/[\r\n]+/', '', $str),

                    ENT_QUOTES,

                    'UTF-8'

                )

                . "<br>\n";

                //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";

     * @param boolean $isHtml True for HTML mode.

    public function isHTML($isHtml = true)

        if ($isHtml) {

        $ini_sendmail_path = ini_get('sendmail_path');

 

        if (!stristr($ini_sendmail_path, 'sendmail')) {

            $this->Sendmail = '/usr/sbin/sendmail';

        } else {

            $this->Sendmail = $ini_sendmail_path;

        $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 = 'qmail';

     * @return boolean true on success, false if address already used

     * @return boolean true on success, false if address already used

     * @return boolean true on success, false if address already used

     * @return boolean

     * @return boolean true on success, false if address already used or invalid in some way

            $this->edebug($this->lang('Invalid recipient array') . ': ' . $kind);

            $this->edebug($this->lang('invalid_address') . ': ' . $address);

     * @param boolean $auto Whether to also set the Sender address, defaults to true

     * @return boolean

            $this->edebug($this->lang('invalid_address') . ': ' . $address);

     * * `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

        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) {

            } elseif (function_exists('extension_loaded') and extension_loaded('pcre')) {

                //Fall back to older PCRE

                $patternselect = 'pcre';

                 * Uses the same RFC5322 regex on which FILTER_VALIDATE_EMAIL is based, but allows dotless domains.

                return (boolean)preg_match(

                return (boolean)preg_match(

            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 'php':

            default:

                return (boolean)filter_var($address, FILTER_VALIDATE_EMAIL);

     * @return boolean false on error - See the ErrorInfo property for details of the error.

        } catch (phpmailerException $exc) {

            $this->setError($exc->getMessage());

                throw $exc;

     * @return boolean

            $this->mailHeader = '';

            $this->error_count = 0; // Reset errors

            // 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 .= $tempheaders;

                    $this->mailHeader .= $this->addrAppend('To', $this->to);

                    $this->mailHeader .= $this->headerLine('To', 'undisclosed-recipients:;');

        } catch (phpmailerException $exc) {

            $this->setError($exc->getMessage());

                throw $exc;

     * @return boolean

                case 'qmail':

                    $sendMethod = $this->Mailer.'Send';

                    if (method_exists($this, $sendMethod)) {

                        return $this->$sendMethod($this->MIMEHeader, $this->MIMEBody);

                    }

 

        } catch (phpmailerException $exc) {

            $this->setError($exc->getMessage());

            $this->edebug($exc->getMessage());

                throw $exc;

     * @return boolean

            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));

            }

            if ($this->Mailer == 'qmail') {

                $sendmail = sprintf('%s', escapeshellcmd($this->Sendmail));

            } else {

                $sendmail = sprintf('%s -oi -t', escapeshellcmd($this->Sendmail));

            }

        if ($this->SingleTo) {

            foreach ($this->SingleToArray as $toAddr) {

                fputs($mail, 'To: ' . $toAddr . "\n");

                $this->doCallback(

                    ($result == 0),

                    array($toAddr),

                    $this->cc,

                    $this->bcc,

                    $this->Subject,

                    $body,

                    $this->From

                );

            $this->doCallback(($result == 0), $this->to, $this->cc, $this->bcc, $this->Subject, $body, $this->From);

     * @return boolean

        foreach ($this->to as $toaddr) {

            $toArr[] = $this->addrFormat($toaddr);

            $params = ' ';

            $params = sprintf('-f%s', $this->Sender);

        $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);

            $result = $this->mailPassthru($to, $this->Subject, $body, $header, $params);

            $this->doCallback($result, $this->to, $this->cc, $this->bcc, $this->Subject, $body, $this->From);

        if (!$result) {

                require_once( 'class-smtp.php' );

     * @return boolean

        if (!$this->smtpConnect($this->SMTPOptions)) {

        if ('' == $this->Sender) {

            $smtp_from = $this->From;

        } else {

            $smtp_from = $this->Sender;

        }

        // 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);

            }

        // Only send the DATA command if we have viable recipients

        if ((count($this->all_recipients) > count($bad_rcpt)) and !$this->smtp->data($header . $body)) {

        if ($this->SMTPKeepAlive) {

        //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 boolean

        // Already connected?

            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];

            $tport = (integer)$hostinfo[4];

            if ($tport > 0 and $tport < 65536) {

                $port = $tport;

            if ($this->smtp->connect($prefix . $host, $port, $this->Timeout, $options)) {

                    //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;

                    }

                        // We must resend HELO after tls negotiation

                } catch (phpmailerException $exc) {

                    $lastexception = $exc;

                    $this->edebug($exc->getMessage());

                    // We must have connected, but then failed TLS or Auth, so close connection nicely

        // If we get here, all connection attempts have failed, so close connection hard

        // As we've caught all exceptions, just report whatever the last one was

     * @return boolean

    public function setLanguage($langcode = 'en', $lang_path = '')

        // Define full set of translatable strings in English

            'variable_set' => 'Cannot set or reset variable: ',

            'extension_missing' => 'Extension missing: '

        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;

            }

        return (boolean)$foundlang; // Returns false if language not found

        foreach ($addr as $address) {

            $addresses[] = $this->addrFormat($address);

            return $this->encodeHeader($this->secureHeader($addr[1]), 'phrase') . ' <' . $this->secureHeader(

            ) . '>';