<?php

/**

 * PHPMailer - PHP email creation and transport class.

 * PHP Version 5.5.

 *

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

 *

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

 * @author    Jim Jagielski (jimjag) <jimjag@gmail.com>

 * @author    Andy Prevost (codeworxtech) <codeworxtech@users.sourceforge.net>

 * @author    Brent R. Matzelle (original founder)

 * @copyright 2012 - 2020 Marcus Bointon

 * @copyright 2010 - 2012 Jim Jagielski

 * @copyright 2004 - 2009 Andy Prevost

 * @license   https://www.gnu.org/licenses/old-licenses/lgpl-2.1.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.

 */

namespace PHPMailer\PHPMailer;

/**

 * PHPMailer - PHP email creation and transport class.

 *

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

 * @author Jim Jagielski (jimjag) <jimjag@gmail.com>

 * @author Andy Prevost (codeworxtech) <codeworxtech@users.sourceforge.net>

 * @author Brent R. Matzelle (original founder)

 */

class PHPMailer

{

    const CHARSET_ASCII = 'us-ascii';

    const CHARSET_ISO88591 = 'iso-8859-1';

    const CHARSET_UTF8 = 'utf-8';

    const CONTENT_TYPE_PLAINTEXT = 'text/plain';

    const CONTENT_TYPE_TEXT_CALENDAR = 'text/calendar';

    const CONTENT_TYPE_TEXT_HTML = 'text/html';

    const CONTENT_TYPE_MULTIPART_ALTERNATIVE = 'multipart/alternative';

    const CONTENT_TYPE_MULTIPART_MIXED = 'multipart/mixed';

    const CONTENT_TYPE_MULTIPART_RELATED = 'multipart/related';

    const ENCODING_7BIT = '7bit';

    const ENCODING_8BIT = '8bit';

    const ENCODING_BASE64 = 'base64';

    const ENCODING_BINARY = 'binary';

    const ENCODING_QUOTED_PRINTABLE = 'quoted-printable';

    const ENCRYPTION_STARTTLS = 'tls';

    const ENCRYPTION_SMTPS = 'ssl';

    const ICAL_METHOD_REQUEST = 'REQUEST';

    const ICAL_METHOD_PUBLISH = 'PUBLISH';

    const ICAL_METHOD_REPLY = 'REPLY';

    const ICAL_METHOD_ADD = 'ADD';

    const ICAL_METHOD_CANCEL = 'CANCEL';

    const ICAL_METHOD_REFRESH = 'REFRESH';

    const ICAL_METHOD_COUNTER = 'COUNTER';

    const ICAL_METHOD_DECLINECOUNTER = 'DECLINECOUNTER';

    /**

     * Email priority.

     * Options: null (default), 1 = High, 3 = Normal, 5 = low.

     * When null, the header is not set at all.

     *

     * @var int|null

     */

    public $Priority;

    /**

     * The character set of the message.

     *

     * @var string

     */

    public $CharSet = self::CHARSET_ISO88591;

    /**

     * The MIME Content-type of the message.

     *

     * @var string

     */

    public $ContentType = self::CONTENT_TYPE_PLAINTEXT;

    /**

     * The message encoding.

     * Options: "8bit", "7bit", "binary", "base64", and "quoted-printable".

     *

     * @var string

     */

    public $Encoding = self::ENCODING_8BIT;

    /**

     * Holds the most recent mailer error message.

     *

     * @var string

     */

    public $ErrorInfo = '';

    /**

     * The From email address for the message.

     *

     * @var string

     */

    public $From = '';

    /**

     * The From name of the message.

     *

     * @var string

     */

    public $FromName = '';

    /**

     * The envelope sender of the message.

     * This will usually be turned into a Return-Path header by the receiver,

     * and is the address that bounces will be sent to.

     * If not empty, will be passed via `-f` to sendmail or as the 'MAIL FROM' value over SMTP.

     *

     * @var string

     */

    public $Sender = '';

    /**

     * The Subject of the message.

     *

     * @var string

     */

    public $Subject = '';

    /**

     * An HTML or plain text message body.

     * If HTML then call isHTML(true).

     *

     * @var string

     */

    public $Body = '';

    /**

     * The plain-text message body.

     * This body can be read by mail clients that do not have HTML email

     * capability such as mutt & Eudora.

     * Clients that can read HTML will view the normal Body.

     *

     * @var string

     */

    public $AltBody = '';

