tims-todo/system/libraries/Email.php

2491 lines
55 KiB
PHP
Raw Permalink Normal View History

<?php
2014-08-08 15:41:59 -04:00
/**
* CodeIgniter
*
* An open source application development framework for PHP
2014-08-08 15:41:59 -04:00
*
* This content is released under the MIT License (MIT)
*
* Copyright (c) 2014 - 2019, British Columbia Institute of Technology
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*
* @package CodeIgniter
* @author EllisLab Dev Team
* @copyright Copyright (c) 2008 - 2014, EllisLab, Inc. (https://ellislab.com/)
* @copyright Copyright (c) 2014 - 2019, British Columbia Institute of Technology (https://bcit.ca/)
* @license https://opensource.org/licenses/MIT MIT License
* @link https://codeigniter.com
* @since Version 1.0.0
2014-08-08 15:41:59 -04:00
* @filesource
*/
defined('BASEPATH') OR exit('No direct script access allowed');
2014-08-08 15:41:59 -04:00
/**
* CodeIgniter Email Class
*
* Permits email to be sent using Mail, Sendmail, or SMTP.
*
* @package CodeIgniter
* @subpackage Libraries
* @category Libraries
* @author EllisLab Dev Team
* @link https://codeigniter.com/user_guide/libraries/email.html
2014-08-08 15:41:59 -04:00
*/
class CI_Email {
/**
* Used as the User-Agent and X-Mailer headers' value.
*
* @var string
*/
public $useragent = 'CodeIgniter';
/**
* Path to the Sendmail binary.
*
* @var string
*/
public $mailpath = '/usr/sbin/sendmail'; // Sendmail path
/**
* Which method to use for sending e-mails.
*
* @var string 'mail', 'sendmail' or 'smtp'
*/
public $protocol = 'mail'; // mail/sendmail/smtp
/**
* STMP Server host
*
* @var string
*/
public $smtp_host = '';
/**
* SMTP Username
*
* @var string
*/
public $smtp_user = '';
/**
* SMTP Password
*
* @var string
*/
public $smtp_pass = '';
/**
* SMTP Server port
*
* @var int
*/
public $smtp_port = 25;
/**
* SMTP connection timeout in seconds
*
* @var int
*/
public $smtp_timeout = 5;
/**
* SMTP persistent connection
*
* @var bool
*/
public $smtp_keepalive = FALSE;
/**
* SMTP Encryption
*
* @var string empty, 'tls' or 'ssl'
*/
public $smtp_crypto = '';
/**
* Whether to apply word-wrapping to the message body.
*
* @var bool
*/
public $wordwrap = TRUE;
/**
* Number of characters to wrap at.
*
* @see CI_Email::$wordwrap
* @var int
*/
public $wrapchars = 76;
/**
* Message format.
*
* @var string 'text' or 'html'
*/
public $mailtype = 'text';
/**
* Character set (default: utf-8)
*
* @var string
*/
public $charset = 'UTF-8';
/**
* Alternative message (for HTML messages only)
*
* @var string
*/
public $alt_message = '';
/**
* Whether to validate e-mail addresses.
*
* @var bool
*/
public $validate = FALSE;
/**
* X-Priority header value.
*
* @var int 1-5
*/
public $priority = 3; // Default priority (1 - 5)
/**
* Newline character sequence.
* Use "\r\n" to comply with RFC 822.
*
* @link http://www.ietf.org/rfc/rfc822.txt
* @var string "\r\n" or "\n"
*/
public $newline = "\n"; // Default newline. "\r\n" or "\n" (Use "\r\n" to comply with RFC 822)
/**
* CRLF character sequence
*
* RFC 2045 specifies that for 'quoted-printable' encoding,
* "\r\n" must be used. However, it appears that some servers
* (even on the receiving end) don't handle it properly and
* switching to "\n", while improper, is the only solution
* that seems to work for all environments.
*
* @link http://www.ietf.org/rfc/rfc822.txt
* @var string
*/
public $crlf = "\n";
/**
* Whether to use Delivery Status Notification.
*
* @var bool
*/
public $dsn = FALSE;
/**
* Whether to send multipart alternatives.
* Yahoo! doesn't seem to like these.
*
* @var bool
*/
public $send_multipart = TRUE;
/**
* Whether to send messages to BCC recipients in batches.
*
* @var bool
*/
public $bcc_batch_mode = FALSE;
/**
* BCC Batch max number size.
*
* @see CI_Email::$bcc_batch_mode
* @var int
*/
public $bcc_batch_size = 200;
// --------------------------------------------------------------------
/**
* Whether PHP is running in safe mode. Initialized by the class constructor.
*
* @var bool
*/
protected $_safe_mode = FALSE;
/**
* Subject header
*
* @var string
*/
protected $_subject = '';
/**
* Message body
*
* @var string
*/
protected $_body = '';
/**
* Final message body to be sent.
*
* @var string
*/
protected $_finalbody = '';
/**
* Final headers to send
*
* @var string
*/
protected $_header_str = '';
/**
* SMTP Connection socket placeholder
*
* @var resource
*/
protected $_smtp_connect = '';
/**
* Mail encoding
*
* @var string '8bit' or '7bit'
*/
protected $_encoding = '8bit';
/**
* Whether to perform SMTP authentication
*
* @var bool
*/
protected $_smtp_auth = FALSE;
/**
* Whether to send a Reply-To header
*
* @var bool
*/
protected $_replyto_flag = FALSE;
/**
* Debug messages
*
* @see CI_Email::print_debugger()
* @var string
*/
protected $_debug_msg = array();
/**
* Recipients
*
* @var string[]
*/
protected $_recipients = array();
/**
* CC Recipients
*
* @var string[]
*/
protected $_cc_array = array();
/**
* BCC Recipients
*
* @var string[]
*/
protected $_bcc_array = array();
2014-08-08 15:41:59 -04:00
/**
* Message headers
*
* @var string[]
*/
protected $_headers = array();
/**
* Attachment data
*
* @var array
*/
protected $_attachments = array();
/**
* Valid $protocol values
*
* @see CI_Email::$protocol
* @var string[]
*/
protected $_protocols = array('mail', 'sendmail', 'smtp');
/**
* Base charsets
*
* Character sets valid for 7-bit encoding,
* excluding language suffix.
*
* @var string[]
*/
protected $_base_charsets = array('us-ascii', 'iso-2022-');
/**
* Bit depths
*
* Valid mail encodings
*
* @see CI_Email::$_encoding
* @var string[]
*/
protected $_bit_depths = array('7bit', '8bit');
/**
* $priority translations
*
* Actual values to send with the X-Priority header
*
* @var string[]
*/
protected $_priorities = array(
1 => '1 (Highest)',
2 => '2 (High)',
3 => '3 (Normal)',
4 => '4 (Low)',
5 => '5 (Lowest)'
);
/**
* mbstring.func_overload flag
*
* @var bool
*/
protected static $func_overload;
// --------------------------------------------------------------------
2014-08-08 15:41:59 -04:00
/**
* Constructor - Sets Email Preferences
*
* The constructor can be passed an array of config values
*
* @param array $config = array()
* @return void
2014-08-08 15:41:59 -04:00
*/
public function __construct(array $config = array())
2014-08-08 15:41:59 -04:00
{
$this->charset = config_item('charset');
$this->initialize($config);
$this->_safe_mode = ( ! is_php('5.4') && ini_get('safe_mode'));
2014-08-08 15:41:59 -04:00
isset(self::$func_overload) OR self::$func_overload = (extension_loaded('mbstring') && ini_get('mbstring.func_overload'));
log_message('info', 'Email Class Initialized');
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Initialize preferences
*
* @param array $config
* @return CI_Email
2014-08-08 15:41:59 -04:00
*/
public function initialize(array $config = array())
2014-08-08 15:41:59 -04:00
{
$this->clear();
2014-08-08 15:41:59 -04:00
foreach ($config as $key => $val)
{
if (isset($this->$key))
{
$method = 'set_'.$key;
if (method_exists($this, $method))
{
$this->$method($val);
}
else
{
$this->$key = $val;
}
}
}
$this->charset = strtoupper($this->charset);
$this->_smtp_auth = isset($this->smtp_user[0], $this->smtp_pass[0]);
2014-08-08 15:41:59 -04:00
return $this;
}
// --------------------------------------------------------------------
/**
* Initialize the Email Data
*
* @param bool
* @return CI_Email
2014-08-08 15:41:59 -04:00
*/
public function clear($clear_attachments = FALSE)
{
$this->_subject = '';
$this->_body = '';
$this->_finalbody = '';
$this->_header_str = '';
$this->_replyto_flag = FALSE;
2014-08-08 15:41:59 -04:00
$this->_recipients = array();
$this->_cc_array = array();
$this->_bcc_array = array();
$this->_headers = array();
$this->_debug_msg = array();
$this->set_header('Date', $this->_set_date());
2014-08-08 15:41:59 -04:00
if ($clear_attachments !== FALSE)
{
$this->_attachments = array();
2014-08-08 15:41:59 -04:00
}
return $this;
}
// --------------------------------------------------------------------
/**
* Set FROM
*
* @param string $from
* @param string $name
* @param string $return_path = NULL Return-Path
* @return CI_Email
2014-08-08 15:41:59 -04:00
*/
public function from($from, $name = '', $return_path = NULL)
2014-08-08 15:41:59 -04:00
{
if (preg_match('/\<(.*)\>/', $from, $match))
2014-08-08 15:41:59 -04:00
{
$from = $match[1];
2014-08-08 15:41:59 -04:00
}
if ($this->validate)
{
$this->validate_email($this->_str_to_array($from));
if ($return_path)
{
$this->validate_email($this->_str_to_array($return_path));
}
2014-08-08 15:41:59 -04:00
}
// prepare the display name
if ($name !== '')
2014-08-08 15:41:59 -04:00
{
// only use Q encoding if there are characters that would require it
if ( ! preg_match('/[\200-\377]/', $name))
{
// add slashes for non-printing characters, slashes, and double quotes, and surround it in double quotes
$name = '"'.addcslashes($name, "\0..\37\177'\"\\").'"';
}
else
{
$name = $this->_prep_q_encoding($name);
2014-08-08 15:41:59 -04:00
}
}
$this->set_header('From', $name.' <'.$from.'>');
isset($return_path) OR $return_path = $from;
$this->set_header('Return-Path', '<'.$return_path.'>');
2014-08-08 15:41:59 -04:00
return $this;
}
// --------------------------------------------------------------------
/**
* Set Reply-to
*
* @param string
* @param string
* @return CI_Email
2014-08-08 15:41:59 -04:00
*/
public function reply_to($replyto, $name = '')
{
if (preg_match('/\<(.*)\>/', $replyto, $match))
2014-08-08 15:41:59 -04:00
{
$replyto = $match[1];
2014-08-08 15:41:59 -04:00
}
if ($this->validate)
{
$this->validate_email($this->_str_to_array($replyto));
}
if ($name !== '')
2014-08-08 15:41:59 -04:00
{
// only use Q encoding if there are characters that would require it
if ( ! preg_match('/[\200-\377]/', $name))
{
// add slashes for non-printing characters, slashes, and double quotes, and surround it in double quotes
$name = '"'.addcslashes($name, "\0..\37\177'\"\\").'"';
}
else
{
$name = $this->_prep_q_encoding($name);
}
2014-08-08 15:41:59 -04:00
}
$this->set_header('Reply-To', $name.' <'.$replyto.'>');
2014-08-08 15:41:59 -04:00
$this->_replyto_flag = TRUE;
return $this;
}
// --------------------------------------------------------------------
/**
* Set Recipients
*
* @param string
* @return CI_Email
2014-08-08 15:41:59 -04:00
*/
public function to($to)
{
$to = $this->_str_to_array($to);
$to = $this->clean_email($to);
if ($this->validate)
{
$this->validate_email($to);
}
if ($this->_get_protocol() !== 'mail')
2014-08-08 15:41:59 -04:00
{
$this->set_header('To', implode(', ', $to));
2014-08-08 15:41:59 -04:00
}
$this->_recipients = $to;
2014-08-08 15:41:59 -04:00
return $this;
}
// --------------------------------------------------------------------
/**
* Set CC
*
* @param string
* @return CI_Email
2014-08-08 15:41:59 -04:00
*/
public function cc($cc)
{
$cc = $this->clean_email($this->_str_to_array($cc));
2014-08-08 15:41:59 -04:00
if ($this->validate)
{
$this->validate_email($cc);
}
$this->set_header('Cc', implode(', ', $cc));
2014-08-08 15:41:59 -04:00
if ($this->_get_protocol() === 'smtp')
2014-08-08 15:41:59 -04:00
{
$this->_cc_array = $cc;
}
return $this;
}
// --------------------------------------------------------------------
/**
* Set BCC
*
* @param string
* @param string
* @return CI_Email
2014-08-08 15:41:59 -04:00
*/
public function bcc($bcc, $limit = '')
{
if ($limit !== '' && is_numeric($limit))
2014-08-08 15:41:59 -04:00
{
$this->bcc_batch_mode = TRUE;
$this->bcc_batch_size = $limit;
}
$bcc = $this->clean_email($this->_str_to_array($bcc));
2014-08-08 15:41:59 -04:00
if ($this->validate)
{
$this->validate_email($bcc);
}
if ($this->_get_protocol() === 'smtp' OR ($this->bcc_batch_mode && count($bcc) > $this->bcc_batch_size))
2014-08-08 15:41:59 -04:00
{
$this->_bcc_array = $bcc;
}
else
{
$this->set_header('Bcc', implode(', ', $bcc));
2014-08-08 15:41:59 -04:00
}
return $this;
}
// --------------------------------------------------------------------
/**
* Set Email Subject
*
* @param string
* @return CI_Email
2014-08-08 15:41:59 -04:00
*/
public function subject($subject)
{
$subject = $this->_prep_q_encoding($subject);
$this->set_header('Subject', $subject);
2014-08-08 15:41:59 -04:00
return $this;
}
// --------------------------------------------------------------------
/**
* Set Body
*
* @param string
* @return CI_Email
2014-08-08 15:41:59 -04:00
*/
public function message($body)
{
$this->_body = rtrim(str_replace("\r", '', $body));
2014-08-08 15:41:59 -04:00
/* strip slashes only if magic quotes is ON
if we do it with magic quotes OFF, it strips real, user-inputted chars.
NOTE: In PHP 5.4 get_magic_quotes_gpc() will always return 0 and
it will probably not exist in future versions at all.
*/
if ( ! is_php('5.4') && get_magic_quotes_gpc())
{
$this->_body = stripslashes($this->_body);
}
return $this;
}
// --------------------------------------------------------------------
/**
* Assign file attachments
*
* @param string $file Can be local path, URL or buffered content
* @param string $disposition = 'attachment'
* @param string $newname = NULL
* @param string $mime = ''
* @return CI_Email
2014-08-08 15:41:59 -04:00
*/
public function attach($file, $disposition = '', $newname = NULL, $mime = '')
2014-08-08 15:41:59 -04:00
{
if ($mime === '')
{
if (strpos($file, '://') === FALSE && ! file_exists($file))
{
$this->_set_error_message('lang:email_attachment_missing', $file);
return FALSE;
}
if ( ! $fp = @fopen($file, 'rb'))
{
$this->_set_error_message('lang:email_attachment_unreadable', $file);
return FALSE;
}
$file_content = stream_get_contents($fp);
$mime = $this->_mime_types(pathinfo($file, PATHINFO_EXTENSION));
fclose($fp);
}
else
{
$file_content =& $file; // buffered file
}
$this->_attachments[] = array(
'name' => array($file, $newname),
'disposition' => empty($disposition) ? 'attachment' : $disposition, // Can also be 'inline' Not sure if it matters
'type' => $mime,
'content' => chunk_split(base64_encode($file_content)),
'multipart' => 'mixed'
);
2014-08-08 15:41:59 -04:00
return $this;
}
// --------------------------------------------------------------------
/**
* Set and return attachment Content-ID
*
* Useful for attached inline pictures
*
* @param string $filename
* @return string
*/
public function attachment_cid($filename)
{
for ($i = 0, $c = count($this->_attachments); $i < $c; $i++)
{
if ($this->_attachments[$i]['name'][0] === $filename)
{
$this->_attachments[$i]['multipart'] = 'related';
$this->_attachments[$i]['cid'] = uniqid(basename($this->_attachments[$i]['name'][0]).'@');
return $this->_attachments[$i]['cid'];
}
}
return FALSE;
}
// --------------------------------------------------------------------
2014-08-08 15:41:59 -04:00
/**
* Add a Header Item
*
* @param string
* @param string
* @return CI_Email
2014-08-08 15:41:59 -04:00
*/
public function set_header($header, $value)
2014-08-08 15:41:59 -04:00
{
$this->_headers[$header] = str_replace(array("\n", "\r"), '', $value);
return $this;
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Convert a String to an Array
*
* @param string
* @return array
*/
protected function _str_to_array($email)
{
if ( ! is_array($email))
{
return (strpos($email, ',') !== FALSE)
? preg_split('/[\s,]/', $email, -1, PREG_SPLIT_NO_EMPTY)
: (array) trim($email);
2014-08-08 15:41:59 -04:00
}
2014-08-08 15:41:59 -04:00
return $email;
}
// --------------------------------------------------------------------
/**
* Set Multipart Value
*
* @param string
* @return CI_Email
2014-08-08 15:41:59 -04:00
*/
public function set_alt_message($str)
2014-08-08 15:41:59 -04:00
{
$this->alt_message = (string) $str;
2014-08-08 15:41:59 -04:00
return $this;
}
// --------------------------------------------------------------------
/**
* Set Mailtype
*
* @param string
* @return CI_Email
2014-08-08 15:41:59 -04:00
*/
public function set_mailtype($type = 'text')
{
$this->mailtype = ($type === 'html') ? 'html' : 'text';
2014-08-08 15:41:59 -04:00
return $this;
}
// --------------------------------------------------------------------
/**
* Set Wordwrap
*
* @param bool
* @return CI_Email
2014-08-08 15:41:59 -04:00
*/
public function set_wordwrap($wordwrap = TRUE)
{
$this->wordwrap = (bool) $wordwrap;
2014-08-08 15:41:59 -04:00
return $this;
}
// --------------------------------------------------------------------
/**
* Set Protocol
*
* @param string
* @return CI_Email
2014-08-08 15:41:59 -04:00
*/
public function set_protocol($protocol = 'mail')
{
$this->protocol = in_array($protocol, $this->_protocols, TRUE) ? strtolower($protocol) : 'mail';
2014-08-08 15:41:59 -04:00
return $this;
}
// --------------------------------------------------------------------
/**
* Set Priority
*
* @param int
* @return CI_Email
2014-08-08 15:41:59 -04:00
*/
public function set_priority($n = 3)
{
$this->priority = preg_match('/^[1-5]$/', $n) ? (int) $n : 3;
2014-08-08 15:41:59 -04:00
return $this;
}
// --------------------------------------------------------------------
/**
* Set Newline Character
*
* @param string
* @return CI_Email
2014-08-08 15:41:59 -04:00
*/
public function set_newline($newline = "\n")
{
$this->newline = in_array($newline, array("\n", "\r\n", "\r")) ? $newline : "\n";
2014-08-08 15:41:59 -04:00
return $this;
}
// --------------------------------------------------------------------
/**
* Set CRLF
*
* @param string
* @return CI_Email
2014-08-08 15:41:59 -04:00
*/
public function set_crlf($crlf = "\n")
{
$this->crlf = ($crlf !== "\n" && $crlf !== "\r\n" && $crlf !== "\r") ? "\n" : $crlf;
2014-08-08 15:41:59 -04:00
return $this;
}
// --------------------------------------------------------------------
/**
* Get the Message ID
*
* @return string
*/
protected function _get_message_id()
{
$from = str_replace(array('>', '<'), '', $this->_headers['Return-Path']);
return '<'.uniqid('').strstr($from, '@').'>';
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Get Mail Protocol
*
* @return mixed
2014-08-08 15:41:59 -04:00
*/
protected function _get_protocol()
2014-08-08 15:41:59 -04:00
{
$this->protocol = strtolower($this->protocol);
in_array($this->protocol, $this->_protocols, TRUE) OR $this->protocol = 'mail';
return $this->protocol;
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Get Mail Encoding
*
* @return string
*/
protected function _get_encoding()
2014-08-08 15:41:59 -04:00
{
in_array($this->_encoding, $this->_bit_depths) OR $this->_encoding = '8bit';
2014-08-08 15:41:59 -04:00
foreach ($this->_base_charsets as $charset)
{
if (strpos($this->charset, $charset) === 0)
2014-08-08 15:41:59 -04:00
{
$this->_encoding = '7bit';
}
}
return $this->_encoding;
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Get content type (text/html/attachment)
*
* @return string
*/
protected function _get_content_type()
{
if ($this->mailtype === 'html')
2014-08-08 15:41:59 -04:00
{
return empty($this->_attachments) ? 'html' : 'html-attach';
2014-08-08 15:41:59 -04:00
}
elseif ($this->mailtype === 'text' && ! empty($this->_attachments))
2014-08-08 15:41:59 -04:00
{
return 'plain-attach';
}
return 'plain';
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Set RFC 822 Date
*
* @return string
*/
protected function _set_date()
{
$timezone = date('Z');
$operator = ($timezone[0] === '-') ? '-' : '+';
2014-08-08 15:41:59 -04:00
$timezone = abs($timezone);
$timezone = floor($timezone/3600) * 100 + ($timezone % 3600) / 60;
2014-08-08 15:41:59 -04:00
return sprintf('%s %s%04d', date('D, j M Y H:i:s'), $operator, $timezone);
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Mime message
*
* @return string
*/
protected function _get_mime_message()
{
return 'This is a multi-part message in MIME format.'.$this->newline.'Your email application may not support this format.';
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Validate Email Address
*
* @param string
* @return bool
*/
public function validate_email($email)
{
if ( ! is_array($email))
{
$this->_set_error_message('lang:email_must_be_array');
return FALSE;
}
foreach ($email as $val)
{
if ( ! $this->valid_email($val))
{
$this->_set_error_message('lang:email_invalid_address', $val);
return FALSE;
}
}
return TRUE;
}
// --------------------------------------------------------------------
/**
* Email Validation
*
* @param string
* @return bool
*/
public function valid_email($email)
2014-08-08 15:41:59 -04:00
{
if (function_exists('idn_to_ascii') && strpos($email, '@'))
{
list($account, $domain) = explode('@', $email, 2);
$domain = defined('INTL_IDNA_VARIANT_UTS46')
? idn_to_ascii($domain, 0, INTL_IDNA_VARIANT_UTS46)
: idn_to_ascii($domain);
if ($domain !== FALSE)
{
$email = $account.'@'.$domain;
}
}
return (bool) filter_var($email, FILTER_VALIDATE_EMAIL);
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Clean Extended Email Address: Joe Smith <joe@smith.com>
*
* @param string
* @return string
*/
public function clean_email($email)
{
if ( ! is_array($email))
{
return preg_match('/\<(.*)\>/', $email, $match) ? $match[1] : $email;
2014-08-08 15:41:59 -04:00
}
$clean_email = array();
foreach ($email as $addy)
{
$clean_email[] = preg_match('/\<(.*)\>/', $addy, $match) ? $match[1] : $addy;
2014-08-08 15:41:59 -04:00
}
return $clean_email;
}
// --------------------------------------------------------------------
/**
* Build alternative plain text message
*
* Provides the raw message for use in plain-text headers of
* HTML-formatted emails.
2014-08-08 15:41:59 -04:00
* If the user hasn't specified his own alternative message
* it creates one by stripping the HTML
*
* @return string
*/
protected function _get_alt_message()
{
if ( ! empty($this->alt_message))
2014-08-08 15:41:59 -04:00
{
return ($this->wordwrap)
? $this->word_wrap($this->alt_message, 76)
: $this->alt_message;
2014-08-08 15:41:59 -04:00
}
$body = preg_match('/\<body.*?\>(.*)\<\/body\>/si', $this->_body, $match) ? $match[1] : $this->_body;
$body = str_replace("\t", '', preg_replace('#<!--(.*)--\>#', '', trim(strip_tags($body))));
2014-08-08 15:41:59 -04:00
for ($i = 20; $i >= 3; $i--)
{
$body = str_replace(str_repeat("\n", $i), "\n\n", $body);
2014-08-08 15:41:59 -04:00
}
// Reduce multiple spaces
$body = preg_replace('| +|', ' ', $body);
return ($this->wordwrap)
? $this->word_wrap($body, 76)
: $body;
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Word Wrap
*
* @param string
* @param int line-length limit
2014-08-08 15:41:59 -04:00
* @return string
*/
public function word_wrap($str, $charlim = NULL)
2014-08-08 15:41:59 -04:00
{
// Set the character limit, if not already present
if (empty($charlim))
2014-08-08 15:41:59 -04:00
{
$charlim = empty($this->wrapchars) ? 76 : $this->wrapchars;
2014-08-08 15:41:59 -04:00
}
// Standardize newlines
if (strpos($str, "\r") !== FALSE)
{
$str = str_replace(array("\r\n", "\r"), "\n", $str);
}
// Reduce multiple spaces at end of line
$str = preg_replace('| +\n|', "\n", $str);
2014-08-08 15:41:59 -04:00
// If the current word is surrounded by {unwrap} tags we'll
// strip the entire chunk and replace it with a marker.
$unwrap = array();
if (preg_match_all('|\{unwrap\}(.+?)\{/unwrap\}|s', $str, $matches))
2014-08-08 15:41:59 -04:00
{
for ($i = 0, $c = count($matches[0]); $i < $c; $i++)
2014-08-08 15:41:59 -04:00
{
$unwrap[] = $matches[1][$i];
$str = str_replace($matches[0][$i], '{{unwrapped'.$i.'}}', $str);
2014-08-08 15:41:59 -04:00
}
}
// Use PHP's native function to do the initial wordwrap.
2014-08-08 15:41:59 -04:00
// We set the cut flag to FALSE so that any individual words that are
// too long get left alone. In the next step we'll deal with them.
2014-08-08 15:41:59 -04:00
$str = wordwrap($str, $charlim, "\n", FALSE);
// Split the string into individual lines of text and cycle through them
$output = '';
2014-08-08 15:41:59 -04:00
foreach (explode("\n", $str) as $line)
{
// Is the line within the allowed character count?
// If so we'll join it to the output and continue
if (self::strlen($line) <= $charlim)
2014-08-08 15:41:59 -04:00
{
$output .= $line.$this->newline;
continue;
}
$temp = '';
do
2014-08-08 15:41:59 -04:00
{
// If the over-length word is a URL we won't wrap it
if (preg_match('!\[url.+\]|://|www\.!', $line))
2014-08-08 15:41:59 -04:00
{
break;
}
// Trim the word down
$temp .= self::substr($line, 0, $charlim - 1);
$line = self::substr($line, $charlim - 1);
2014-08-08 15:41:59 -04:00
}
while (self::strlen($line) > $charlim);
2014-08-08 15:41:59 -04:00
// If $temp contains data it means we had to split up an over-length
// word into smaller chunks so we'll add it back to our current line
if ($temp !== '')
2014-08-08 15:41:59 -04:00
{
$output .= $temp.$this->newline;
2014-08-08 15:41:59 -04:00
}
$output .= $line.$this->newline;
2014-08-08 15:41:59 -04:00
}
// Put our markers back
if (count($unwrap) > 0)
{
foreach ($unwrap as $key => $val)
{
$output = str_replace('{{unwrapped'.$key.'}}', $val, $output);
2014-08-08 15:41:59 -04:00
}
}
return $output;
}
// --------------------------------------------------------------------
/**
* Build final headers
*
* @return void
2014-08-08 15:41:59 -04:00
*/
protected function _build_headers()
{
$this->set_header('User-Agent', $this->useragent);
$this->set_header('X-Sender', $this->clean_email($this->_headers['From']));
$this->set_header('X-Mailer', $this->useragent);
$this->set_header('X-Priority', $this->_priorities[$this->priority]);
$this->set_header('Message-ID', $this->_get_message_id());
$this->set_header('Mime-Version', '1.0');
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Write Headers as a string
*
* @return void
*/
protected function _write_headers()
{
if ($this->protocol === 'mail')
2014-08-08 15:41:59 -04:00
{
if (isset($this->_headers['Subject']))
{
$this->_subject = $this->_headers['Subject'];
unset($this->_headers['Subject']);
}
2014-08-08 15:41:59 -04:00
}
reset($this->_headers);
$this->_header_str = '';
2014-08-08 15:41:59 -04:00
foreach ($this->_headers as $key => $val)
{
$val = trim($val);
if ($val !== '')
2014-08-08 15:41:59 -04:00
{
$this->_header_str .= $key.': '.$val.$this->newline;
2014-08-08 15:41:59 -04:00
}
}
if ($this->_get_protocol() === 'mail')
2014-08-08 15:41:59 -04:00
{
$this->_header_str = rtrim($this->_header_str);
}
}
// --------------------------------------------------------------------
/**
* Build Final Body and attachments
*
* @return bool
2014-08-08 15:41:59 -04:00
*/
protected function _build_message()
{
if ($this->wordwrap === TRUE && $this->mailtype !== 'html')
2014-08-08 15:41:59 -04:00
{
$this->_body = $this->word_wrap($this->_body);
}
$this->_write_headers();
$hdr = ($this->_get_protocol() === 'mail') ? $this->newline : '';
2014-08-08 15:41:59 -04:00
$body = '';
switch ($this->_get_content_type())
{
case 'plain':
2014-08-08 15:41:59 -04:00
$hdr .= 'Content-Type: text/plain; charset='.$this->charset.$this->newline
.'Content-Transfer-Encoding: '.$this->_get_encoding();
2014-08-08 15:41:59 -04:00
if ($this->_get_protocol() === 'mail')
2014-08-08 15:41:59 -04:00
{
$this->_header_str .= $hdr;
2014-08-08 15:41:59 -04:00
$this->_finalbody = $this->_body;
}
else
{
$this->_finalbody = $hdr.$this->newline.$this->newline.$this->_body;
2014-08-08 15:41:59 -04:00
}
return;
case 'html':
2014-08-08 15:41:59 -04:00
if ($this->send_multipart === FALSE)
{
$hdr .= 'Content-Type: text/html; charset='.$this->charset.$this->newline
.'Content-Transfer-Encoding: quoted-printable';
2014-08-08 15:41:59 -04:00
}
else
{
$boundary = uniqid('B_ALT_');
$hdr .= 'Content-Type: multipart/alternative; boundary="'.$boundary.'"';
2014-08-08 15:41:59 -04:00
$body .= $this->_get_mime_message().$this->newline.$this->newline
.'--'.$boundary.$this->newline
2014-08-08 15:41:59 -04:00
.'Content-Type: text/plain; charset='.$this->charset.$this->newline
.'Content-Transfer-Encoding: '.$this->_get_encoding().$this->newline.$this->newline
.$this->_get_alt_message().$this->newline.$this->newline
.'--'.$boundary.$this->newline
2014-08-08 15:41:59 -04:00
.'Content-Type: text/html; charset='.$this->charset.$this->newline
.'Content-Transfer-Encoding: quoted-printable'.$this->newline.$this->newline;
2014-08-08 15:41:59 -04:00
}
$this->_finalbody = $body.$this->_prep_quoted_printable($this->_body).$this->newline.$this->newline;
2014-08-08 15:41:59 -04:00
if ($this->_get_protocol() === 'mail')
2014-08-08 15:41:59 -04:00
{
$this->_header_str .= $hdr;
2014-08-08 15:41:59 -04:00
}
else
{
$this->_finalbody = $hdr.$this->newline.$this->newline.$this->_finalbody;
2014-08-08 15:41:59 -04:00
}
if ($this->send_multipart !== FALSE)
{
$this->_finalbody .= '--'.$boundary.'--';
2014-08-08 15:41:59 -04:00
}
return;
case 'plain-attach':
2014-08-08 15:41:59 -04:00
$boundary = uniqid('B_ATC_');
$hdr .= 'Content-Type: multipart/mixed; boundary="'.$boundary.'"';
2014-08-08 15:41:59 -04:00
if ($this->_get_protocol() === 'mail')
2014-08-08 15:41:59 -04:00
{
$this->_header_str .= $hdr;
2014-08-08 15:41:59 -04:00
}
$body .= $this->_get_mime_message().$this->newline
.$this->newline
.'--'.$boundary.$this->newline
.'Content-Type: text/plain; charset='.$this->charset.$this->newline
.'Content-Transfer-Encoding: '.$this->_get_encoding().$this->newline
.$this->newline
.$this->_body.$this->newline.$this->newline;
2014-08-08 15:41:59 -04:00
$this->_append_attachments($body, $boundary);
2014-08-08 15:41:59 -04:00
break;
case 'html-attach':
2014-08-08 15:41:59 -04:00
$alt_boundary = uniqid('B_ALT_');
$last_boundary = NULL;
2014-08-08 15:41:59 -04:00
if ($this->_attachments_have_multipart('mixed'))
{
$atc_boundary = uniqid('B_ATC_');
$hdr .= 'Content-Type: multipart/mixed; boundary="'.$atc_boundary.'"';
$last_boundary = $atc_boundary;
}
2014-08-08 15:41:59 -04:00
if ($this->_attachments_have_multipart('related'))
2014-08-08 15:41:59 -04:00
{
$rel_boundary = uniqid('B_REL_');
$rel_boundary_header = 'Content-Type: multipart/related; boundary="'.$rel_boundary.'"';
if (isset($last_boundary))
{
$body .= '--'.$last_boundary.$this->newline.$rel_boundary_header;
}
else
{
$hdr .= $rel_boundary_header;
}
$last_boundary = $rel_boundary;
2014-08-08 15:41:59 -04:00
}
if ($this->_get_protocol() === 'mail')
{
$this->_header_str .= $hdr;
}
2014-08-08 15:41:59 -04:00
self::strlen($body) && $body .= $this->newline.$this->newline;
$body .= $this->_get_mime_message().$this->newline.$this->newline
.'--'.$last_boundary.$this->newline
2014-08-08 15:41:59 -04:00
.'Content-Type: multipart/alternative; boundary="'.$alt_boundary.'"'.$this->newline.$this->newline
.'--'.$alt_boundary.$this->newline
2014-08-08 15:41:59 -04:00
.'Content-Type: text/plain; charset='.$this->charset.$this->newline
.'Content-Transfer-Encoding: '.$this->_get_encoding().$this->newline.$this->newline
.$this->_get_alt_message().$this->newline.$this->newline
.'--'.$alt_boundary.$this->newline
2014-08-08 15:41:59 -04:00
.'Content-Type: text/html; charset='.$this->charset.$this->newline
.'Content-Transfer-Encoding: quoted-printable'.$this->newline.$this->newline
2014-08-08 15:41:59 -04:00
.$this->_prep_quoted_printable($this->_body).$this->newline.$this->newline
.'--'.$alt_boundary.'--'.$this->newline.$this->newline;
2014-08-08 15:41:59 -04:00
if ( ! empty($rel_boundary))
{
$body .= $this->newline.$this->newline;
$this->_append_attachments($body, $rel_boundary, 'related');
}
2014-08-08 15:41:59 -04:00
// multipart/mixed attachments
if ( ! empty($atc_boundary))
{
$body .= $this->newline.$this->newline;
$this->_append_attachments($body, $atc_boundary, 'mixed');
}
2014-08-08 15:41:59 -04:00
break;
}
2014-08-08 15:41:59 -04:00
$this->_finalbody = ($this->_get_protocol() === 'mail')
? $body
: $hdr.$this->newline.$this->newline.$body;
2014-08-08 15:41:59 -04:00
return TRUE;
}
2014-08-08 15:41:59 -04:00
// --------------------------------------------------------------------
2014-08-08 15:41:59 -04:00
protected function _attachments_have_multipart($type)
{
foreach ($this->_attachments as &$attachment)
{
if ($attachment['multipart'] === $type)
2014-08-08 15:41:59 -04:00
{
return TRUE;
2014-08-08 15:41:59 -04:00
}
}
return FALSE;
}
2014-08-08 15:41:59 -04:00
// --------------------------------------------------------------------
2014-08-08 15:41:59 -04:00
/**
* Prepares attachment string
*
* @param string $body Message body to append to
* @param string $boundary Multipart boundary
* @param string $multipart When provided, only attachments of this type will be processed
* @return string
*/
protected function _append_attachments(&$body, $boundary, $multipart = null)
{
for ($i = 0, $c = count($this->_attachments); $i < $c; $i++)
2014-08-08 15:41:59 -04:00
{
if (isset($multipart) && $this->_attachments[$i]['multipart'] !== $multipart)
{
continue;
}
$name = isset($this->_attachments[$i]['name'][1])
? $this->_attachments[$i]['name'][1]
: basename($this->_attachments[$i]['name'][0]);
$body .= '--'.$boundary.$this->newline
.'Content-Type: '.$this->_attachments[$i]['type'].'; name="'.$name.'"'.$this->newline
.'Content-Disposition: '.$this->_attachments[$i]['disposition'].';'.$this->newline
.'Content-Transfer-Encoding: base64'.$this->newline
.(empty($this->_attachments[$i]['cid']) ? '' : 'Content-ID: <'.$this->_attachments[$i]['cid'].'>'.$this->newline)
.$this->newline
.$this->_attachments[$i]['content'].$this->newline;
2014-08-08 15:41:59 -04:00
}
// $name won't be set if no attachments were appended,
// and therefore a boundary wouldn't be necessary
empty($name) OR $body .= '--'.$boundary.'--';
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Prep Quoted Printable
*
* Prepares string for Quoted-Printable Content-Transfer-Encoding
* Refer to RFC 2045 http://www.ietf.org/rfc/rfc2045.txt
*
* @param string
* @return string
*/
protected function _prep_quoted_printable($str)
2014-08-08 15:41:59 -04:00
{
// ASCII code numbers for "safe" characters that can always be
// used literally, without encoding, as described in RFC 2049.
// http://www.ietf.org/rfc/rfc2049.txt
static $ascii_safe_chars = array(
// ' ( ) + , - . / : = ?
39, 40, 41, 43, 44, 45, 46, 47, 58, 61, 63,
// numbers
48, 49, 50, 51, 52, 53, 54, 55, 56, 57,
// upper-case letters
65, 66, 67, 68, 69, 70, 71, 72, 73, 74, 75, 76, 77, 78, 79, 80, 81, 82, 83, 84, 85, 86, 87, 88, 89, 90,
// lower-case letters
97, 98, 99, 100, 101, 102, 103, 104, 105, 106, 107, 108, 109, 110, 111, 112, 113, 114, 115, 116, 117, 118, 119, 120, 121, 122
);
// We are intentionally wrapping so mail servers will encode characters
// properly and MUAs will behave, so {unwrap} must go!
$str = str_replace(array('{unwrap}', '{/unwrap}'), '', $str);
// RFC 2045 specifies CRLF as "\r\n".
// However, many developers choose to override that and violate
// the RFC rules due to (apparently) a bug in MS Exchange,
// which only works with "\n".
if ($this->crlf === "\r\n")
2014-08-08 15:41:59 -04:00
{
return quoted_printable_encode($str);
2014-08-08 15:41:59 -04:00
}
// Reduce multiple spaces & remove nulls
$str = preg_replace(array('| +|', '/\x00+/'), array(' ', ''), $str);
2014-08-08 15:41:59 -04:00
// Standardize newlines
if (strpos($str, "\r") !== FALSE)
{
$str = str_replace(array("\r\n", "\r"), "\n", $str);
}
$escape = '=';
$output = '';
foreach (explode("\n", $str) as $line)
2014-08-08 15:41:59 -04:00
{
$length = self::strlen($line);
2014-08-08 15:41:59 -04:00
$temp = '';
// Loop through each character in the line to add soft-wrap
// characters at the end of a line " =\r\n" and add the newly
// processed line(s) to the output (see comment on $crlf class property)
for ($i = 0; $i < $length; $i++)
{
// Grab the next character
$char = $line[$i];
2014-08-08 15:41:59 -04:00
$ascii = ord($char);
// Convert spaces and tabs but only if it's the end of the line
if ($ascii === 32 OR $ascii === 9)
2014-08-08 15:41:59 -04:00
{
if ($i === ($length - 1))
{
$char = $escape.sprintf('%02s', dechex($ascii));
}
2014-08-08 15:41:59 -04:00
}
// DO NOT move this below the $ascii_safe_chars line!
//
// = (equals) signs are allowed by RFC2049, but must be encoded
// as they are the encoding delimiter!
elseif ($ascii === 61)
2014-08-08 15:41:59 -04:00
{
$char = $escape.strtoupper(sprintf('%02s', dechex($ascii))); // =3D
}
elseif ( ! in_array($ascii, $ascii_safe_chars, TRUE))
{
$char = $escape.strtoupper(sprintf('%02s', dechex($ascii)));
}
2014-08-08 15:41:59 -04:00
// If we're at the character limit, add the line to the output,
// reset our temp variable, and keep on chuggin'
if ((self::strlen($temp) + self::strlen($char)) >= 76)
2014-08-08 15:41:59 -04:00
{
$output .= $temp.$escape.$this->crlf;
$temp = '';
}
// Add the character to our temporary line
$temp .= $char;
}
// Add our completed line to the output
$output .= $temp.$this->crlf;
}
// get rid of extra CRLF tacked onto the end
return self::substr($output, 0, self::strlen($this->crlf) * -1);
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Prep Q Encoding
*
* Performs "Q Encoding" on a string for use in email headers.
* It's related but not identical to quoted-printable, so it has its
* own method.
2014-08-08 15:41:59 -04:00
*
* @param string
* @return string
2014-08-08 15:41:59 -04:00
*/
protected function _prep_q_encoding($str)
2014-08-08 15:41:59 -04:00
{
$str = str_replace(array("\r", "\n"), '', $str);
2014-08-08 15:41:59 -04:00
if ($this->charset === 'UTF-8')
2014-08-08 15:41:59 -04:00
{
// Note: We used to have mb_encode_mimeheader() as the first choice
// here, but it turned out to be buggy and unreliable. DO NOT
// re-add it! -- Narf
if (ICONV_ENABLED === TRUE)
{
$output = @iconv_mime_encode('', $str,
array(
'scheme' => 'Q',
'line-length' => 76,
'input-charset' => $this->charset,
'output-charset' => $this->charset,
'line-break-chars' => $this->crlf
)
);
// There are reports that iconv_mime_encode() might fail and return FALSE
if ($output !== FALSE)
{
// iconv_mime_encode() will always put a header field name.
// We've passed it an empty one, but it still prepends our
// encoded string with ': ', so we need to strip it.
return self::substr($output, 2);
}
$chars = iconv_strlen($str, 'UTF-8');
}
elseif (MB_ENABLED === TRUE)
{
$chars = mb_strlen($str, 'UTF-8');
}
2014-08-08 15:41:59 -04:00
}
// We might already have this set for UTF-8
isset($chars) OR $chars = self::strlen($str);
2014-08-08 15:41:59 -04:00
$output = '=?'.$this->charset.'?Q?';
for ($i = 0, $length = self::strlen($output); $i < $chars; $i++)
2014-08-08 15:41:59 -04:00
{
$chr = ($this->charset === 'UTF-8' && ICONV_ENABLED === TRUE)
? '='.implode('=', str_split(strtoupper(bin2hex(iconv_substr($str, $i, 1, $this->charset))), 2))
: '='.strtoupper(bin2hex($str[$i]));
2014-08-08 15:41:59 -04:00
// RFC 2045 sets a limit of 76 characters per line.
// We'll append ?= to the end of each line though.
if ($length + ($l = self::strlen($chr)) > 74)
2014-08-08 15:41:59 -04:00
{
$output .= '?='.$this->crlf // EOL
.' =?'.$this->charset.'?Q?'.$chr; // New line
$length = 6 + self::strlen($this->charset) + $l; // Reset the length for the new line
2014-08-08 15:41:59 -04:00
}
else
2014-08-08 15:41:59 -04:00
{
$output .= $chr;
$length += $l;
2014-08-08 15:41:59 -04:00
}
}
// End the header
return $output.'?=';
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Send Email
*
* @param bool $auto_clear = TRUE
2014-08-08 15:41:59 -04:00
* @return bool
*/
public function send($auto_clear = TRUE)
2014-08-08 15:41:59 -04:00
{
if ( ! isset($this->_headers['From']))
{
$this->_set_error_message('lang:email_no_from');
return FALSE;
}
if ($this->_replyto_flag === FALSE)
2014-08-08 15:41:59 -04:00
{
$this->reply_to($this->_headers['From']);
}
if ( ! isset($this->_recipients) && ! isset($this->_headers['To'])
&& ! isset($this->_bcc_array) && ! isset($this->_headers['Bcc'])
&& ! isset($this->_headers['Cc']))
2014-08-08 15:41:59 -04:00
{
$this->_set_error_message('lang:email_no_recipients');
return FALSE;
}
$this->_build_headers();
if ($this->bcc_batch_mode && count($this->_bcc_array) > $this->bcc_batch_size)
2014-08-08 15:41:59 -04:00
{
$result = $this->batch_bcc_send();
2014-08-08 15:41:59 -04:00
if ($result && $auto_clear)
{
$this->clear();
}
return $result;
}
2014-08-08 15:41:59 -04:00
if ($this->_build_message() === FALSE)
2014-08-08 15:41:59 -04:00
{
return FALSE;
}
$result = $this->_spool_email();
if ($result && $auto_clear)
2014-08-08 15:41:59 -04:00
{
$this->clear();
2014-08-08 15:41:59 -04:00
}
return $result;
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Batch Bcc Send. Sends groups of BCCs in batches
2014-08-08 15:41:59 -04:00
*
* @return void
2014-08-08 15:41:59 -04:00
*/
public function batch_bcc_send()
{
$float = $this->bcc_batch_size - 1;
$set = '';
2014-08-08 15:41:59 -04:00
$chunk = array();
for ($i = 0, $c = count($this->_bcc_array); $i < $c; $i++)
2014-08-08 15:41:59 -04:00
{
if (isset($this->_bcc_array[$i]))
{
$set .= ', '.$this->_bcc_array[$i];
2014-08-08 15:41:59 -04:00
}
if ($i === $float)
2014-08-08 15:41:59 -04:00
{
$chunk[] = self::substr($set, 1);
$float += $this->bcc_batch_size;
$set = '';
2014-08-08 15:41:59 -04:00
}
if ($i === $c-1)
2014-08-08 15:41:59 -04:00
{
$chunk[] = self::substr($set, 1);
2014-08-08 15:41:59 -04:00
}
}
for ($i = 0, $c = count($chunk); $i < $c; $i++)
2014-08-08 15:41:59 -04:00
{
unset($this->_headers['Bcc']);
$bcc = $this->clean_email($this->_str_to_array($chunk[$i]));
2014-08-08 15:41:59 -04:00
if ($this->protocol !== 'smtp')
2014-08-08 15:41:59 -04:00
{
$this->set_header('Bcc', implode(', ', $bcc));
2014-08-08 15:41:59 -04:00
}
else
{
$this->_bcc_array = $bcc;
}
if ($this->_build_message() === FALSE)
{
return FALSE;
}
2014-08-08 15:41:59 -04:00
$this->_spool_email();
}
}
// --------------------------------------------------------------------
/**
* Unwrap special elements
*
* @return void
*/
protected function _unwrap_specials()
{
$this->_finalbody = preg_replace_callback('/\{unwrap\}(.*?)\{\/unwrap\}/si', array($this, '_remove_nl_callback'), $this->_finalbody);
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Strip line-breaks via callback
*
* @param string $matches
2014-08-08 15:41:59 -04:00
* @return string
*/
protected function _remove_nl_callback($matches)
{
if (strpos($matches[1], "\r") !== FALSE OR strpos($matches[1], "\n") !== FALSE)
{
$matches[1] = str_replace(array("\r\n", "\r", "\n"), '', $matches[1]);
}
return $matches[1];
}
// --------------------------------------------------------------------
/**
* Spool mail to the mail server
*
* @return bool
*/
protected function _spool_email()
{
$this->_unwrap_specials();
$protocol = $this->_get_protocol();
$method = '_send_with_'.$protocol;
if ( ! $this->$method())
2014-08-08 15:41:59 -04:00
{
$this->_set_error_message('lang:email_send_failure_'.($protocol === 'mail' ? 'phpmail' : $protocol));
return FALSE;
}
2014-08-08 15:41:59 -04:00
$this->_set_error_message('lang:email_sent', $protocol);
return TRUE;
}
2014-08-08 15:41:59 -04:00
// --------------------------------------------------------------------
2014-08-08 15:41:59 -04:00
/**
* Validate email for shell
*
* Applies stricter, shell-safe validation to email addresses.
* Introduced to prevent RCE via sendmail's -f option.
*
* @see https://github.com/bcit-ci/CodeIgniter/issues/4963
* @see https://gist.github.com/Zenexer/40d02da5e07f151adeaeeaa11af9ab36
* @license https://creativecommons.org/publicdomain/zero/1.0/ CC0 1.0, Public Domain
*
* Credits for the base concept go to Paul Buonopane <paul@namepros.com>
*
* @param string $email
* @return bool
*/
protected function _validate_email_for_shell(&$email)
{
if (function_exists('idn_to_ascii') && strpos($email, '@'))
{
list($account, $domain) = explode('@', $email, 2);
$domain = defined('INTL_IDNA_VARIANT_UTS46')
? idn_to_ascii($domain, 0, INTL_IDNA_VARIANT_UTS46)
: idn_to_ascii($domain);
2014-08-08 15:41:59 -04:00
if ($domain !== FALSE)
{
$email = $account.'@'.$domain;
}
2014-08-08 15:41:59 -04:00
}
return (filter_var($email, FILTER_VALIDATE_EMAIL) === $email && preg_match('#\A[a-z0-9._+-]+@[a-z0-9.-]{1,253}\z#i', $email));
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Send using mail()
*
* @return bool
*/
protected function _send_with_mail()
{
if (is_array($this->_recipients))
2014-08-08 15:41:59 -04:00
{
$this->_recipients = implode(', ', $this->_recipients);
}
// _validate_email_for_shell() below accepts by reference,
// so this needs to be assigned to a variable
$from = $this->clean_email($this->_headers['Return-Path']);
if ($this->_safe_mode === TRUE || ! $this->_validate_email_for_shell($from))
{
return mail($this->_recipients, $this->_subject, $this->_finalbody, $this->_header_str);
2014-08-08 15:41:59 -04:00
}
else
{
// most documentation of sendmail using the "-f" flag lacks a space after it, however
// we've encountered servers that seem to require it to be in place.
return mail($this->_recipients, $this->_subject, $this->_finalbody, $this->_header_str, '-f '.$from);
2014-08-08 15:41:59 -04:00
}
}
// --------------------------------------------------------------------
/**
* Send using Sendmail
*
* @return bool
*/
protected function _send_with_sendmail()
{
// _validate_email_for_shell() below accepts by reference,
// so this needs to be assigned to a variable
$from = $this->clean_email($this->_headers['From']);
if ($this->_validate_email_for_shell($from))
{
$from = '-f '.$from;
}
else
{
$from = '';
}
2014-08-08 15:41:59 -04:00
// is popen() enabled?
if ( ! function_usable('popen') OR FALSE === ($fp = @popen($this->mailpath.' -oi '.$from.' -t', 'w')))
2014-08-08 15:41:59 -04:00
{
// server probably has popen disabled, so nothing we can do to get a verbose error.
return FALSE;
}
fputs($fp, $this->_header_str);
fputs($fp, $this->_finalbody);
$status = pclose($fp);
if ($status !== 0)
2014-08-08 15:41:59 -04:00
{
$this->_set_error_message('lang:email_exit_status', $status);
$this->_set_error_message('lang:email_no_socket');
return FALSE;
}
return TRUE;
}
// --------------------------------------------------------------------
/**
* Send using SMTP
*
* @return bool
*/
protected function _send_with_smtp()
{
if ($this->smtp_host === '')
2014-08-08 15:41:59 -04:00
{
$this->_set_error_message('lang:email_no_hostname');
return FALSE;
}
if ( ! $this->_smtp_connect() OR ! $this->_smtp_authenticate())
{
return FALSE;
}
2014-08-08 15:41:59 -04:00
if ( ! $this->_send_command('from', $this->clean_email($this->_headers['From'])))
{
$this->_smtp_end();
return FALSE;
}
2014-08-08 15:41:59 -04:00
foreach ($this->_recipients as $val)
{
if ( ! $this->_send_command('to', $val))
{
$this->_smtp_end();
return FALSE;
}
2014-08-08 15:41:59 -04:00
}
if (count($this->_cc_array) > 0)
{
foreach ($this->_cc_array as $val)
{
if ($val !== '' && ! $this->_send_command('to', $val))
2014-08-08 15:41:59 -04:00
{
$this->_smtp_end();
return FALSE;
2014-08-08 15:41:59 -04:00
}
}
}
if (count($this->_bcc_array) > 0)
{
foreach ($this->_bcc_array as $val)
{
if ($val !== '' && ! $this->_send_command('to', $val))
2014-08-08 15:41:59 -04:00
{
$this->_smtp_end();
return FALSE;
2014-08-08 15:41:59 -04:00
}
}
}
if ( ! $this->_send_command('data'))
{
$this->_smtp_end();
return FALSE;
}
2014-08-08 15:41:59 -04:00
// perform dot transformation on any lines that begin with a dot
$this->_send_data($this->_header_str.preg_replace('/^\./m', '..$1', $this->_finalbody));
2014-08-08 15:41:59 -04:00
$this->_send_data('.');
$reply = $this->_get_smtp_data();
$this->_set_error_message($reply);
$this->_smtp_end();
if (strpos($reply, '250') !== 0)
2014-08-08 15:41:59 -04:00
{
$this->_set_error_message('lang:email_smtp_error', $reply);
return FALSE;
}
return TRUE;
}
// --------------------------------------------------------------------
/**
* SMTP End
*
* Shortcut to send RSET or QUIT depending on keep-alive
*
* @return void
*/
protected function _smtp_end()
{
($this->smtp_keepalive)
? $this->_send_command('reset')
: $this->_send_command('quit');
}
// --------------------------------------------------------------------
2014-08-08 15:41:59 -04:00
/**
* SMTP Connect
*
* @return string
*/
protected function _smtp_connect()
{
if (is_resource($this->_smtp_connect))
{
return TRUE;
}
$ssl = ($this->smtp_crypto === 'ssl') ? 'ssl://' : '';
2014-08-08 15:41:59 -04:00
$this->_smtp_connect = fsockopen($ssl.$this->smtp_host,
$this->smtp_port,
$errno,
$errstr,
$this->smtp_timeout);
2014-08-08 15:41:59 -04:00
if ( ! is_resource($this->_smtp_connect))
{
$this->_set_error_message('lang:email_smtp_error', $errno.' '.$errstr);
2014-08-08 15:41:59 -04:00
return FALSE;
}
stream_set_timeout($this->_smtp_connect, $this->smtp_timeout);
2014-08-08 15:41:59 -04:00
$this->_set_error_message($this->_get_smtp_data());
if ($this->smtp_crypto === 'tls')
2014-08-08 15:41:59 -04:00
{
$this->_send_command('hello');
$this->_send_command('starttls');
/**
* STREAM_CRYPTO_METHOD_TLS_CLIENT is quite the mess ...
*
* - On PHP <5.6 it doesn't even mean TLS, but SSL 2.0, and there's no option to use actual TLS
* - On PHP 5.6.0-5.6.6, >=7.2 it means negotiation with any of TLS 1.0, 1.1, 1.2
* - On PHP 5.6.7-7.1.* it means only TLS 1.0
*
* We want the negotiation, so we'll force it below ...
*/
$method = is_php('5.6')
? STREAM_CRYPTO_METHOD_TLSv1_0_CLIENT | STREAM_CRYPTO_METHOD_TLSv1_1_CLIENT | STREAM_CRYPTO_METHOD_TLSv1_2_CLIENT
: STREAM_CRYPTO_METHOD_TLS_CLIENT;
$crypto = stream_socket_enable_crypto($this->_smtp_connect, TRUE, $method);
if ($crypto !== TRUE)
{
$this->_set_error_message('lang:email_smtp_error', $this->_get_smtp_data());
return FALSE;
}
2014-08-08 15:41:59 -04:00
}
return $this->_send_command('hello');
}
// --------------------------------------------------------------------
/**
* Send SMTP command
*
* @param string
* @param string
* @return bool
2014-08-08 15:41:59 -04:00
*/
protected function _send_command($cmd, $data = '')
{
switch ($cmd)
{
case 'hello' :
if ($this->_smtp_auth OR $this->_get_encoding() === '8bit')
{
$this->_send_data('EHLO '.$this->_get_hostname());
}
else
{
$this->_send_data('HELO '.$this->_get_hostname());
}
2014-08-08 15:41:59 -04:00
$resp = 250;
break;
case 'starttls' :
$this->_send_data('STARTTLS');
$resp = 220;
break;
case 'from' :
$this->_send_data('MAIL FROM:<'.$data.'>');
$resp = 250;
break;
case 'to' :
2014-08-08 15:41:59 -04:00
if ($this->dsn)
{
$this->_send_data('RCPT TO:<'.$data.'> NOTIFY=SUCCESS,DELAY,FAILURE ORCPT=rfc822;'.$data);
}
else
{
$this->_send_data('RCPT TO:<'.$data.'>');
}
2014-08-08 15:41:59 -04:00
$resp = 250;
break;
case 'data' :
$this->_send_data('DATA');
$resp = 354;
break;
case 'reset':
$this->_send_data('RSET');
$resp = 250;
break;
2014-08-08 15:41:59 -04:00
case 'quit' :
$this->_send_data('QUIT');
$resp = 221;
break;
}
$reply = $this->_get_smtp_data();
$this->_debug_msg[] = '<pre>'.$cmd.': '.$reply.'</pre>';
2014-08-08 15:41:59 -04:00
if ((int) self::substr($reply, 0, 3) !== $resp)
2014-08-08 15:41:59 -04:00
{
$this->_set_error_message('lang:email_smtp_error', $reply);
return FALSE;
}
if ($cmd === 'quit')
2014-08-08 15:41:59 -04:00
{
fclose($this->_smtp_connect);
}
return TRUE;
}
// --------------------------------------------------------------------
/**
* SMTP Authenticate
2014-08-08 15:41:59 -04:00
*
* @return bool
*/
protected function _smtp_authenticate()
{
if ( ! $this->_smtp_auth)
{
return TRUE;
}
if ($this->smtp_user === '' && $this->smtp_pass === '')
2014-08-08 15:41:59 -04:00
{
$this->_set_error_message('lang:email_no_smtp_unpw');
return FALSE;
}
$this->_send_data('AUTH LOGIN');
$reply = $this->_get_smtp_data();
if (strpos($reply, '503') === 0) // Already authenticated
{
return TRUE;
}
elseif (strpos($reply, '334') !== 0)
2014-08-08 15:41:59 -04:00
{
$this->_set_error_message('lang:email_failed_smtp_login', $reply);
return FALSE;
}
$this->_send_data(base64_encode($this->smtp_user));
$reply = $this->_get_smtp_data();
if (strpos($reply, '334') !== 0)
2014-08-08 15:41:59 -04:00
{
$this->_set_error_message('lang:email_smtp_auth_un', $reply);
return FALSE;
}
$this->_send_data(base64_encode($this->smtp_pass));
$reply = $this->_get_smtp_data();
if (strpos($reply, '235') !== 0)
2014-08-08 15:41:59 -04:00
{
$this->_set_error_message('lang:email_smtp_auth_pw', $reply);
return FALSE;
}
if ($this->smtp_keepalive)
{
$this->_smtp_auth = FALSE;
}
2014-08-08 15:41:59 -04:00
return TRUE;
}
// --------------------------------------------------------------------
/**
* Send SMTP data
*
* @param string $data
2014-08-08 15:41:59 -04:00
* @return bool
*/
protected function _send_data($data)
{
$data .= $this->newline;
for ($written = $timestamp = 0, $length = self::strlen($data); $written < $length; $written += $result)
2014-08-08 15:41:59 -04:00
{
if (($result = fwrite($this->_smtp_connect, self::substr($data, $written))) === FALSE)
{
break;
}
// See https://bugs.php.net/bug.php?id=39598 and http://php.net/manual/en/function.fwrite.php#96951
elseif ($result === 0)
{
if ($timestamp === 0)
{
$timestamp = time();
}
elseif ($timestamp < (time() - $this->smtp_timeout))
{
$result = FALSE;
break;
}
usleep(250000);
continue;
}
$timestamp = 0;
2014-08-08 15:41:59 -04:00
}
if ($result === FALSE)
2014-08-08 15:41:59 -04:00
{
$this->_set_error_message('lang:email_smtp_data_failure', $data);
return FALSE;
2014-08-08 15:41:59 -04:00
}
return TRUE;
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Get SMTP data
*
* @return string
*/
protected function _get_smtp_data()
{
$data = '';
2014-08-08 15:41:59 -04:00
while ($str = fgets($this->_smtp_connect, 512))
{
$data .= $str;
if ($str[3] === ' ')
2014-08-08 15:41:59 -04:00
{
break;
}
}
return $data;
}
// --------------------------------------------------------------------
/**
* Get Hostname
*
* There are only two legal types of hostname - either a fully
* qualified domain name (eg: "mail.example.com") or an IP literal
* (eg: "[1.2.3.4]").
2014-08-08 15:41:59 -04:00
*
* @link https://tools.ietf.org/html/rfc5321#section-2.3.5
* @link http://cbl.abuseat.org/namingproblems.html
2014-08-08 15:41:59 -04:00
* @return string
*/
protected function _get_hostname()
2014-08-08 15:41:59 -04:00
{
if (isset($_SERVER['SERVER_NAME']))
2014-08-08 15:41:59 -04:00
{
return $_SERVER['SERVER_NAME'];
2014-08-08 15:41:59 -04:00
}
return isset($_SERVER['SERVER_ADDR']) ? '['.$_SERVER['SERVER_ADDR'].']' : '[127.0.0.1]';
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Get Debug Message
*
* @param array $include List of raw data chunks to include in the output
* Valid options are: 'headers', 'subject', 'body'
2014-08-08 15:41:59 -04:00
* @return string
*/
public function print_debugger($include = array('headers', 'subject', 'body'))
2014-08-08 15:41:59 -04:00
{
$msg = '';
if (count($this->_debug_msg) > 0)
{
foreach ($this->_debug_msg as $val)
{
$msg .= $val;
}
}
// Determine which parts of our raw data needs to be printed
$raw_data = '';
is_array($include) OR $include = array($include);
if (in_array('headers', $include, TRUE))
{
$raw_data = htmlspecialchars($this->_header_str)."\n";
}
if (in_array('subject', $include, TRUE))
{
$raw_data .= htmlspecialchars($this->_subject)."\n";
}
if (in_array('body', $include, TRUE))
{
$raw_data .= htmlspecialchars($this->_finalbody);
}
return $msg.($raw_data === '' ? '' : '<pre>'.$raw_data.'</pre>');
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Set Message
*
* @param string $msg
* @param string $val = ''
* @return void
2014-08-08 15:41:59 -04:00
*/
protected function _set_error_message($msg, $val = '')
{
$CI =& get_instance();
$CI->lang->load('email');
if (sscanf($msg, 'lang:%s', $line) !== 1 OR FALSE === ($line = $CI->lang->line($line)))
2014-08-08 15:41:59 -04:00
{
$this->_debug_msg[] = str_replace('%s', $val, $msg).'<br />';
2014-08-08 15:41:59 -04:00
}
else
{
$this->_debug_msg[] = str_replace('%s', $val, $line).'<br />';
2014-08-08 15:41:59 -04:00
}
}
// --------------------------------------------------------------------
/**
* Mime Types
*
* @param string
* @return string
*/
protected function _mime_types($ext = '')
{
$ext = strtolower($ext);
$mimes =& get_mimes();
if (isset($mimes[$ext]))
{
return is_array($mimes[$ext])
? current($mimes[$ext])
: $mimes[$ext];
}
return 'application/x-unknown-content-type';
}
// --------------------------------------------------------------------
/**
* Destructor
*
* @return void
*/
public function __destruct()
2014-08-08 15:41:59 -04:00
{
is_resource($this->_smtp_connect) && $this->_send_command('quit');
2014-08-08 15:41:59 -04:00
}
// --------------------------------------------------------------------
/**
* Byte-safe strlen()
*
* @param string $str
* @return int
*/
protected static function strlen($str)
{
return (self::$func_overload)
? mb_strlen($str, '8bit')
: strlen($str);
}
// --------------------------------------------------------------------
/**
* Byte-safe substr()
*
* @param string $str
* @param int $start
* @param int $length
* @return string
*/
protected static function substr($str, $start, $length = NULL)
{
if (self::$func_overload)
{
// mb_substr($str, $start, null, '8bit') returns an empty
// string on PHP 5.3
isset($length) OR $length = ($start >= 0 ? self::strlen($str) - $start : -$start);
return mb_substr($str, $start, $length, '8bit');
}
2014-08-08 15:41:59 -04:00
return isset($length)
? substr($str, $start, $length)
: substr($str, $start);
}
}