Docs For Class PHPMailerLite

$action_function = ''

[line 225]

Callback Action function name

the function that handles the result of the send email action. Parameters: bool $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

Tags:

access:

public

Type:

string

[ Top ]

$AltBody = ''

[line 119]

Sets the text-only body of the message. This automatically sets the email to multipart/alternative. This body can be read by mail clients that do not have HTML email capability such as mutt. Clients that can read HTML will view the normal Body.

Tags:

access:

public

Type:

string

[ Top ]

$Body = ''

[line 110]

Sets the Body of the message. This can be either an HTML or text body.

If HTML then run IsHTML(true).

Tags:

access:

public

Type:

string

[ Top ]

$CharSet = 'iso-8859-1'

[line 59]

Sets the CharSet of the message.

Tags:

access:

public

Type:

string

[ Top ]

$ConfirmReadingTo = ''

[line 144]

Sets the email address that a reading confirmation will be sent.

Tags:

access:

public

Type:

string

[ Top ]

$ContentType = 'text/plain'

[line 65]

Sets the Content-type of the message.

Tags:

access:

public

Type:

string

[ Top ]

$DKIM_domain = ''

[line 198]

Used with DKIM DNS Resource Record

required, in format of base domain 'yourdomain.com'

Tags:

access:

public

Type:

string

[ Top ]

$DKIM_identity = ''

[line 191]

Used with DKIM DNS Resource Record

optional, in format of email address 'you@yourdomain.com'

Tags:

access:

public

Type:

string

[ Top ]

$DKIM_passphrase = ''

[line 205]

Used with DKIM Digital Signing process

optional

Tags:

access:

public

Type:

string

[ Top ]

$DKIM_private = ''

[line 212]

Used with DKIM DNS Resource Record

required, private key (read from /.htprivkey)

Tags:

access:

public

Type:

string

[ Top ]

$DKIM_selector = 'phpmailer'

[line 184]

Used with DKIM DNS Resource Record

Tags:

access:

public

Type:

string

[ Top ]

$Encoding = '8bit'

[line 72]

Sets the Encoding of the message. Options for this are "8bit", "7bit", "binary", "base64", and "quoted-printable".

Tags:

access:

public

Type:

string

[ Top ]

$ErrorInfo = ''

[line 78]

Holds the most recent mailer error message.

Tags:

access:

public

Type:

string

[ Top ]

$From = 'root@localhost'

[line 84]

Sets the From email address for the message.

Tags:

access:

public

Type:

string

[ Top ]

$FromName = 'Root User'

[line 90]

Sets the From name of the message.

Tags:

access:

public

Type:

string

[ Top ]

$Hostname = ''

[line 152]

Sets the hostname to use in Message-Id and Received headers and as default HELO string. If empty, the value returned by SERVER_NAME is used or 'localhost.localdomain'.

Tags:

access:

public

Type:

string

[ Top ]

$language = array()

[line 246]

Tags:

access:

protected

Type:

mixed

[ Top ]

$LE = "\n"

[line 178]

Provides the ability to change the line ending

Tags:

access:

public

Type:

string

[ Top ]

$Mailer = 'sendmail'

[line 132]

Method to send mail: ("mail", or "sendmail").

Tags:

access:

public

Type:

string

[ Top ]

$MessageID = ''

[line 159]

Sets the message ID to be used in the Message-Id header.

If empty, a unique id will be generated.

Tags:

access:

public

Type:

string

[ Top ]

$Priority = 3

[line 53]

Email priority (1 = High, 3 = Normal, 5 = low).

Tags:

access:

public

Type:

int

[ Top ]

$Sender = ''

[line 97]

Sets the Sender email (Return-Path) of the message. If not empty,

will be sent via -f to sendmail

Tags:

access:

public

Type:

string

[ Top ]

$Sendmail = '/usr/sbin/sendmail'

[line 138]

Sets the path of the sendmail program.

Tags:

access:

public

Type:

string

[ Top ]

$SingleTo = true

[line 166]

Provides the ability to have the TO field process individual

emails, instead of sending to entire TO addresses

Tags:

access:

public

Type:

bool

[ Top ]

$SingleToArray = array()