    /**

     * An iCal message part body.

     * Only supported in simple alt or alt_inline message types

     * To generate iCal event structures, use classes like EasyPeasyICS or iCalcreator.

     *

     * @see https://kigkonsult.se/iCalcreator/

     *

     * @var string

     */

    public $Ical = '';

    /**

     * Value-array of "method" in Contenttype header "text/calendar"

     *

     * @var string[]

     */

    protected static $IcalMethods = [

        self::ICAL_METHOD_REQUEST,

        self::ICAL_METHOD_PUBLISH,

        self::ICAL_METHOD_REPLY,

        self::ICAL_METHOD_ADD,

        self::ICAL_METHOD_CANCEL,

        self::ICAL_METHOD_REFRESH,

        self::ICAL_METHOD_COUNTER,

        self::ICAL_METHOD_DECLINECOUNTER,

    ];

    /**

     * The complete compiled MIME message body.

     *

     * @var string

     */

    protected $MIMEBody = '';

    /**

     * The complete compiled MIME message headers.

     *

     * @var string

     */

    protected $MIMEHeader = '';

    /**

     * Extra headers that createHeader() doesn't fold in.

     *

     * @var string

     */

    protected $mailHeader = '';

    /**

     * Word-wrap the message body to this number of chars.

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

     *

     * @see static::STD_LINE_LENGTH

     *

     * @var int

     */

    public $WordWrap = 0;

    /**

     * Which method to use to send mail.

     * Options: "mail", "sendmail", or "smtp".

     *

     * @var string

     */

    public $Mailer = 'mail';

    /**

     * The path to the sendmail program.

     *

     * @var string

     */

    public $Sendmail = '/usr/sbin/sendmail';

    /**

     * Whether mail() uses a fully sendmail-compatible MTA.

     * One which supports sendmail's "-oi -f" options.

     *

     * @var bool

     */

    public $UseSendmailOptions = true;

    /**

     * The email address that a reading confirmation should be sent to, also known as read receipt.

     *

     * @var string

     */

    public $ConfirmReadingTo = '';

    /**

     * The hostname to use in the Message-ID header and as default HELO string.

     * If empty, PHPMailer attempts to find one with, in order,

     * $_SERVER['SERVER_NAME'], gethostname(), php_uname('n'), or the value

     * 'localhost.localdomain'.

     *

     * @see PHPMailer::$Helo

     *

     * @var string

     */

    public $Hostname = '';

    /**

     * An ID to be used in the Message-ID header.

     * If empty, a unique id will be generated.

     * You can set your own, but it must be in the format "<id@domain>",

     * as defined in RFC5322 section 3.6.4 or it will be ignored.

     *

     * @see https://www.rfc-editor.org/rfc/rfc5322#section-3.6.4

     *

     * @var string

     */

    public $MessageID = '';

    /**

     * The message Date to be used in the Date header.

     * If empty, the current date will be added.

     *

     * @var string

     */

    public $MessageDate = '';

    /**

     * SMTP hosts.

     * Either a single hostname or multiple semicolon-delimited hostnames.

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

     *

     * @var string

     */

    public $Host = 'localhost';

    /**

     * The default SMTP server port.

     *

     * @var int

     */

    public $Port = 25;

    /**

     * The SMTP HELO/EHLO name used for the SMTP connection.

     * Default is $Hostname. If $Hostname is empty, PHPMailer attempts to find

     * one with the same method described above for $Hostname.

     *

     * @see PHPMailer::$Hostname

     *

     * @var string

     */

    public $Helo = '';

    /**

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

     * Options: '', static::ENCRYPTION_STARTTLS, or static::ENCRYPTION_SMTPS.

     *

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

     *

     * @var bool

     */

    public $SMTPAutoTLS = true;

    /**

     * Whether to use SMTP authentication.

     * Uses the Username and Password properties.

     *

     * @see PHPMailer::$Username

     * @see PHPMailer::$Password

     *

     * @var bool

     */

    public $SMTPAuth = false;

    /**

     * Options array passed to stream_context_create when connecting via SMTP.

     *

     * @var array

     */

    public $SMTPOptions = [];

    /**

     * SMTP username.

     *

     * @var string

     */

    public $Username = '';

    /**

     * SMTP password.

     *

     * @var string

     */

    public $Password = '';

    /**

     * SMTP authentication type. Options are CRAM-MD5, LOGIN, PLAIN, XOAUTH2.

     * If not specified, the first one from that list that the server supports will be selected.

     *

     * @var string

     */

