\PHPMailerOAuth

PHPMailerOAuth - PHPMailer subclass adding OAuth support.

Summary

Methods
Properties
Constants
__construct()
__destruct()
isHTML()
isSMTP()
isMail()
isSendmail()
isQmail()
addAddress()
addCC()
addBCC()
addReplyTo()
parseAddresses()
setFrom()
getLastMessageID()
validateAddress()
idnSupported()
punyencodeAddress()
send()
preSend()
postSend()
getSMTPInstance()
smtpConnect()
smtpClose()
setLanguage()
getTranslations()
addrAppend()
addrFormat()
wrapText()
utf8CharBoundary()
setWordWrap()
createHeader()
getMailMIME()
getSentMIMEMessage()
createBody()
headerLine()
textLine()
addAttachment()
getAttachments()
encodeString()
encodeHeader()
hasMultiBytes()
has8bitChars()
base64EncodeWrapMB()
encodeQP()
encodeQPphp()
encodeQ()
addStringAttachment()
addEmbeddedImage()
addStringEmbeddedImage()
inlineImageExists()
attachmentExists()
alternativeExists()
clearQueuedAddresses()
clearAddresses()
clearCCs()
clearBCCs()
clearReplyTos()
clearAllRecipients()
clearAttachments()
clearCustomHeaders()
rfcDate()
isError()
fixEOL()
addCustomHeader()
getCustomHeaders()
msgHTML()
html2text()
_mime_types()
filenameToType()
mb_pathinfo()
set()
secureHeader()
normalizeBreaks()
sign()
DKIM_QP()
DKIM_Sign()
DKIM_HeaderC()
DKIM_BodyC()
DKIM_Add()
hasLineLongerThanMax()
getToAddresses()
getCcAddresses()
getBccAddresses()
getReplyToAddresses()
getAllRecipientAddresses()
getOAUTHInstance()
$Version
$Priority
$CharSet
$ContentType
$Encoding
$ErrorInfo
$From
$FromName
$Sender
$ReturnPath
$Subject
$Body
$AltBody
$Ical
$WordWrap
$Mailer
$Sendmail
$UseSendmailOptions
$PluginDir
$ConfirmReadingTo
$Hostname
$MessageID
$MessageDate
$Host
$Port
$Helo
$SMTPSecure
$SMTPAutoTLS
$SMTPAuth
$SMTPOptions
$Username
$Password
$AuthType
$Realm
$Workstation
$Timeout
$SMTPDebug
$Debugoutput
$SMTPKeepAlive
$SingleTo
$SingleToArray
$do_verp
$AllowEmpty
$LE
$DKIM_selector
$DKIM_identity
$DKIM_passphrase
$DKIM_domain
$DKIM_private
$DKIM_private_string
$action_function
$XMailer
$validator
$oauthUserEmail
$oauthRefreshToken
$oauthClientId
$oauthClientSecret
STOP_MESSAGE
STOP_CONTINUE
STOP_CRITICAL
CRLF
MAX_LINE_LENGTH
edebug()
addOrEnqueueAnAddress()
addAnAddress()
sendmailSend()
isShellSafe()
mailSend()
smtpSend()
generateId()
getBoundary()
endBoundary()
setMessageType()
attachAll()
encodeFile()
setError()
serverHostname()
lang()
doCallback()
$MIMEBody
$MIMEHeader
$mailHeader
$smtp
$to
$cc
$bcc
$ReplyTo
$all_recipients
$RecipientsQueue
$ReplyToQueue
$attachment
$CustomHeader
$lastMessageID
$message_type
$boundary
$language
$error_count
$sign_cert_file
$sign_key_file
$sign_extracerts_file
$sign_key_pass
$exceptions
$uniqueid
$oauth
N/A
mailPassthru()
No private properties found
N/A

Constants

STOP_MESSAGE

STOP_MESSAGE = 0

Error severity: message only, continue processing.

STOP_CONTINUE

STOP_CONTINUE = 1

Error severity: message, likely ok to continue processing.

STOP_CRITICAL

STOP_CRITICAL = 2

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

CRLF

CRLF = "\r\n"

SMTP RFC standard line ending.

MAX_LINE_LENGTH

MAX_LINE_LENGTH = 998 : integer

The maximum line length allowed by RFC 2822 section 2.1.1

Properties

$Version

$Version : string

The PHPMailer Version number.

Type

string

$Priority

$Priority : integer

Email priority.