[line 172]

If SingleTo is true, this provides the array to hold the email addresses

Tags:

access:

public

Type:

bool

[ Top ]

$Subject = ''

[line 103]

Sets the Subject of the message.

Tags:

access:

public

Type:

string

[ Top ]

$Version = 'Lite 5.1'

[line 231]

Sets the PHPMailer Version number

Tags:

access:

public

Type:

string

[ Top ]

$WordWrap = 0

[line 126]

Sets word wrapping on the body of the message to a given number of characters.

Tags:

access:

public

Type:

int

[ Top ]

static method RFCDate [line 1679]

static string RFCDate(
)

Returns the proper RFC 822 formatted date.

Tags:

access:

public

[ Top ]

static method ValidateAddress [line 442]

static boolean ValidateAddress(
string
$address)

Check that a string looks roughly like an email address should

Static so it can be used without instantiation Tries to use PHP built-in validator in the filter extension (from PHP 5.2), falls back to a reasonably competent regex validator Conforms approximately to RFC2822

Tags:

link:	Original pattern found here
access:	public

Parameters:

string

$address

The email address to check

[ Top ]

static method _mime_types [line 1796]

static string _mime_types(
[string
$ext = ''])

Gets the MIME type of the embedded or inline image

Tags:

return:	MIME type of ext
access:	public

Parameters:

string

$ext

File extension

[ Top ]

constructor __construct [line 269]

PHPMailerLite __construct(
[boolean
$exceptions = false])

Constructor

Tags:

access:

public

Parameters:

boolean

$exceptions

Should we throw external exceptions?

[ Top ]

method AddAddress [line 326]

boolean AddAddress(
string
$address, [string
$name = ''])

Adds a "To" address.

Tags:

return:	true on success, false if address already used
access:	public

Parameters:

string	$address
string	$name

[ Top ]

method AddAttachment [line 1105]

bool AddAttachment(
string
$path, [string
$name = ''], [string
$encoding = 'base64'], [string
$type = 'application/octet-stream'])

Adds an attachment from a path on the filesystem.

Returns false if the file could not be found or accessed.

Tags:

access:

public

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.

[ Top ]

method AddBCC [line 348]

boolean AddBCC(
string
$address, [string
$name = ''])

Adds a "Bcc" address.

Note: this function works with the SMTP mailer on win32, not with the "mail" mailer.

Tags:

return:	true on success, false if address already used
access:	public

Parameters:

string	$address
string	$name

[ Top ]

method AddCC [line 337]

boolean AddCC(
string
$address, [string
$name = ''])

Adds a "Cc" address.

Note: this function works with the SMTP mailer on win32, not with the "mail" mailer.

Tags:

return:	true on success, false if address already used
access:	public

Parameters:

string	$address
string	$name

[ Top ]

method AddCustomHeader [line 1749]

void AddCustomHeader(

$custom_header)

Adds a custom header.

Tags:

access:

public

Parameters:

$custom_header

[ Top ]

method AddEmbeddedImage [line 1544]

bool AddEmbeddedImage(
string
$path, string
$cid, [string
$name = ''], [string
$encoding = 'base64'], [string
$type = 'application/octet-stream'])

Adds an embedded attachment. This can include images, sounds, and just about any other document. Make sure to set the $type to an image type. For JPEG images use "image/jpeg" and for GIF images use "image/gif".

Tags:

access:

public

Parameters:

string	$path	Path to the attachment.
string	$cid	Content ID of the attachment. Use this to identify the Id for accessing the image in an HTML form.
string	$name	Overrides the attachment name.
string	$encoding	File encoding (see $Encoding).
string	$type	File extension (MIME) type.

[ Top ]

method AddrAppend [line 660]

string AddrAppend(

$type, 
$addr)

Creates recipient headers.

Tags:

access:

public

Parameters:

	$type
	$addr

[ Top ]

method AddReplyTo [line 358]

boolean AddReplyTo(
string
$address, [string
$name = ''])

Adds a "Reply-to" address.

Tags:

access:

public

Parameters:

string	$address
string	$name

[ Top ]

method AddrFormat [line 677]

string AddrFormat(

$addr)

