Source for file phpmailer.php
Documentation is available at phpmailer.php
.---------------------------------------------------------------------------.
| Software: PHPMailer - PHP email class |
| Site: https://github.com/PHPMailer/PHPMailer/ |
| ------------------------------------------------------------------------- |
| Admins: Marcus Bointon |
| Admins: Jim Jagielski |
| Authors: Andy Prevost (codeworxtech) codeworxtech@users.sourceforge.net |
| : Marcus Bointon (coolbru) phpmailer@synchromedia.co.uk |
| : Jim Jagielski (jimjag) jimjag@gmail.com |
| Founder: Brent R. Matzelle (original founder) |
| Copyright (c) 2010-2012, Jim Jagielski. All Rights Reserved. |
| Copyright (c) 2004-2009, Andy Prevost. All Rights Reserved. |
| Copyright (c) 2001-2003, Brent R. Matzelle |
| ------------------------------------------------------------------------- |
| License: Distributed under the Lesser General Public License (LGPL) |
| http://www.gnu.org/copyleft/lesser.html |
| This program is distributed in the hope that it will be useful - WITHOUT |
| ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or |
| FITNESS FOR A PARTICULAR PURPOSE. |
'---------------------------------------------------------------------------'
* PHPMailer - PHP email creation and transport class
* NOTE: Requires PHP version 5 or later
* @copyright 2010 - 2012 Jim Jagielski
* @copyright 2004 - 2009 Andy Prevost
* @license http://www.gnu.org/copyleft/lesser.html GNU Lesser General Public License
exit("Sorry, PHPMailer will only run on PHP version 5 or greater!\n");
* PHP email creation and transport class
/////////////////////////////////////////////////
/////////////////////////////////////////////////
* Email priority (1 = High, 3 = Normal, 5 = low).
* Sets the CharSet of the message.
* Sets the Content-type of the message.
* Sets the Encoding of the message. Options for this are
* "8bit", "7bit", "binary", "base64", and "quoted-printable".
* Holds the most recent mailer error message.
* Sets the From email address for the message.
public $From =
'root@localhost';
* Sets the From name of the message.
* Sets 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.
* Sets the Return-Path of the message. If empty, it will
* be set to either From or Sender.
* Sets the Subject of the message.
* An HTML or plain text message body.
* If HTML then call IsHTML(true).
* 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.
* 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
* @link http://sprain.ch/blog/downloads/php-class-easypeasyics-create-ical-files-with-php/
* @link http://kigkonsult.se/iCalcreator/
* Stores the complete compiled MIME message body.
* Stores the complete compiled MIME message headers.
* Stores the extra header list which CreateHeader() doesn't fold in
* Sets word wrapping on the body of the message to a given number of
* Method to send mail: ("mail", "sendmail", or "smtp").
* Sets the path of the sendmail program.
* Determine if mail() uses a fully sendmail compatible MTA that
* supports sendmail's "-oi -f" options
* Path to PHPMailer plugins. Useful if the SMTP class
* is in a different directory than the PHP include path.
* Sets the email address that a reading confirmation will be sent.
* 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'.
* Sets the message ID to be used in the Message-Id header.
* If empty, a unique id will be generated.
* Sets the message Date to be used in the Date header.
* If empty, the current date will be added.
/////////////////////////////////////////////////
/////////////////////////////////////////////////
* All hosts must be separated by a
* semicolon. 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").
* Hosts will be tried in order.
public $Host =
'localhost';
* Sets the default SMTP server port.
* Sets the SMTP HELO of the message (Default is $Hostname).
* Sets connection prefix. Options are "", "ssl" or "tls"
* Sets SMTP authentication. Utilizes the Username and Password variables.
* Sets SMTP auth type. Options are LOGIN | PLAIN | NTLM | CRAM-MD5 (default LOGIN)
* Sets the SMTP server timeout in seconds.
* This function will not work with the win32 version.
* Sets SMTP class debugging on or off.
* Sets the function/method to use for debugging output.
* Right now we only honor "echo" or "error_log"
* Prevents the SMTP connection from being closed after each mail
* sending. If this is set to true then to close the connection
* requires an explicit call to SmtpClose().
* Provides the ability to have the TO field process individual
* emails, instead of sending to entire TO addresses
* Should we generate VERP addresses when sending via SMTP?
* @link http://en.wikipedia.org/wiki/Variable_envelope_return_path
* If SingleTo is true, this provides the array to hold the email addresses
* Should we allow sending messages with empty body?
* Provides the ability to change the generic line ending
* NOTE: The default remains '\n'. We force CRLF where we KNOW
* it must be used via self::CRLF
* required parameter if DKIM is enabled
* domain selector example domainkey
* required if DKIM is enabled, in format of email address 'you@yourdomain.com' typically used as the source of the email
* optional parameter if your private key requires a passphras
* required if DKIM is enabled, in format of email address 'domain.com'
* required if DKIM is enabled, path to private key file
* 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.
* - 'function_name' for function names
* - 'Class::Method' for static method calls
* - array($object, 'Method') for calling methods on $object
* See http://php.net/is_callable manual page for more details.
* 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
* string $from email address of sender
* Sets the PHPMailer Version number
* What to use in the X-Mailer header
* @var string NULL for default, whitespace for None, or actual string to use
/////////////////////////////////////////////////
// PROPERTIES, PRIVATE AND PROTECTED
/////////////////////////////////////////////////
* @var SMTP An instance of the SMTP sender class
* @var array An array of 'to' addresses
* @var array An array of 'cc' addresses
* @var array An array of 'bcc' addresses
protected $bcc =
array();
* @var array An array of reply-to name and address
* @var array An array of all kinds of addresses: to, cc, bcc, replyto
* @var array An array of attachments
* @var array An array of custom headers
* @var string The message's MIME type
* @var array An array of MIME boundary strings
* @var array An array of available languages
* @var integer The number of errors encountered
* @var string The filename of a DKIM certificate file
* @var string The filename of a DKIM key file
* @var string The password of a DKIM key
* @var boolean Whether to throw exceptions for errors
/////////////////////////////////////////////////
/////////////////////////////////////////////////
const STOP_MESSAGE =
0; // message only, continue processing
const STOP_CONTINUE =
1; // message?, likely ok to continue processing
const STOP_CRITICAL =
2; // message, plus full stop, critical error reached
const CRLF =
"\r\n"; // SMTP RFC specified EOL
/////////////////////////////////////////////////
/////////////////////////////////////////////////
* Calls actual mail() function, but 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,
* @param string $subject Subject
* @param string $body Message Body
* @param string $header Additional Header(s)
* @param string $params Params
private function mail_passthru($to, $subject, $body, $header, $params) {
* Outputs debugging info via user-defined method
protected function edebug($str) {
//Cleans up output a bit for a better looking display that's HTML-safe
//Just echoes exactly what was received
* @param boolean $exceptions Should we throw external exceptions?
if ($this->Mailer ==
'smtp') { //Close any open SMTP connection nicely
* Sets message type to HTML.
public function IsHTML($ishtml =
true) {
* Sets Mailer to send message using SMTP.
* Sets Mailer to send message using PHP mail() function.
* Sets Mailer to send message using the $Sendmail program.
$this->Sendmail =
'/var/qmail/bin/sendmail';
* Sets Mailer to send message using the qmail MTA.
$this->Sendmail =
'/var/qmail/bin/sendmail';
/////////////////////////////////////////////////
/////////////////////////////////////////////////
* @return boolean true on success, false if address already used
public function AddAddress($address, $name =
'') {
* Note: this function works with the SMTP mailer on win32, not with the "mail" mailer.
* @return boolean true on success, false if address already used
public function AddCC($address, $name =
'') {
* Note: this function works with the SMTP mailer on win32, not with the "mail" mailer.
* @return boolean true on success, false if address already used
public function AddBCC($address, $name =
'') {
* Adds a "Reply-to" address.
public function AddReplyTo($address, $name =
'') {
* Adds an address to one of the recipient arrays
* Addresses that have been added already return false, but do not throw exceptions
* @param string $kind One of 'to', 'cc', 'bcc', 'ReplyTo'
* @param string $address The email address to send to
* @throws phpmailerException
* @return boolean true on success, false if address already used or invalid in some way
protected function AddAnAddress($kind, $address, $name =
'') {
if (!preg_match('/^(to|cc|bcc|Reply-To)$/', $kind)) {
$this->SetError($this->Lang('Invalid recipient array').
': '.
$kind);
$this->edebug($this->Lang('Invalid recipient array').
': '.
$kind);
$address =
trim($address);
$this->SetError($this->Lang('invalid_address').
': '.
$address);
$this->edebug($this->Lang('invalid_address').
': '.
$address);
if ($kind !=
'Reply-To') {
* Set the From and FromName properties
* @param boolean $auto Whether to also set the Sender address, defaults to true
* @throws phpmailerException
public function SetFrom($address, $name =
'', $auto =
true) {
$address =
trim($address);
$this->SetError($this->Lang('invalid_address').
': '.
$address);
$this->edebug($this->Lang('invalid_address').
': '.
$address);
* Check that a string looks roughly like an email address should
* Static so it can be used without instantiation, public so people can overload
* Conforms to RFC5322: Uses *correct* regex on which FILTER_VALIDATE_EMAIL is
* based; So why not use FILTER_VALIDATE_EMAIL? Because it was broken to
* not allow a@b type valid addresses :(
* @link http://squiloople.com/2009/12/20/email-address-validation/
* @copyright regex Copyright Michael Rushton 2009-10 | http://squiloople.com/ | Feel free to use and redistribute this code. But please keep this copyright notice.
* @param string $address The email address to check
if (defined('PCRE_VERSION')) { //Check this instead of extension_loaded so it works when that function is disabled
return (boolean)
preg_match('/^(?!(?>(?1)"?(?>\\\[ -~]|[^"])"?(?1)){255,})(?!(?>(?1)"?(?>\\\[ -~]|[^"])"?(?1)){65,}@)((?>(?>(?>((?>(?>(?>\x0D\x0A)?[\t ])+|(?>[\t ]*\x0D\x0A)?[\t ]+)?)(\((?>(?2)(?>[\x01-\x08\x0B\x0C\x0E-\'*-\[\]-\x7F]|\\\[\x00-\x7F]|(?3)))*(?2)\)))+(?2))|(?2))?)([!#-\'*+\/-9=?^-~-]+|"(?>(?2)(?>[\x01-\x08\x0B\x0C\x0E-!#-\[\]-\x7F]|\\\[\x00-\x7F]))*(?2)")(?>(?1)\.(?1)(?4))*(?1)@(?!(?1)[a-z0-9-]{64,})(?1)(?>([a-z0-9](?>[a-z0-9-]*[a-z0-9])?)(?>(?1)\.(?!(?1)[a-z0-9-]{64,})(?1)(?5)){0,126}|\[(?:(?>IPv6:(?>([a-f0-9]{1,4})(?>:(?6)){7}|(?!(?:.*[a-f0-9][:\]]){8,})((?6)(?>:(?6)){0,6})?::(?7)?))|(?>(?>IPv6:(?>(?6)(?>:(?6)){5}:|(?!(?:.*[a-f0-9]:){6,})(?8)?::(?>((?6)(?>:(?6)){0,4}):)?))?(25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])(?>\.(?9)){3}))\])(?1)$/isD', $address);
//Fall back to an older regex that doesn't need a recent PCRE
return (boolean)
preg_match('/^(?!(?>"?(?>\\\[ -~]|[^"])"?){255,})(?!(?>"?(?>\\\[ -~]|[^"])"?){65,}@)(?>[!#-\'*+\/-9=?^-~-]+|"(?>(?>[\x01-\x08\x0B\x0C\x0E-!#-\[\]-\x7F]|\\\[\x00-\xFF]))*")(?>\.(?>[!#-\'*+\/-9=?^-~-]+|"(?>(?>[\x01-\x08\x0B\x0C\x0E-!#-\[\]-\x7F]|\\\[\x00-\xFF]))*"))*@(?>(?![a-z0-9-]{64,})(?>[a-z0-9](?>[a-z0-9-]*[a-z0-9])?)(?>\.(?![a-z0-9-]{64,})(?>[a-z0-9](?>[a-z0-9-]*[a-z0-9])?)){0,126}|\[(?:(?>IPv6:(?>(?>[a-f0-9]{1,4})(?>:[a-f0-9]{1,4}){7}|(?!(?:.*[a-f0-9][:\]]){8,})(?>[a-f0-9]{1,4}(?>:[a-f0-9]{1,4}){0,6})?::(?>[a-f0-9]{1,4}(?>:[a-f0-9]{1,4}){0,6})?))|(?>(?>IPv6:(?>[a-f0-9]{1,4}(?>:[a-f0-9]{1,4}){5}:|(?!(?:.*[a-f0-9]:){6,})(?>[a-f0-9]{1,4}(?>:[a-f0-9]{1,4}){0,4})?::(?>(?:[a-f0-9]{1,4}(?>:[a-f0-9]{1,4}){0,4}):)?))?(?>25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])(?>\.(?>25[0-5]|2[0-4][0-9]|1[0-9]{2}|[1-9]?[0-9])){3}))\])$/isD', $address);
//No PCRE! Do something _very_ approximate!
//Check the address is 3 chars or longer and contains an @ that's not the first or last char
/////////////////////////////////////////////////
/////////////////////////////////////////////////
* 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.
* @throws phpmailerException
if(!$this->PreSend()) return false;
* Prep mail by constructing all message entities
* @throws phpmailerException
// Set whether the message is multipart/alternative
//Refuse to send an empty message unless we are specifically allowing it
// To capture the complete message when using mail(), create
// an extra header list which CreateHeader() doesn't fold in
if ($this->Mailer ==
'mail') {
// digitally sign with DKIM if enabled
* Actual Email transport function
* Send the email via the selected mechanism
* @throws phpmailerException
// Choose the mailer and send through it
$this->edebug($e->getMessage().
"\n");
* Sends mail using the $Sendmail program.
* @param string $header The message headers
* @param string $body The message body
* @throws phpmailerException
if(!@$mail =
popen($sendmail, 'w')) {
fputs($mail, "To: " .
$val .
"\n");
// implement call back function if it exists
$isSent =
($result ==
0) ?
1 :
0;
if(!@$mail =
popen($sendmail, 'w')) {
// implement call back function if it exists
$isSent =
($result ==
0) ?
1 :
0;
* Sends mail using the PHP mail() function.
* @param string $header The message headers
* @param string $body The message body
* @throws phpmailerException
protected function MailSend($header, $body) {
foreach($this->to as $t) {
$old_from =
ini_get('sendmail_from');
foreach ($toArr as $val) {
$rt =
$this->mail_passthru($val, $this->Subject, $body, $header, $params);
// implement call back function if it exists
$isSent =
($rt ==
1) ?
1 :
0;
$rt =
$this->mail_passthru($to, $this->Subject, $body, $header, $params);
// implement call back function if it exists
$isSent =
($rt ==
1) ?
1 :
0;
ini_set('sendmail_from', $old_from);
* Sends mail via SMTP using PhpSMTP
* Returns false if there is a bad MAIL FROM, RCPT, or DATA input.
* @param string $header The message headers
* @param string $body The message body
* @throws phpmailerException
protected function SmtpSend($header, $body) {
// Attempt to send attach all recipients
foreach($this->to as $to) {
// implement call back function if it exists
// implement call back function if it exists
foreach($this->cc as $cc) {
// implement call back function if it exists
// implement call back function if it exists
foreach($this->bcc as $bcc) {
// implement call back function if it exists
// implement call back function if it exists
if (count($bad_rcpt) >
0 ) { //Create error message for any bad addresses
$badaddresses =
implode(', ', $bad_rcpt);
if(!$this->smtp->Data($header .
$body)) {
* Initiates a connection to an SMTP server.
* Returns false if the operation failed.
* @param array $options An array of options compatible with stream_context_create()
* @throws phpmailerException
foreach ($hosts as $hostentry) {
if (preg_match('/^(.+):([0-9]+)$/', $hostentry, $hostinfo)) { //If $hostentry contains 'address:port', override default
//We must resend HELO after tls negotiation
//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
* Closes the active SMTP session if one exists.
if ($this->smtp !==
null) {
* Sets the language for all class error messages.
* Returns false if it cannot load the language file. The default language is English.
* @param string $langcode ISO 639-1 2-character language code (e.g. Portuguese: "br")
* @param string $lang_path Path to the language file directory
function SetLanguage($langcode =
'en', $lang_path =
'language/') {
//Define full set of translatable strings
'authenticate' =>
'SMTP Error: Could not authenticate.',
'connect_host' =>
'SMTP Error: Could not connect to SMTP host.',
'data_not_accepted' =>
'SMTP Error: Data not accepted.',
'empty_message' =>
'Message body empty',
'encoding' =>
'Unknown encoding: ',
'execute' =>
'Could not execute: ',
'file_access' =>
'Could not access file: ',
'file_open' =>
'File Error: Could not open file: ',
'from_failed' =>
'The following From address failed: ',
'instantiate' =>
'Could not instantiate mail function.',
'invalid_address' =>
'Invalid address',
'mailer_not_supported' =>
' mailer is not supported.',
'provide_address' =>
'You must provide at least one recipient email address.',
'recipients_failed' =>
'SMTP Error: The following recipients failed: ',
'signing' =>
'Signing Error: ',
'smtp_connect_failed' =>
'SMTP Connect() failed.',
'smtp_error' =>
'SMTP server error: ',
'variable_set' =>
'Cannot set or reset variable: '
//Overwrite language-specific strings. This way we'll never have missing translations - no more "language string failed to load"!
if ($langcode !=
'en') { //There is no English translation file
$l =
@include $lang_path.
'phpmailer.lang-'.
$langcode.
'.php';
return ($l ==
true); //Returns false if language not found
* Return the current array of language strings
/////////////////////////////////////////////////
// METHODS, MESSAGE CREATION
/////////////////////////////////////////////////
* Creates recipient headers.
$addr_str =
$type .
': ';
$addr_str .=
implode(', ', $addresses);
* Formats an address correctly.
* Wraps message for use with mailers that do not
* automatically perform wrapping and for quoted-printable.
* Original written by philippe.
* @param string $message The message to wrap
* @param integer $length The line length to wrap to
* @param boolean $qp_mode Whether to run in Quoted-Printable mode
public function WrapText($message, $length, $qp_mode =
false) {
$soft_break =
($qp_mode) ?
sprintf(" =%s", $this->LE) :
$this->LE;
// If utf-8 encoding is used, we will need to make sure we don't
// split multibyte characters when we wrap
$crlflen =
strlen(self::CRLF);
$message =
$this->FixEOL($message);
if (substr($message, -
$lelen) ==
$this->LE) {
$message =
substr($message, 0, -
$lelen);
$line =
explode($this->LE, $message); // Magic. We know FixEOL uses $LE
for ($i =
0 ;$i <
count($line); $i++
) {
$line_part =
explode(' ', $line[$i]);
for ($e =
0; $e<
count($line_part); $e++
) {
if ($qp_mode and (strlen($word) >
$length)) {
$space_left =
$length -
strlen($buf) -
$crlflen;
} elseif (substr($word, $len -
1, 1) ==
"=") {
} elseif (substr($word, $len -
2, 1) ==
"=") {
$part =
substr($word, 0, $len);
$message .=
$buf .
sprintf("=%s", self::CRLF);
$message .=
$buf .
$soft_break;
} elseif (substr($word, $len -
1, 1) ==
"=") {
} elseif (substr($word, $len -
2, 1) ==
"=") {
$part =
substr($word, 0, $len);
$message .=
$part .
sprintf("=%s", self::CRLF);
$buf .=
($e ==
0) ?
$word :
(' ' .
$word);
if (strlen($buf) >
$length and $buf_o !=
'') {
$message .=
$buf_o .
$soft_break;
$message .=
$buf .
self::CRLF;
* Finds last character boundary prior to maxLength in a utf-8
* quoted (printable) encoded string.
* Original written by Colin Brown.
* @param string $encodedText utf-8 QP text
* @param int $maxLength find last character boundary prior to this length
while (!$foundSplitPos) {
$lastChunk =
substr($encodedText, $maxLength -
$lookBack, $lookBack);
$encodedCharPos =
strpos($lastChunk, "=");
if ($encodedCharPos !==
false) {
// Found start of encoded character byte within $lookBack block.
// Check the encoded byte value (the 2 chars after the '=')
$hex =
substr($encodedText, $maxLength -
$lookBack +
$encodedCharPos +
1, 2);
if ($dec <
128) { // Single byte character.
// If the encoded char was found at pos 0, it will fit
// otherwise reduce maxLength to start of the encoded char
$maxLength =
($encodedCharPos ==
0) ?
$maxLength :
$maxLength -
($lookBack -
$encodedCharPos);
} elseif ($dec >=
192) { // First byte of a multi byte character
// Reduce maxLength to split at start of character
$maxLength =
$maxLength -
($lookBack -
$encodedCharPos);
} elseif ($dec <
192) { // Middle byte of a multi byte character, look further back
// No encoded character found
case 'alt_inline_attach':
* Assembles message header.
* @return string The assembled header
$result .=
$this->HeaderLine('Date', self::RFCDate());
} elseif ($this->Sender ==
'') {
// To be created automatically by mail()
foreach($this->to as $t) {
$result .=
$this->HeaderLine('To', 'undisclosed-recipients:;');
// sendmail and mail() extract Cc from the header before sending
// sendmail and mail() extract Bcc from the header before sending
// mail() sets the subject itself
$result .=
$this->HeaderLine('X-Mailer', 'PHPMailer '.
$this->Version.
' (https://github.com/PHPMailer/PHPMailer/)');
$result .=
$this->HeaderLine('X-Mailer', $myXmailer);
$result .=
$this->HeaderLine('MIME-Version', '1.0');
* Returns the message MIME.
$result .=
$this->HeaderLine('Content-Type', 'multipart/related;');
case 'alt_inline_attach':
$result .=
$this->HeaderLine('Content-Type', 'multipart/mixed;');
$result .=
$this->HeaderLine('Content-Type', 'multipart/alternative;');
// Catches case 'plain': and case '':
//RFC1341 part 5 says 7bit is assumed if not specified
* Returns the MIME message (headers and body). Only really valid post PreSend().
* Assembles the message body. Returns an empty string on failure.
* @throws phpmailerException
* @return string The assembled message body
$body .=
$this->LE.
$this->LE;
$body .=
$this->LE.
$this->LE;
$body .=
$this->HeaderLine('Content-Type', 'multipart/related;');
$body .=
$this->LE.
$this->LE;
$body .=
$this->LE.
$this->LE;
$body .=
$this->LE.
$this->LE;
if(!empty($this->Ical)) {
$body .=
$this->LE.
$this->LE;
$body .=
$this->LE.
$this->LE;
$body .=
$this->HeaderLine('Content-Type', 'multipart/related;');
$body .=
$this->LE.
$this->LE;
$body .=
$this->HeaderLine('Content-Type', 'multipart/alternative;');
$body .=
$this->LE.
$this->LE;
$body .=
$this->LE.
$this->LE;
case 'alt_inline_attach':
$body .=
$this->HeaderLine('Content-Type', 'multipart/alternative;');
$body .=
$this->LE.
$this->LE;
$body .=
$this->HeaderLine('Content-Type', 'multipart/related;');
$body .=
$this->LE.
$this->LE;
// catch case 'plain' and case ''
* Returns the start of a message boundary.
* @param string $boundary
* @param string $contentType
* @param string $encoding
protected function GetBoundary($boundary, $charSet, $contentType, $encoding) {
$result .=
$this->TextLine('--' .
$boundary);
$result .=
sprintf("Content-Type: %s; charset=%s", $contentType, $charSet);
$result .=
$this->HeaderLine('Content-Transfer-Encoding', $encoding);
* Returns the end of a message boundary.
* @param string $boundary
return $this->LE .
'--' .
$boundary .
'--' .
$this->LE;
* Returns a formatted header line.
return $name .
': ' .
$value .
$this->LE;
* Returns a formatted mail line.
return $value .
$this->LE;
/////////////////////////////////////////////////
// CLASS METHODS, ATTACHMENTS
/////////////////////////////////////////////////
* Adds an attachment from a path on the filesystem.
* Returns false if the file could not be found
* @param string $path Path to the attachment.
* @param string $name Overrides the attachment name.
* @param string $encoding File encoding (see $Encoding).
* @param string $type File extension (MIME) type.
* @throws phpmailerException
public function AddAttachment($path, $name =
'', $encoding =
'base64', $type =
'') {
//If a MIME type is not specified, try to work it out from the file name
$type =
self::filenameToType($path);
5 =>
false, // isStringAttachment
$this->edebug($e->getMessage().
"\n");
* Return the current array of attachments
* Attaches all fs, string, and binary attachments to the message.
* Returns an empty string on failure.
* @param string $disposition_type
* @param string $boundary
protected function AttachAll($disposition_type, $boundary) {
// CHECK IF IT IS A VALID DISPOSITION_FILTER
if($attachment[6] ==
$disposition_type) {
// Check for string attachment
$bString =
$attachment[5];
$string =
$attachment[0];
if (in_array($inclhash, $incl)) { continue; }
$filename =
$attachment[1];
$encoding =
$attachment[3];
$disposition =
$attachment[6];
if ( $disposition ==
'inline' && isset
($cidUniq[$cid]) ) { continue; }
$mime[] =
sprintf("--%s%s", $boundary, $this->LE);
$mime[] =
sprintf("Content-Transfer-Encoding: %s%s", $encoding, $this->LE);
if($disposition ==
'inline') {
$mime[] =
sprintf("Content-ID: <%s>%s", $cid, $this->LE);
//If a filename contains any of these chars, it should be quoted, but not otherwise: RFC2183 & RFC2045 5.1
//Fixes a warning in IETF's msglint MIME checker
if (preg_match('/[ \(\)<>@,;:\\"\/\[\]\?=]/', $name)) {
// Encode as string attachment
$mime[] =
$this->LE.
$this->LE;
$mime[] =
$this->LE.
$this->LE;
$mime[] =
sprintf("--%s--%s", $boundary, $this->LE);
* Encodes attachment in requested format.
* Returns an empty string on failure.
* @param string $path The full path to the file
* @param string $encoding The encoding to use; one of 'base64', '7bit', '8bit', 'binary', 'quoted-printable'
* @throws phpmailerException
protected function EncodeFile($path, $encoding =
'base64') {
ini_set('magic_quotes_runtime', 0);
$file_buffer =
$this->EncodeString($file_buffer, $encoding);
ini_set('magic_quotes_runtime', $magic_quotes);
* Encodes string to requested format.
* Returns an empty string on failure.
* @param string $str The text to encode
* @param string $encoding The encoding to use; one of 'base64', '7bit', '8bit', 'binary', 'quoted-printable'
$encoded =
$this->FixEOL($str);
//Make sure it ends with a line break
* Encode a header string to best (shortest) of Q, B, quoted or none.
* @param string $position
// Can't use addslashes as we don't know what value has magic_quotes_sybase
if (($str ==
$encoded) &&
!preg_match('/[^A-Za-z0-9!#$%&\'*+\/=?^_`{|}~ -]/', $str)) {
$x =
preg_match_all('/[^\040\041\043-\133\135-\176]/', $str, $matches);
$x +=
preg_match_all('/[\000-\010\013\014\016-\037\177-\377]/', $str, $matches);
if ($x ==
0) { //There are no chars that need encoding
// Try to select the encoding which should produce the shortest output
if ($x >
strlen($str)/
3) { //More than a third of the content will need encoding, so B encoding will be most efficient
// Use a custom function which correctly encodes and wraps long
// multibyte strings without breaking lines within a character
$encoded =
$this->EncodeQ($str, $position);
$encoded =
$this->WrapText($encoded, $maxlen, true);
* Checks if a string contains multibyte characters.
* @param string $str multi-byte text to wrap encode
} else { // Assume no multibytes (we can't handle without mbstring functions anyway)
* 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
* @param string $str multi-byte text to wrap encode
* @param string $lf string to use as linefeed/end-of-line
$start =
"=?".
$this->CharSet.
"?B?";
// Each line must have length <= 75, including $start and $end
// Average multi-byte ratio
$ratio =
$mb_length /
strlen($str);
// Base64 has a 4:3 ratio
$offset =
$avgLength =
floor($length *
$ratio *
.75);
for ($i =
0; $i <
$mb_length; $i +=
$offset) {
$offset =
$avgLength -
$lookBack;
while (strlen($chunk) >
$length);
$encoded .=
$chunk .
$lf;
// Chomp the last linefeed
* Encode string to RFC2045 (6.7) quoted-printable format
* @param string $string The text to encode
* @param integer $line_max Number of chars allowed on a line before wrapping
* @link PHP version adapted from http://www.php.net/manual/en/function.quoted-printable-decode.php#89417
public function EncodeQP($string, $line_max =
76) {
if (function_exists('quoted_printable_encode')) { //Use native function if it's available (>= PHP5.3)
//Fall back to a pure PHP implementation
$string =
str_replace(array('%20', '%0D%0A.', '%0D%0A', '%'), array(' ', "\r\n=2E", "\r\n", '='), rawurlencode($string));
$string =
preg_replace('/[^\r\n]{'.
($line_max -
3).
'}[^=\r\n]{2}/', "$0=\r\n", $string);
* Wrapper to preserve BC for old QP encoding function that was removed
* @param integer $line_max
* @param bool $space_conv
public function EncodeQPphp($string, $line_max =
76, $space_conv =
false) {
return $this->EncodeQP($string, $line_max);
* Encode string to q encoding.
* @link http://tools.ietf.org/html/rfc2047
* @param string $str the text to encode
* @param string $position Where the text is going to be used, see the RFC for what that means
public function EncodeQ($str, $position =
'text') {
//There should not be any EOL in the string
$pattern =
'^A-Za-z0-9!*+\/ -';
//note that we don't break here!
//for this reason we build the $pattern without including delimiters and []
//Replace every high ascii, control =, ? and _ characters
//We put \075 (=) as first value to make sure it's the first one in being converted, preventing double encode
$pattern =
'\075\000-\011\013\014\016-\037\077\137\177-\377' .
$pattern;
//Replace every spaces to _ (more readable than =20)
* 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.
* @param string $string String attachment data.
* @param string $filename Name of the attachment.
* @param string $encoding File encoding (see $Encoding).
* @param string $type File extension (MIME) type.
//If a MIME type is not specified, try to work it out from the file name
$type =
self::filenameToType($filename);
// Append to $attachment array
5 =>
true, // isStringAttachment
* Add an embedded attachment from a file.
* This can include images, sounds, and just about any other document type.
* @param string $path Path to the attachment.
* @param string $cid Content ID of the attachment; Use this to reference
* the content when using an embedded image in HTML.
* @param string $name Overrides the attachment name.
* @param string $encoding File encoding (see $Encoding).
* @param string $type File MIME type.
* @return bool True on successfully adding an attachment
public function AddEmbeddedImage($path, $cid, $name =
'', $encoding =
'base64', $type =
'') {
//If a MIME type is not specified, try to work it out from the file name
$type =
self::filenameToType($path);
// Append to $attachment array
5 =>
false, // isStringAttachment
* 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'.
* @param string $string The attachment binary data.
* @param string $cid Content ID of the attachment; Use this to reference
* the content when using an embedded image in HTML.
* @param string $encoding File encoding (see $Encoding).
* @param string $type MIME type.
* @return bool True on successfully adding an attachment
//If a MIME type is not specified, try to work it out from the name
$type =
self::filenameToType($name);
// Append to $attachment array
5 =>
true, // isStringAttachment
* Returns true if an inline attachment is present.
if ($attachment[6] ==
'inline') {
* Returns true if an attachment (non-inline) is present.
if ($attachment[6] ==
'attachment') {
* Does this message have an alternative body set?
/////////////////////////////////////////////////
// CLASS METHODS, MESSAGE RESET
/////////////////////////////////////////////////
* Clears all recipients assigned in the TO array. Returns void.
foreach($this->to as $to) {
* Clears all recipients assigned in the CC array. Returns void.
foreach($this->cc as $cc) {
* Clears all recipients assigned in the BCC array. Returns void.
foreach($this->bcc as $bcc) {
* Clears all recipients assigned in the ReplyTo array. Returns void.
* Clears all recipients assigned in the TO, CC and BCC
* Clears all previously set filesystem, string, and binary
* attachments. Returns void.
* Clears all custom headers. Returns void.
/////////////////////////////////////////////////
// CLASS METHODS, MISCELLANEOUS
/////////////////////////////////////////////////
* Adds the error message to the error container.
$msg .=
'<p>' .
$this->Lang('smtp_error') .
$lasterror['smtp_msg'] .
"</p>\n";
* Returns the proper RFC 822 formatted date.
//Set the time zone to whatever the default is to avoid 500 errors
//Will default to UTC if it's not set properly in php.ini
return date('D, j M Y H:i:s O');
* Returns the server hostname or 'localhost.localdomain' if unknown.
} elseif (isset
($_SERVER['SERVER_NAME'])) {
$result =
$_SERVER['SERVER_NAME'];
$result =
'localhost.localdomain';
* Returns a message in the appropriate language.
protected function Lang($key) {
return 'Language string failed to load: ' .
$key;
* Returns true if an error occurred.
* Changes every end of line from CRLF, CR or LF to $this->LE.
* @param string $str String to FixEOL
public function FixEOL($str) {
// Now convert LE as needed
if ($this->LE !==
"\n") {
* Adds a custom header. $name value can be overloaded to contain
* both header name and value (name:value)
* @param string $name custom header name
* @param string $value header value
// Value passed in as name:value
* Creates a message from an HTML string, making modifications for inline images and backgrounds
* and creates a plain-text version by converting the HTML
* Overwrites any existing values in $this->Body and $this->AltBody
* @param string $message HTML message string
* @param string $basedir baseline directory for path
* @param bool $advanced Whether to use the advanced HTML to text converter
* @return string $message
public function MsgHTML($message, $basedir =
'', $advanced =
false) {
preg_match_all("/(src|background)=[\"'](.*)[\"']/Ui", $message, $images);
foreach ($images[2] as $i =>
$url) {
// do not change urls for absolute images (thanks to corvuscorax)
$cid =
md5($url).
'@phpmailer.0'; //RFC2392 S 2
if (strlen($directory) >
1 &&
substr($directory, -
1) !=
'/') {
if ($this->AddEmbeddedImage($basedir.
$directory.
$filename, $cid, $filename, 'base64', self::_mime_types(self::mb_pathinfo($filename, PATHINFO_EXTENSION)))) {
$message =
preg_replace("/".
$images[1][$i].
"=[\"']".
preg_quote($url, '/').
"[\"']/Ui", $images[1][$i].
"=\"cid:".
$cid.
"\"", $message);
$this->AltBody =
'To view this email message, open it in a program that understands HTML!' .
"\n\n";
//Convert all message body line breaks to CRLF, makes quoted-printable encoding work much better
* Convert an HTML string into a plain text version
* @param string $html The HTML text to convert
* @param bool $advanced Should this use the more complex html2text converter or just a simple one?
public function html2text($html, $advanced =
false) {
require_once 'extras/class.html2text.php';
* Gets the MIME type of the embedded or inline image
* @param string $ext File extension
* @return string MIME type of ext
'xl' =>
'application/excel',
'hqx' =>
'application/mac-binhex40',
'cpt' =>
'application/mac-compactpro',
'bin' =>
'application/macbinary',
'doc' =>
'application/msword',
'word' =>
'application/msword',
'class' =>
'application/octet-stream',
'dll' =>
'application/octet-stream',
'dms' =>
'application/octet-stream',
'exe' =>
'application/octet-stream',
'lha' =>
'application/octet-stream',
'lzh' =>
'application/octet-stream',
'psd' =>
'application/octet-stream',
'sea' =>
'application/octet-stream',
'so' =>
'application/octet-stream',
'oda' =>
'application/oda',
'pdf' =>
'application/pdf',
'ai' =>
'application/postscript',
'eps' =>
'application/postscript',
'ps' =>
'application/postscript',
'smi' =>
'application/smil',
'smil' =>
'application/smil',
'mif' =>
'application/vnd.mif',
'xls' =>
'application/vnd.ms-excel',
'ppt' =>
'application/vnd.ms-powerpoint',
'wbxml' =>
'application/vnd.wap.wbxml',
'wmlc' =>
'application/vnd.wap.wmlc',
'dcr' =>
'application/x-director',
'dir' =>
'application/x-director',
'dxr' =>
'application/x-director',
'dvi' =>
'application/x-dvi',
'gtar' =>
'application/x-gtar',
'php3' =>
'application/x-httpd-php',
'php4' =>
'application/x-httpd-php',
'php' =>
'application/x-httpd-php',
'phtml' =>
'application/x-httpd-php',
'phps' =>
'application/x-httpd-php-source',
'js' =>
'application/x-javascript',
'swf' =>
'application/x-shockwave-flash',
'sit' =>
'application/x-stuffit',
'tar' =>
'application/x-tar',
'tgz' =>
'application/x-tar',
'xht' =>
'application/xhtml+xml',
'xhtml' =>
'application/xhtml+xml',
'zip' =>
'application/zip',
'aifc' =>
'audio/x-aiff',
'aiff' =>
'audio/x-aiff',
'ram' =>
'audio/x-pn-realaudio',
'rm' =>
'audio/x-pn-realaudio',
'rpm' =>
'audio/x-pn-realaudio-plugin',
'ra' =>
'audio/x-realaudio',
'eml' =>
'message/rfc822',
'rtx' =>
'text/richtext',
'mov' =>
'video/quicktime',
'qt' =>
'video/quicktime',
'rv' =>
'video/vnd.rn-realvideo',
'avi' =>
'video/x-msvideo',
'movie' =>
'video/x-sgi-movie'
* Try to map a file name to a MIME type, default to application/octet-stream
* @param string $filename A file name or full path, does not need to exist as a file
//In case the path is a URL, strip any query string before getting extension
$qpos =
strpos($filename, '?');
$filename =
substr($filename, 0, $qpos);
$pathinfo =
self::mb_pathinfo($filename);
return self::_mime_types($pathinfo['extension']);
* Drop-in replacement for pathinfo(), but multibyte-safe, cross-platform-safe, old-version-safe.
* Works similarly to the one in PHP >= 5.2.0
* @link http://www.php.net/manual/en/function.pathinfo.php#107461
* @param string $path A filename or path, does not need to exist as a file
* @param 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
public static function mb_pathinfo($path, $options =
null) {
$ret =
array('dirname' =>
'', 'basename' =>
'', 'extension' =>
'', 'filename' =>
'');
preg_match('%^(.*?)[\\\\/]*(([^/\\\\]*?)(\.([^\.\\\\/]+?)|))[\\\\/\.]*$%im', $path, $m);
$ret['basename'] =
$m[2];
$ret['extension'] =
$m[5];
$ret['filename'] =
$m[3];
return $ret['extension'];
* Set (or reset) Class Objects (variables)
* $page->set('X-Priority', '3');
* NOTE: will not work with arrays, there are no arrays to set/reset
* @throws phpmailerException
* @todo Should this not be using __set() magic function?
public function set($name, $value =
'') {
if (isset
($this->$name) ) {
if ($e->getCode() ==
self::STOP_CRITICAL) {
* Strips newlines to prevent header injection.
* Normalize 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
* @param string $breaktype What kind of line break to use, defaults to CRLF
* Set the private key file and password to sign the message.
* @param string $cert_filename
* @param string $key_filename
* @param string $key_pass Password for private key
public function Sign($cert_filename, $key_filename, $key_pass) {
* Set the private key file and password to sign the message.
for ($i =
0; $i <
strlen($txt); $i++
) {
if ( ((0x21 <=
$ord) &&
($ord <=
0x3A)) ||
$ord ==
0x3C ||
((0x3E <=
$ord) &&
($ord <=
0x7E)) ) {
$line .=
"=".
sprintf("%02X", $ord);
* Generate DKIM signature
* @param string $s Header
* @throws phpmailerException
* Generate DKIM Canonicalization Header
* @param string $s Header
foreach ($lines as $key =>
$line) {
list
($heading, $value) =
explode(":", $line, 2);
$value =
preg_replace("/\s+/", " ", $value) ; // Compress useless spaces
$lines[$key] =
$heading.
":".
trim($value) ; // Don't forget to remove WSP around the value
* Generate DKIM Canonicalization Body
* @param string $body Message Body
if ($body ==
'') return "\r\n";
// stabilize line endings
// END stabilize line endings
* Create the DKIM header, body, as new header
* @param string $headers_line Header lines
* @param string $subject Subject
* @param string $body Body
public function DKIM_Add($headers_line, $subject, $body) {
$DKIMsignatureType =
'rsa-sha1'; // Signature & hash algorithms
$DKIMcanonicalization =
'relaxed/simple'; // Canonicalization of header/body
$DKIMquery =
'dns/txt'; // Query method
$DKIMtime =
time() ; // Signature Timestamp = seconds since 00:00:00 - Jan 1, 1970 (UTC time zone)
$subject_header =
"Subject: $subject";
$headers =
explode($this->LE, $headers_line);
foreach($headers as $header) {
if (strpos($header, 'From:') ===
0) {
$current =
'from_header';
} elseif (strpos($header, 'To:') ===
0) {
if($current &&
strpos($header, ' =?') ===
0){
$subject =
str_replace('|', '=7C', $this->DKIM_QP($subject_header)) ; // Copied header fields (dkim-quoted-printable
$DKIMlen =
strlen($body) ; // Length of body
$dkimhdrs =
"DKIM-Signature: v=1; a=" .
$DKIMsignatureType .
"; q=" .
$DKIMquery .
"; l=" .
$DKIMlen .
"; s=" .
$this->DKIM_selector .
";\r\n".
"\tt=" .
$DKIMtime .
"; c=" .
$DKIMcanonicalization .
";\r\n".
"\th=From:To:Subject;\r\n".
"\tbh=" .
$DKIMb64 .
";\r\n".
$toSign =
$this->DKIM_HeaderC($from_header .
"\r\n" .
$to_header .
"\r\n" .
$subject_header .
"\r\n" .
$dkimhdrs);
return $dkimhdrs.
$signed.
"\r\n";
protected function doCallback($isSent, $to, $cc, $bcc, $subject, $body, $from =
null) {
$params =
array($isSent, $to, $cc, $bcc, $subject, $body, $from);
* Exception handler for PHPMailer
* Prettify error message output
$errorMsg =
'<strong>' .
$this->getMessage() .
"</strong><br />\n";
Documentation generated on Tue, 19 Nov 2013 15:10:38 +0100 by phpDocumentor 1.4.3