Options: null (default), 1 = High, 3 = Normal, 5 = low. When null, the header is not set at all.

Type

integer

$CharSet

$CharSet : string

The character set of the message.

Type

string

$ContentType

$ContentType : string

The MIME Content-type of the message.

Type

string

$Encoding

$Encoding : string

The message encoding.

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

Type

string

$ErrorInfo

$ErrorInfo : string

Holds the most recent mailer error message.

Type

string

$From

$From : string

The From email address for the message.

Type

string

$FromName

$FromName : string

The From name of the message.

Type

string

$Sender

$Sender : string

The Sender email (Return-Path) of the message.

If not empty, will be sent via -f to sendmail or as 'MAIL FROM' in smtp mode.

Type

string

$ReturnPath

$ReturnPath : string

The Return-Path of the message.

If empty, it will be set to either From or Sender.

Type

string

$Subject

$Subject : string

The Subject of the message.

Type

string

$Body

$Body : string

An HTML or plain text message body.

If HTML then call isHTML(true).

Type

string

$AltBody

$AltBody : string

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.

Type

string

$Ical

$Ical : string

An iCal message part body.

Only supported in simple alt or alt_inline message types To generate iCal events, use the bundled extras/EasyPeasyICS.php class or iCalcreator

Type

string

$WordWrap

$WordWrap : integer

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.

Type

integer

$Mailer

$Mailer : string

Which method to use to send mail.

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

Type

string

$Sendmail

$Sendmail : string

The path to the sendmail program.

Type

string

$UseSendmailOptions

$UseSendmailOptions : boolean

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

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

Type

boolean

$PluginDir

$PluginDir : string

Path to PHPMailer plugins.

Useful if the SMTP class is not in the PHP include path.

Type

string

$ConfirmReadingTo

$ConfirmReadingTo : string

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

Type

string

$Hostname

$Hostname : string

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

Type

string

$MessageID

$MessageID : string

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.

Type

string

$MessageDate

$MessageDate : string

The message Date to be used in the Date header.

If empty, the current date will be added.

Type

string

$Host

$Host : string

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.

Type

string

$Port

$Port : integer

The default SMTP server port.

Type

integer

$Helo

$Helo : string

The SMTP HELO of the message.

Default is $Hostname. If $Hostname is empty, PHPMailer attempts to find one with the same method described above for $Hostname.

Type

string

$SMTPSecure

$SMTPSecure : string

What kind of encryption to use on the SMTP connection.

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

Type

string

$SMTPAutoTLS

$SMTPAutoTLS : boolean

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

$SMTPAuth

$SMTPAuth : boolean

Whether to use SMTP authentication.

Uses the Username and Password properties.

Type

boolean

$SMTPOptions

$SMTPOptions : array

Options array passed to stream_context_create when connecting via SMTP.

Type

array

$Username

$Username : string

SMTP username.

Type

string

$Password

$Password : string

SMTP password.

Type

string

$AuthType

$AuthType : string

SMTP auth type.

Options are CRAM-MD5, LOGIN, PLAIN, NTLM, XOAUTH2, attempted in that order if not specified

Type

string

$Realm

$Realm : string

SMTP realm.

Used for NTLM auth

Type

string

$Workstation

$Workstation : string

SMTP workstation.

Used for NTLM auth

Type

string

$Timeout

$Timeout : integer

The SMTP server timeout in seconds.

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

Type

integer

$SMTPDebug

$SMTPDebug : integer

SMTP class debug output mode.

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

$Debugoutput

$Debugoutput : string|callable

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: $mail->Debugoutput = function($str, $level) {echo "debug level $level; message: $str";};

Type

string|callable

$SMTPKeepAlive

$SMTPKeepAlive : boolean

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

boolean

$SingleTo

$SingleTo : boolean

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.

Type

boolean

$SingleToArray

$SingleToArray : array

Storage for addresses when SingleTo is enabled.

Type

array

$do_verp

$do_verp : boolean

Whether to generate VERP addresses on send.

Only applicable when sending via SMTP.

Type

boolean

$AllowEmpty

$AllowEmpty : boolean

Whether to allow sending messages with an empty body.

Type

boolean

$LE

$LE : string

The default line ending.

Type

string

$DKIM_selector

$DKIM_selector : string

DKIM selector.

Type

string

$DKIM_identity

$DKIM_identity : string

DKIM Identity.

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

Type

string

$DKIM_passphrase

$DKIM_passphrase : string

DKIM passphrase.