Formats an address correctly.

Tags:

access:

public

Parameters:

$addr

[ Top ]

method AddStringAttachment [line 1517]

void AddStringAttachment(
string
$string, string
$filename, [string
$encoding = 'base64'], [string
$type = 'application/octet-stream'])

Adds a string or binary attachment (non-filesystem) to the list.

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

Tags:

access:

public

Parameters:

string	$string	String attachment data.
string	$filename	Name of the attachment.
string	$encoding	File encoding (see $Encoding).
string	$type	File extension (MIME) type.

[ Top ]

method Base64EncodeWrapMB [line 1360]

string Base64EncodeWrapMB(
string
$str)

Correctly encodes and wraps 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

Tags:

access:

public

Parameters:

string

$str

multi-byte text to wrap encode

[ Top ]

method ClearAddresses [line 1593]

void ClearAddresses(
)

Clears all recipients assigned in the TO array. Returns void.

Tags:

access:

public

[ Top ]

method ClearAllRecipients [line 1635]

void ClearAllRecipients(
)

Clears all recipients assigned in the TO, CC and BCC array. Returns void.

Tags:

access:

public

[ Top ]

method ClearAttachments [line 1647]

void ClearAttachments(
)

Clears all previously set filesystem, string, and binary attachments. Returns void.

Tags:

access:

public

[ Top ]

method ClearBCCs [line 1615]

void ClearBCCs(
)

Clears all recipients assigned in the BCC array. Returns void.

Tags:

access:

public

[ Top ]

method ClearCCs [line 1604]

void ClearCCs(
)

Clears all recipients assigned in the CC array. Returns void.

Tags:

access:

public

[ Top ]

method ClearCustomHeaders [line 1655]

void ClearCustomHeaders(
)

Clears all custom headers. Returns void.

Tags:

access:

public

[ Top ]

method ClearReplyTos [line 1626]

void ClearReplyTos(
)

Clears all recipients assigned in the ReplyTo array. Returns void.

Tags:

access:

public

[ Top ]

method CreateBody [line 951]

string CreateBody(
)

Assembles the message body. Returns an empty string on failure.

Tags:

return:	The assembled message body
access:	public

[ Top ]

method CreateHeader [line 834]

string CreateHeader(
)

Assembles message header.

Tags:

return:	The assembled header
access:	public

[ Top ]

method DKIM_Add [line 2026]

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

Create the DKIM header, body, as new header

Tags:

access:

public

Parameters:

string	$headers_line	Header lines
string	$subject	Subject
string	$body	Body

[ Top ]

method DKIM_BodyC [line 2006]

void DKIM_BodyC(
string
$body)

Generate DKIM Canonicalization Body

Tags:

access:

public

Parameters:

string

$body

Message Body

[ Top ]

method DKIM_HeaderC [line 1987]

void DKIM_HeaderC(
string
$s)

Generate DKIM Canonicalization Header

Tags:

access:

public

Parameters:

string

Header

[ Top ]

method DKIM_QP [line 1949]

void DKIM_QP(

$txt, string
$key_filename, string
$key_pass)

Set the private key file and password to sign the message.

Tags:

access:

public

Parameters:

string	$key_filename	Parameter File Name
string	$key_pass	Password for private key
	$txt

[ Top ]

method DKIM_Sign [line 1969]

void DKIM_Sign(
string
$s)

Generate DKIM signature

Tags:

access:

public

Parameters:

string

Header

[ Top ]

method doCallback [line 2061]

void doCallback(

$isSent, 
$to, 
$cc, 
$bcc, 
$subject, 
$body)

Tags:

access:

protected

Parameters:

	$isSent
	$to
	$cc
	$bcc
	$subject
	$body

[ Top ]

method EncodeHeader [line 1283]

string EncodeHeader(

$str, [
$position = 'text'])

Encode a header string to best (shortest) of Q, B, quoted or none.

Tags:

access:

public

Parameters:

	$str
	$position

[ Top ]

method EncodeQ [line 1482]

string EncodeQ(
string
$str, [string
$position = 'text'])

Encode string to q encoding.

Tags:

link:	http://tools.ietf.org/html/rfc2047
access:	public