    public $AuthType = '';

    /**

     * SMTP SMTPXClient command attributes

     *

     * @var array

     */

    protected $SMTPXClient = [];

    /**

     * An implementation of the PHPMailer OAuthTokenProvider interface.

     *

     * @var OAuthTokenProvider

     */

    protected $oauth;

    /**

     * The SMTP server timeout in seconds.

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

     *

     * @var int

     */

    public $Timeout = 300;

    /**

     * Comma separated list of DSN notifications

     * 'NEVER' under no circumstances a DSN must be returned to the sender.

     *         If you use NEVER all other notifications will be ignored.

     * 'SUCCESS' will notify you when your mail has arrived at its destination.

     * 'FAILURE' will arrive if an error occurred during delivery.

     * 'DELAY'   will notify you if there is an unusual delay in delivery, but the actual

     *           delivery's outcome (success or failure) is not yet decided.

     *

     * @see https://www.rfc-editor.org/rfc/rfc3461.html#section-4.1 for more information about NOTIFY

     */

    public $dsn = '';

    /**

     * SMTP class debug output mode.

     * Debug output level.

     * Options:

     * @see SMTP::DEBUG_OFF: No output

     * @see SMTP::DEBUG_CLIENT: Client messages

     * @see SMTP::DEBUG_SERVER: Client and server messages

     * @see SMTP::DEBUG_CONNECTION: As SERVER plus connection status

     * @see SMTP::DEBUG_LOWLEVEL: Noisy, low-level data output, rarely needed

     *

     * @see SMTP::$do_debug

     *

     * @var int

     */

    public $SMTPDebug = 0;

    /**

     * 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

     * By default PHPMailer will use `echo` if run from a `cli` or `cli-server` SAPI, `html` otherwise.

     * Alternatively, you can provide a callable expecting two params: a message string and the debug level:

     *

     * ```php

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

     * ```

     *

     * Alternatively, you can pass in an instance of a PSR-3 compatible logger, though only `debug`

     * level output is used:

     *

     * ```php

     * $mail->Debugoutput = new myPsr3Logger;

     * ```

     *

     * @see SMTP::$Debugoutput

     *

     * @var string|callable|\Psr\Log\LoggerInterface

     */

    public $Debugoutput = 'echo';

    /**

     * Whether to keep the SMTP connection open after each message.

     * If this is set to true then the connection will remain open after a send,

     * and closing the connection will require an explicit call to smtpClose().

     * It's a good idea to use this if you are sending multiple messages as it reduces overhead.

     * See the mailing list example for how to use it.

     *

     * @var bool

     */

    public $SMTPKeepAlive = false;

    /**

     * Whether to split multiple to addresses into multiple messages

     * or send them all in one message.

     * Only supported in `mail` and `sendmail` transports, not in SMTP.

     *

     * @var bool

     *

     * @deprecated 6.0.0 PHPMailer isn't a mailing list manager!

     */

    public $SingleTo = false;

    /**

     * Storage for addresses when SingleTo is enabled.

     *

     * @var array

     */

    protected $SingleToArray = [];

    /**

     * Whether to generate VERP addresses on send.

     * Only applicable when sending via SMTP.

     *

     * @see https://en.wikipedia.org/wiki/Variable_envelope_return_path

     * @see https://www.postfix.org/VERP_README.html Postfix VERP info

     *

     * @var bool

     */

    public $do_verp = false;

    /**

     * Whether to allow sending messages with an empty body.

     *

     * @var bool

     */

    public $AllowEmpty = false;

    /**

     * DKIM selector.

     *

     * @var string

     */

    public $DKIM_selector = '';

    /**

     * DKIM Identity.

     * Usually the email address used as the source of the email.

     *

     * @var string

     */

    public $DKIM_identity = '';

    /**

     * DKIM passphrase.

     * Used if your key is encrypted.

     *

     * @var string

     */

    public $DKIM_passphrase = '';

    /**

     * DKIM signing domain name.

     *

     * @example 'example.com'

     *

     * @var string

     */

    public $DKIM_domain = '';

    /**

     * DKIM Copy header field values for diagnostic use.

     *

     * @var bool

     */

    public $DKIM_copyHeaderFields = true;

    /**

     * DKIM Extra signing headers.

     *

     * @example ['List-Unsubscribe', 'List-Help']