Used if your key is encrypted.

Type

string

$DKIM_domain

$DKIM_domain : string

DKIM signing domain name.

Type

string

$DKIM_private

$DKIM_private : string

DKIM private key file path.

Type

string

$DKIM_private_string

$DKIM_private_string : string

DKIM private key string.

If set, takes precedence over $DKIM_private.

Type

string

$action_function

$action_function : string

Callback Action function name.

The function that handles the result of the send email action. It is called out by send() for each email sent.

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

Parameters: boolean $result result of the send action array $to email addresses of the recipients array $cc cc email addresses array $bcc bcc email addresses string $subject the subject string $body the email body string $from email address of sender

Type

string

$XMailer

$XMailer : string

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

$validator

$validator : string|callable

Which validator to use by default when validating email addresses.

May be a callable to inject your own validator, but there are several built-in validators.

Type

string|callable

$oauthUserEmail

$oauthUserEmail : string

The OAuth user's email address

Type

string

$oauthRefreshToken

$oauthRefreshToken : string

The OAuth refresh token

Type

string

$oauthClientId

$oauthClientId : string

The OAuth client ID

Type

string

$oauthClientSecret

$oauthClientSecret : string

The OAuth client secret

Type

string

$MIMEBody

$MIMEBody : string

The complete compiled MIME message body.

Type

string

$MIMEHeader

$MIMEHeader : string

The complete compiled MIME message headers.

Type

string

$mailHeader

$mailHeader : string

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

Type

string

$smtp

$smtp : \SMTP

An instance of the SMTP sender class.

Type

\SMTP

$to

$to : array

The array of 'to' names and addresses.

Type

array

$cc

$cc : array

The array of 'cc' names and addresses.

Type

array

$bcc

$bcc : array

The array of 'bcc' names and addresses.

Type

array

$ReplyTo

$ReplyTo : array

The array of reply-to names and addresses.

Type

array

$all_recipients

$all_recipients : array

An array of all kinds of addresses.

Includes all of $to, $cc, $bcc

Type

array

$RecipientsQueue

$RecipientsQueue : array

An array of names and addresses queued for validation.

In send(), valid and non duplicate entries are moved to $all_recipients and one of $to, $cc, or $bcc. This array is used only for addresses with IDN.

Type

array

$ReplyToQueue

$ReplyToQueue : array

An array of reply-to names and addresses queued for validation.

In send(), valid and non duplicate entries are moved to $ReplyTo. This array is used only for addresses with IDN.

Type

array

$attachment

$attachment : array

The array of attachments.

Type

array

$CustomHeader

$CustomHeader : array

The array of custom headers.

Type

array

$lastMessageID

$lastMessageID : string

The most recent Message-ID (including angular brackets).

Type

string

$message_type

$message_type : string

The message's MIME type.

Type

string

$boundary

$boundary : array

The array of MIME boundary strings.

Type

array

$language

$language : array

The array of available languages.

Type

array

$error_count

$error_count : integer

The number of errors encountered.

Type

integer

$sign_cert_file

$sign_cert_file : string

The S/MIME certificate file path.

Type

string

$sign_key_file

$sign_key_file : string

The S/MIME key file path.

Type

string

$sign_extracerts_file

$sign_extracerts_file : string

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

Type

string

$sign_key_pass

$sign_key_pass : string

The S/MIME password for the key.

Used only if the key is encrypted.

Type

string

$exceptions

$exceptions : boolean

Whether to throw exceptions for errors.

Type

boolean

$uniqueid

$uniqueid : string

Unique ID used for message ID and boundaries.

Type

string

$oauth

$oauth : \PHPMailerOAuthGoogle

An instance of the PHPMailerOAuthGoogle class.

Type

\PHPMailerOAuthGoogle

Methods

__construct()

__construct(boolean  $exceptions = null) 

Constructor.

Parameters

boolean $exceptions

Should we throw external exceptions?

__destruct()

__destruct() 

Destructor.

isHTML()

isHTML(boolean  $isHtml = true) : void

Sets message type to HTML or plain.

Parameters

boolean $isHtml

True for HTML mode.

isSMTP()

isSMTP() : void

Send messages using SMTP.

isMail()

isMail() : void

Send messages using PHP's mail() function.

isSendmail()

isSendmail() : void

Send messages using $Sendmail.

isQmail()

isQmail() : void

Send messages using qmail.

addAddress()

addAddress(string  $address, string  $name = '') : boolean

Add a "To" address.