Parameters:

string	$str	the text to encode
string	$position	Where the text is going to be used, see the RFC for what that means

[ Top ]

method EncodeQP [line 1453]

string EncodeQP(
string
$string, [integer
$line_max = 76], [boolean
$space_conv = false])

Encode string to RFC2045 (6.7) quoted-printable format

Uses a PHP5 stream filter to do the encoding about 64x faster than the old version Also results in same content as you started with after decoding

Tags:

author:	Marcus Bointon
see:	PHPMailerLite::EncodeQPphp()
access:	public

Parameters:

string	$string	the text to encode
integer	$line_max	Number of chars allowed on a line before wrapping
boolean	$space_conv	Dummy param for compatibility with existing EncodeQP function

[ Top ]

method EncodeQPphp [line 1400]

string EncodeQPphp(
[
$input = ''], [integer
$line_max = 76], [
$space_conv = false], string
$string)

Encode string to quoted-printable.

Only uses standard PHP, slow, but will always work

Tags:

access:

public

Parameters:

string	$string	the text to encode
integer	$line_max	Number of chars allowed on a line before wrapping
	$input
	$space_conv

[ Top ]

method EncodeString [line 1252]

string EncodeString(
string
$str, [string
$encoding = 'base64'])

Encodes string to requested format.

Returns an empty string on failure.

Tags:

access:

public

Parameters:

string	$str	The text to encode
string	$encoding	The encoding to use; one of 'base64', '7bit', '8bit', 'binary', 'quoted-printable'

[ Top ]

method GetAttachments [line 1143]

array GetAttachments(
)

Return the current array of attachments

Tags:

access:

public

[ Top ]

method GetMailMIME [line 917]

string GetMailMIME(
)

Returns the message MIME.

Tags:

access:

public

[ Top ]

method GetTranslations [line 647]

array GetTranslations(
)

Return the current array of language strings

Tags:

access:

public

[ Top ]

method HasMultiBytes [line 1344]

bool HasMultiBytes(
string
$str)

Checks if a string contains multibyte characters.

Tags:

access:

public

Parameters:

string

$str

multi-byte text to wrap encode

[ Top ]

method HeaderLine [line 1078]

string HeaderLine(

$name, 
$value)

Returns a formatted header line.

Tags:

access:

public

Parameters:

	$name
	$value

[ Top ]

method InlineImageExists [line 1576]

bool InlineImageExists(
)

Returns true if an inline attachment is present.

Tags:

access:

public

[ Top ]

method IsError [line 1728]

bool IsError(
)

Returns true if an error occurred.

Tags:

access:

public

[ Top ]

method IsHTML [line 278]

void IsHTML(
[bool
$ishtml = true])

Sets message type to HTML.

Tags:

access:

public

Parameters:

bool

$ishtml

[ Top ]

method IsMail [line 290]

void IsMail(
)

Sets Mailer to send message using PHP mail() function.

Tags:

access:

public

[ Top ]

method IsQmail [line 309]

void IsQmail(
)

Sets Mailer to send message using the qmail MTA.

Tags:

access:

public

[ Top ]

method IsSendmail [line 298]

void IsSendmail(
)

Sets Mailer to send message using the $Sendmail program.

Tags:

access:

public

[ Top ]

method MailSend [line 563]

bool MailSend(
string
$header, string
$body)

Sends mail using the PHP mail() function.

Tags:

access:

protected

Parameters:

string	$header	The message headers
string	$body	The message body

[ Top ]

method MsgHTML [line 1758]

$message MsgHTML(

$message, [
$basedir = ''])

Evaluates the message and returns modifications for inline images and backgrounds

Tags:

access:

public

Parameters:

	$message
	$basedir

[ Top ]

method SecureHeader [line 1923]

string SecureHeader(
string
$str)

Strips newlines to prevent header injection.

Tags:

access:

public

Parameters:

string

$str

String

[ Top ]

method Send [line 464]

bool Send(
)

Creates message and assigns Mailer. If the message is not sent successfully then it returns false. Use the ErrorInfo variable to view description of the error.

Tags:

access:

public

[ Top ]

method SendmailSend [line 517]

bool SendmailSend(
string
$header, string
$body)

Sends mail using the $Sendmail program.

Tags:

access:

protected

Parameters:

string	$header	The message headers
string	$body	The message body

[ Top ]

method set [line 1901]

void set(
string
$name, [mixed
$value = ''])

Set (or reset) Class Objects (variables)

Usage Example: $page->set('X-Priority', '3');

Tags:

todo:	Should this not be using __set() magic function?
access:	public

Parameters:

string	$name	Parameter Name
mixed	$value	Parameter Value NOTE: will not work with arrays, there are no arrays to set/reset

[ Top ]

method SetError [line 1668]

void SetError(

$msg)

Adds the error message to the error container.

Tags:

access:

protected

Parameters:

$msg

[ Top ]

method SetFrom [line 407]

boolean SetFrom(
string
$address, [string
$name = ''], [
$auto = 1])

Set the From and FromName properties

Tags:

access:

public

Parameters:

string	$address
string	$name
	$auto

[ Top ]

method SetLanguage [line 618]

void SetLanguage(
[string
$langcode = 'en'], [string
$lang_path = 'language/'])

Sets the language for all class error messages.

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

Tags:

access:

public

Parameters:

string	$langcode	ISO 639-1 2-character language code (e.g. Portuguese: "br")
string	$lang_path	Path to the language file directory

[ Top ]

method SetWordWrap [line 814]

void SetWordWrap(
)

Set the body wrapping.

Tags:

access:

public

[ Top ]

method Sign [line 1936]

void Sign(

$cert_filename, string
$key_filename, string
$key_pass)

Set the private key file and password to sign the message.

Tags:

access:

public

Parameters:

string	$key_filename	Parameter File Name
string	$key_pass	Password for private key
	$cert_filename

[ Top ]

method TextLine [line 1087]

string TextLine(

$value)

Returns a formatted mail line.

Tags:

access:

public

Parameters:

$value

[ Top ]

method UTF8CharBoundary [line 777]

int UTF8CharBoundary(
string
$encodedText, int
$maxLength)

Finds last character boundary prior to maxLength in a utf-8 quoted (printable) encoded string.

Original written by Colin Brown.

Tags:

access:

public

Parameters:

string	$encodedText	utf-8 QP text
int	$maxLength	find last character boundary prior to this length

[ Top ]

method WrapText [line 695]

string WrapText(
string
$message, integer
$length, [boolean
$qp_mode = false])

Wraps message for use with mailers that do not automatically perform wrapping and for quoted-printable.

Original written by philippe.

Tags:

access:

public

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

[ Top ]

Class: PHPMailerLite

Class Overview

Author(s):

Version:

Copyright:

Variables

Constants

Methods

Class Details

Tags:

Class Variables

$action_function = ''

Tags:

$AltBody = ''

Tags:

$Body = ''

Tags:

$CharSet = 'iso-8859-1'

Tags:

$ConfirmReadingTo = ''

Tags:

$ContentType = 'text/plain'

Tags:

$DKIM_domain = ''

Tags:

$DKIM_identity = ''

Tags:

$DKIM_passphrase = ''

Tags:

$DKIM_private = ''

Tags:

$DKIM_selector = 'phpmailer'

Tags:

$Encoding = '8bit'

Tags:

$ErrorInfo = ''

Tags:

$From = 'root@localhost'

Tags:

$FromName = 'Root User'

Tags:

$Hostname = ''

Tags:

$language = array()

Tags:

$LE = "\n"

Tags:

$Mailer = 'sendmail'

Tags:

$MessageID = ''

Tags:

$Priority = 3

Tags:

$Sender = ''

Tags:

$Sendmail = '/usr/sbin/sendmail'

Tags:

$SingleTo = true

Tags:

$SingleToArray = array()

Tags:

$Subject = ''

Tags:

$Version = 'Lite 5.1'

Tags:

$WordWrap = 0

Tags:

Class Methods

static method RFCDate [line 1679]

Tags:

static method ValidateAddress [line 442]

Tags:

Parameters:

static method _mime_types [line 1796]

Tags:

Parameters:

constructor __construct [line 269]

Tags:

Parameters:

method AddAddress [line 326]