Parameters

string $address

The email address to send to

string $name

Returns

boolean —

true on success, false if address already used or invalid in some way

addCC()

addCC(string  $address, string  $name = '') : boolean

Add a "CC" address.

Parameters

string $address

The email address to send to

string $name

Returns

boolean —

true on success, false if address already used or invalid in some way

addBCC()

addBCC(string  $address, string  $name = '') : boolean

Add a "BCC" address.

Parameters

string $address

The email address to send to

string $name

Returns

boolean —

true on success, false if address already used or invalid in some way

addReplyTo()

addReplyTo(string  $address, string  $name = '') : boolean

Add a "Reply-To" address.

Parameters

string $address

The email address to reply to

string $name

Returns

boolean —

true on success, false if address already used or invalid in some way

parseAddresses()

parseAddresses(string  $addrstr, boolean  $useimap = true) : array

Parse and validate a string containing one or more RFC822-style comma-separated email addresses of the form "display name <address>" into an array of name/address pairs.

Uses the imap_rfc822_parse_adrlist function if the IMAP extension is available. Note that quotes in the name part are removed.

Parameters

string $addrstr

The address list string

boolean $useimap

Whether to use the IMAP extension to parse the list

Returns

array

setFrom()

setFrom(string  $address, string  $name = '', boolean  $auto = true) : boolean

Set the From and FromName properties.

Parameters

string $address
string $name
boolean $auto

Whether to also set the Sender address, defaults to true

Throws

\phpmailerException

Returns

boolean

getLastMessageID()

getLastMessageID() : string

Return the Message-ID header of the last email.

Technically this is the value from the last time the headers were created, but it's also the message ID of the last sent message except in pathological cases.

Returns

string

validateAddress()

validateAddress(string  $address, string|callable  $patternselect = null) : boolean

Check that a string looks like an email address.

Parameters

string $address

The email address to check

string|callable $patternselect

A selector for the validation pattern to use :

  • auto Pick best pattern 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;
  • 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. Alternatively you may pass in a callable to inject your own validator, for example: PHPMailer::validateAddress('user@example.com', function($address) { return (strpos($address, '@') !== false); }); You can also set the PHPMailer::$validator static to a callable, allowing built-in methods to use your validator.

Returns

boolean

idnSupported()

idnSupported() : boolean

Tells whether IDNs (Internationalized Domain Names) are supported or not. This requires the "intl" and "mbstring" PHP extensions.

Returns

boolean —

"true" if required functions for IDN support are present

punyencodeAddress()

punyencodeAddress(string  $address) : string

Converts IDN in given email address to its ASCII form, also known as punycode, if possible.

Important: Address must be passed in same encoding as currently set in PHPMailer::$CharSet. This function silently returns unmodified address if:

  • No conversion is necessary (i.e. domain name is not an IDN, or is already in ASCII form)
  • Conversion to punycode is impossible (e.g. required PHP functions are not available) or fails for any reason (e.g. domain has characters not allowed in an IDN)

Parameters

string $address

The email address to convert

Returns

string —

The encoded address in ASCII form

send()

send() : boolean

Create a message and send it.

Uses the sending method specified by $Mailer.

Throws

\phpmailerException

Returns

boolean —

false on error - See the ErrorInfo property for details of the error.

preSend()

preSend() : boolean

Prepare a message for sending.

Throws

\phpmailerException

Returns

boolean

postSend()

postSend() : boolean

Actually send a message.

Send the email via the selected mechanism

Throws

\phpmailerException

Returns

boolean

getSMTPInstance()

getSMTPInstance() : \SMTP

Get an instance to use for SMTP operations.

Override this function to load your own SMTP implementation

Returns

\SMTP

smtpConnect()

smtpConnect(array  $options = array()) : boolean

Initiate a connection to an SMTP server.

Overrides the original smtpConnect method to add support for OAuth.

Parameters

array $options

An array of options compatible with stream_context_create()

Throws

\phpmailerException

Returns

boolean

smtpClose()

smtpClose() : void

Close the active SMTP session if one exists.

setLanguage()

setLanguage(string  $langcode = 'en', string  $lang_path = '') : boolean

Set the language for error messages.

Returns false if it cannot load the language file. The default language is English.

Parameters

string $langcode

ISO 639-1 2-character language code (e.g. French is "fr")

string $lang_path

Path to the language file directory, with trailing separator (slash)

Returns

boolean

getTranslations()

getTranslations() : array

Get the array of strings for the current language.

Returns

array

addrAppend()

addrAppend(string  $type, array  $addr) : string

Create recipient headers.

Parameters

string $type
array $addr

An array of recipient, where each recipient is a 2-element indexed array with element 0 containing an address and element 1 containing a name, like: array(array('joe@example.com', 'Joe User'), array('zoe@example.com', 'Zoe User'))

Returns

string

addrFormat()

addrFormat(array  $addr) : string

Format an address for use in a message header.

Parameters

array $addr

A 2-element indexed array, element 0 containing an address, element 1 containing a name like array('joe@example.com', 'Joe User')

Returns

string

wrapText()

wrapText(string  $message, integer  $length, boolean  $qp_mode = false) : string

Word-wrap message.

For use with mailers that do not automatically perform wrapping and for quoted-printable encoded messages. Original written by philippe.

Parameters

string $message

The message to wrap

integer $length

The line length to wrap to

boolean $qp_mode

Whether to run in Quoted-Printable mode

Returns

string

utf8CharBoundary()

utf8CharBoundary(string  $encodedText, integer  $maxLength) : integer

Find the last character boundary prior to $maxLength in a utf-8 quoted-printable encoded string.

Original written by Colin Brown.

Parameters

string $encodedText

utf-8 QP text

integer $maxLength

Find the last character boundary prior to this length

Returns

integer

setWordWrap()

setWordWrap() : void

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.

createHeader()

createHeader() : string

Assemble message headers.

Returns

string —

The assembled headers

getMailMIME()

getMailMIME() : string

Get the message MIME type headers.

Returns

string

getSentMIMEMessage()

getSentMIMEMessage() : string

Returns the whole MIME message.

Includes complete headers and body. Only valid post preSend().

Returns

string

createBody()

createBody() : string

Assemble the message body.

Returns an empty string on failure.

Throws

\phpmailerException

Returns

string —

The assembled message body

headerLine()

headerLine(string  $name, string  $value) : string

Format a header line.

Parameters

string $name
string $value

Returns

string

textLine()

textLine(string  $value) : string

Return a formatted mail line.

Parameters

string $value

Returns

string

addAttachment()

addAttachment(string  $path, string  $name = '', string  $encoding = 'base64', string  $type = '', string  $disposition = 'attachment') : boolean

Add an attachment from a path on the filesystem.

Never use a user-supplied path to a file! Returns false if the file could not be found or read.

Parameters

string $path

Path to the attachment.

string $name

Overrides the attachment name.

string $encoding

File encoding (see $Encoding).

string $type

File extension (MIME) type.

string $disposition

Disposition to use

Throws

\phpmailerException

Returns

boolean

getAttachments()

getAttachments() : array

Return the array of attachments.

Returns

array

encodeString()

encodeString(string  $str, string  $encoding = 'base64') : string

Encode a string in requested format.

Returns an empty string on failure.

Parameters

string $str

The text to encode

string $encoding

The encoding to use; one of 'base64', '7bit', '8bit', 'binary', 'quoted-printable'

Returns

string

encodeHeader()

encodeHeader(string  $str, string  $position = 'text') : string

Encode a header string optimally.

Picks shortest of Q, B, quoted-printable or none.

Parameters

string $str
string $position

Returns

string

hasMultiBytes()

hasMultiBytes(string  $str) : boolean

Check if a string contains multi-byte characters.

Parameters

string $str

multi-byte text to wrap encode

Returns

boolean

has8bitChars()

has8bitChars(string  $text) : boolean

Does a string contain any 8-bit chars (in any charset)?

Parameters

string $text

Returns

boolean

base64EncodeWrapMB()

base64EncodeWrapMB(string  $str, string  $linebreak = null) : string

Encode and wrap long multibyte strings for mail headers without breaking lines within a character.

Adapted from a function by paravoid

Parameters

string $str

multi-byte text to wrap encode

string $linebreak

string to use as linefeed/end-of-line

Returns

string

encodeQP()

encodeQP(string  $string, integer  $line_max = 76) : string

Encode a string in quoted-printable format.

According to RFC2045 section 6.7.

Parameters

string $string

The text to encode

integer $line_max

Number of chars allowed on a line before wrapping

Returns

string

encodeQPphp()

encodeQPphp(string  $string, integer  $line_max = 76, boolean  $space_conv = false) : string

Backward compatibility wrapper for an old QP encoding function that was removed.

Parameters

string $string
integer $line_max
boolean $space_conv

Returns

string

encodeQ()

encodeQ(string  $str, string  $position = 'text') : string

Encode a string using Q encoding.

Parameters

string $str

the text to encode

string $position

Where the text is going to be used, see the RFC for what that means

Returns

string

addStringAttachment()

addStringAttachment(string  $string, string  $filename, string  $encoding = 'base64', string  $type = '', string  $disposition = 'attachment') : void

Add a string or binary attachment (non-filesystem).

This method can be used to attach ascii or binary data, such as a BLOB record from a database.

Parameters

string $string

String attachment data.

string $filename

Name of the attachment.

string $encoding

File encoding (see $Encoding).

string $type

File extension (MIME) type.

string $disposition

Disposition to use

addEmbeddedImage()

addEmbeddedImage(string  $path, string  $cid, string  $name = '', string  $encoding = 'base64', string  $type = '', string  $disposition = 'inline') : boolean

Add an embedded (inline) attachment from a file.

This can include images, sounds, and just about any other document type. 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. Never use a user-supplied path to a file!

Parameters

string $path

Path to the attachment.

string $cid

Content ID of the attachment; Use this to reference the content when using an embedded image in HTML.

string $name

Overrides the attachment name.

string $encoding

File encoding (see $Encoding).

string $type

File MIME type.

string $disposition

Disposition to use

Returns

boolean —

True on successfully adding an attachment

addStringEmbeddedImage()

addStringEmbeddedImage(string  $string, string  $cid, string  $name = '', string  $encoding = 'base64', string  $type = '', string  $disposition = 'inline') : boolean

Add an embedded stringified attachment.

This can include images, sounds, and just about any other document type. Be sure to set the $type to an image type for images: JPEG images use 'image/jpeg', GIF uses 'image/gif', PNG uses 'image/png'.

Parameters

string $string

The attachment binary data.

string $cid

Content ID of the attachment; Use this to reference the content when using an embedded image in HTML.

string $name
string $encoding

File encoding (see $Encoding).

string $type

MIME type.

string $disposition

Disposition to use

Returns

boolean —

True on successfully adding an attachment

inlineImageExists()

inlineImageExists() : boolean

Check if an inline attachment is present.

Returns

boolean

attachmentExists()

attachmentExists() : boolean

Check if an attachment (non-inline) is present.

Returns

boolean

alternativeExists()

alternativeExists() : boolean

Check if this message has an alternative body set.

Returns

boolean

clearQueuedAddresses()

clearQueuedAddresses(string  $kind) : void

Clear queued addresses of given kind.

Parameters

string $kind

'to', 'cc', or 'bcc'

clearAddresses()

clearAddresses() : void

Clear all To recipients.

clearCCs()

clearCCs() : void

Clear all CC recipients.

clearBCCs()

clearBCCs() : void

Clear all BCC recipients.

clearReplyTos()

clearReplyTos() : void

Clear all ReplyTo recipients.

clearAllRecipients()

clearAllRecipients() : void

Clear all recipient types.

clearAttachments()

clearAttachments() : void

Clear all filesystem, string, and binary attachments.

clearCustomHeaders()

clearCustomHeaders() : void

Clear all custom headers.

rfcDate()

rfcDate() : string

Return an RFC 822 formatted date.

Returns

string

isError()

isError() : boolean

Check if an error occurred.

Returns

boolean —

True if an error did occur.

fixEOL()

fixEOL(string  $str) : string

Ensure consistent line endings in a string.

Changes every end of line from CRLF, CR or LF to $this->LE.

Parameters

string $str

String to fixEOL

Returns

string

addCustomHeader()

addCustomHeader(string  $name, string  $value = null) : void

Add a custom header.

$name value can be overloaded to contain both header name and value (name:value)

Parameters

string $name

Custom header name

string $value

Header value

getCustomHeaders()

getCustomHeaders() : array

Returns all custom headers.

Returns

array

msgHTML()

msgHTML(string  $message, string  $basedir = '', boolean|callable  $advanced = false) : string

Create a message body from an HTML string.

Automatically inlines images and creates a plain-text version by converting the HTML, overwriting any existing values in Body and AltBody. Do not source $message content from user input! $basedir is prepended when handling relative URLs, e.g. and must not be empty will look for an image file in $basedir/images/a.png and convert it to inline. If you don't provide a $basedir, relative paths will be left untouched (and thus probably break in email) If you don't want to apply these transformations to your HTML, just set Body and AltBody directly.

Parameters

string $message

HTML message string

string $basedir

Absolute path to a base directory to prepend to relative paths to images

boolean|callable $advanced

Whether to use the internal HTML to text converter or your own custom converter @see PHPMailer::html2text()

Returns

string —

$message The transformed message Body

html2text()

html2text(string  $html, boolean|callable  $advanced = false) : string

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

Parameters

string $html

The HTML text to convert

boolean|callable $advanced

Any boolean value to use the internal converter, or provide your own callable for custom conversion.

Returns

string

_mime_types()

_mime_types(string  $ext = '') : string

Get the MIME type for a file extension.

Parameters

string $ext

File extension

Returns

string —

MIME type of file.

filenameToType()

filenameToType(string  $filename) : string

Map a file name to a MIME type.

Defaults to 'application/octet-stream', i.e.. arbitrary binary data.

Parameters

string $filename

A file name or full path, does not need to exist as a file

Returns

string

mb_pathinfo()

mb_pathinfo(string  $path, integer|string  $options = null) : string|array

Multi-byte-safe pathinfo replacement.

Drop-in replacement for pathinfo(), but multibyte-safe, cross-platform-safe, old-version-safe. Works similarly to the one in PHP >= 5.2.0

Parameters

string $path

A filename or path, does not need to exist as a file

integer|string $options

Either a PATHINFO_* constant, or a string name to return only the specified piece, allows 'filename' to work on PHP < 5.2

Returns

string|array

set()

set(string  $name, mixed  $value = '') : boolean

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: $mail->set('SMTPSecure', 'tls'); is the same as: $mail->SMTPSecure = 'tls';

Parameters

string $name

The property name to set

mixed $value

The value to set the property to

Returns

boolean

secureHeader()

secureHeader(string  $str) : string

Strip newlines to prevent header injection.

Parameters

string $str

Returns

string

normalizeBreaks()

normalizeBreaks(string  $text, string  $breaktype = "\r\n") : string

Normalize line breaks in a string.

Converts UNIX LF, Mac CR and Windows CRLF line breaks into a single line break format. Defaults to CRLF (for message bodies) and preserves consecutive breaks.

Parameters

string $text
string $breaktype

What kind of line break to use, defaults to CRLF

Returns

string

sign()

sign(string  $cert_filename, string  $key_filename, string  $key_pass, string  $extracerts_filename = '') 

Set the public and private key files and password for S/MIME signing.

Parameters

string $cert_filename
string $key_filename
string $key_pass

Password for private key

string $extracerts_filename

Optional path to chain certificate

DKIM_QP()

DKIM_QP(string  $txt) : string

Quoted-Printable-encode a DKIM header.

Parameters

string $txt

Returns

string

DKIM_Sign()

DKIM_Sign(string  $signHeader) : string

Generate a DKIM signature.

Parameters

string $signHeader

Throws

\phpmailerException

Returns

string —

The DKIM signature value

DKIM_HeaderC()

DKIM_HeaderC(string  $signHeader) : string

Generate a DKIM canonicalization header.

Parameters

string $signHeader

Header

Returns

string

DKIM_BodyC()

DKIM_BodyC(string  $body) : string

Generate a DKIM canonicalization body.

Parameters

string $body

Message Body

Returns

string

DKIM_Add()

DKIM_Add(string  $headers_line, string  $subject, string  $body) : string

Create the DKIM header and body in a new message header.

Parameters

string $headers_line

Header lines

string $subject

Subject

string $body

Body

Returns

string

hasLineLongerThanMax()

hasLineLongerThanMax(string  $str) : boolean

Detect if a string contains a line longer than the maximum line length allowed.

Parameters

string $str

Returns

boolean

getToAddresses()

getToAddresses() : array

Allows for public read access to 'to' property.

Returns

array

getCcAddresses()

getCcAddresses() : array

Allows for public read access to 'cc' property.

Returns

array

getBccAddresses()

getBccAddresses() : array

Allows for public read access to 'bcc' property.

Returns

array

getReplyToAddresses()

getReplyToAddresses() : array

Allows for public read access to 'ReplyTo' property.

Returns

array

getAllRecipientAddresses()

getAllRecipientAddresses() : array

Allows for public read access to 'all_recipients' property.

Returns

array

getOAUTHInstance()

getOAUTHInstance() : \PHPMailerOAuthGoogle

Get a PHPMailerOAuthGoogle instance to use.

Returns

\PHPMailerOAuthGoogle

edebug()

edebug(string  $str) 

Output debugging info via user-defined method.

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

Parameters

string $str

addOrEnqueueAnAddress()

addOrEnqueueAnAddress(string  $kind, string  $address, string  $name) : boolean

Add an address to one of the recipient arrays or to the ReplyTo array. Because PHPMailer can't validate addresses with an IDN without knowing the PHPMailer::$CharSet (that can still be modified after calling this function), addition of such addresses is delayed until send().

Addresses that have been added already return false, but do not throw exceptions.

Parameters

string $kind

One of 'to', 'cc', 'bcc', or 'ReplyTo'

string $address

The email address to send, resp. to reply to

string $name

Throws

\phpmailerException

Returns

boolean —

true on success, false if address already used or invalid in some way

addAnAddress()

addAnAddress(string  $kind, string  $address, string  $name = '') : boolean

Add an address to one of the recipient arrays or to the ReplyTo array.

Addresses that have been added already return false, but do not throw exceptions.

Parameters

string $kind

One of 'to', 'cc', 'bcc', or 'ReplyTo'

string $address

The email address to send, resp. to reply to

string $name

Throws

\phpmailerException

Returns

boolean —

true on success, false if address already used or invalid in some way

sendmailSend()

sendmailSend(string  $header, string  $body) : boolean

Send mail using the $Sendmail program.

Parameters

string $header

The message headers

string $body

The message body

Throws

\phpmailerException

Returns

boolean

isShellSafe()

isShellSafe(string  $string) : boolean

Fix CVE-2016-10033 and CVE-2016-10045 by disallowing potentially unsafe shell characters.

Note that escapeshellarg and escapeshellcmd are inadequate for our purposes, especially on Windows.

Parameters

string $string

The string to be validated

Returns

boolean

mailSend()

mailSend(string  $header, string  $body) : boolean

Send mail using the PHP mail() function.

Parameters

string $header

The message headers

string $body

The message body

Throws

\phpmailerException

Returns

boolean

smtpSend()

smtpSend(string  $header, string  $body) : boolean

Send mail via SMTP.

Returns false if there is a bad MAIL FROM, RCPT, or DATA input. Uses the PHPMailerSMTP class by default.

Parameters

string $header

The message headers

string $body

The message body

Throws

\phpmailerException

Returns

boolean

generateId()

generateId() : string

Create unique ID

Returns

string

getBoundary()

getBoundary(string  $boundary, string  $charSet, string  $contentType, string  $encoding) : string

Return the start of a message boundary.

Parameters

string $boundary
string $charSet
string $contentType
string $encoding

Returns

string

endBoundary()

endBoundary(string  $boundary) : string

Return the end of a message boundary.

Parameters

string $boundary

Returns

string

setMessageType()

setMessageType() : void

Set the message type.

PHPMailer only supports some preset message types, not arbitrary MIME structures.

attachAll()

attachAll(string  $disposition_type, string  $boundary) : string

Attach all file, string, and binary attachments to the message.

Returns an empty string on failure.

Parameters

string $disposition_type
string $boundary

Returns

string

encodeFile()

encodeFile(string  $path, string  $encoding = 'base64') : string

Encode a file attachment in requested format.

Returns an empty string on failure.

Parameters

string $path

The full path to the file

string $encoding

The encoding to use; one of 'base64', '7bit', '8bit', 'binary', 'quoted-printable'

Throws

\phpmailerException

Returns

string

setError()

setError(string  $msg) : void

Add an error message to the error container.

Parameters

string $msg

serverHostname()

serverHostname() : string

Get the server hostname.

Returns 'localhost.localdomain' if unknown.

Returns

string

lang()

lang(string  $key) : string

Get an error message in the current language.

Parameters

string $key

Returns

string

doCallback()

doCallback(boolean  $isSent, array  $to, array  $cc, array  $bcc, string  $subject, string  $body, string  $from) 

Perform a callback.

Parameters

boolean $isSent
array $to
array $cc
array $bcc
string $subject
string $body
string $from

mailPassthru()

mailPassthru(string  $to, string  $subject, string  $body, string  $header, string  $params) : boolean

Call mail() in a safe_mode-aware fashion.

Also, unless sendmail_path points to sendmail (or something that claims to be sendmail), don't pass params (not a perfect fix, but it will do)

Parameters

string $to

To

string $subject

Subject

string $body

Message Body

string $header

Additional Header(s)

string $params

Params

Returns

boolean