Subversion-Projekte lars-tiefland.codeigniter

<?php  if ( ! defined('BASEPATH')) exit('No direct script access allowed');

/**

 * CodeIgniter

 *

 * An open source application development framework for PHP 4.3.2 or newer

 *

 * @package		CodeIgniter

 * @author		ExpressionEngine Dev Team

 * @copyright	Copyright (c) 2008, EllisLab, Inc.

 * @license		http://codeigniter.com/user_guide/license.html

 * @link		http://codeigniter.com

 * @since		Version 1.0

 * @filesource

 */

// ------------------------------------------------------------------------

/**

 * CodeIgniter Email Class

 *

 * Permits email to be sent using Mail, Sendmail, or SMTP.

 *

 * @package		CodeIgniter

 * @subpackage	Libraries

 * @category	Libraries

 * @author		ExpressionEngine Dev Team

 * @link		http://codeigniter.com/user_guide/libraries/email.html

 */

class CI_Email {

	var	$useragent		= "CodeIgniter";

	var	$mailpath		= "/usr/sbin/sendmail";	// Sendmail path

	var	$protocol		= "mail";	// mail/sendmail/smtp

	var	$smtp_host		= "";		// SMTP Server.  Example: mail.earthlink.net

	var	$smtp_user		= "";		// SMTP Username

	var	$smtp_pass		= "";		// SMTP Password

	var	$smtp_port		= "25";		// SMTP Port

	var	$smtp_timeout	= 5;		// SMTP Timeout in seconds

	var	$wordwrap		= TRUE;		// TRUE/FALSE  Turns word-wrap on/off

	var	$wrapchars		= "76";		// Number of characters to wrap at.

	var	$mailtype		= "text";	// text/html  Defines email formatting

	var	$charset		= "utf-8";	// Default char set: iso-8859-1 or us-ascii

	var	$multipart		= "mixed";	// "mixed" (in the body) or "related" (separate)

	var $alt_message	= '';		// Alternative message for HTML emails

	var	$validate		= FALSE;	// TRUE/FALSE.  Enables email validation

	var	$priority		= "3";		// Default priority (1 - 5)

	var	$newline		= "\n";		// Default newline. "\r\n" or "\n" (Use "\r\n" to comply with RFC 822)

	var $crlf			= "\n";		// The RFC 2045 compliant CRLF for quoted-printable is "\r\n".  Apparently some servers,

									// even on the receiving end think they need to muck with CRLFs, so using "\n", while

									// distasteful, is the only thing that seems to work for all environments.

	var $send_multipart	= TRUE;		// TRUE/FALSE - Yahoo does not like multipart alternative, so this is an override.  Set to FALSE for Yahoo.

	var	$bcc_batch_mode	= FALSE;	// TRUE/FALSE  Turns on/off Bcc batch feature

	var	$bcc_batch_size	= 200;		// If bcc_batch_mode = TRUE, sets max number of Bccs in each batch

	var $_safe_mode		= FALSE;

	var	$_subject		= "";

	var	$_body			= "";

	var	$_finalbody		= "";

	var	$_alt_boundary	= "";

	var	$_atc_boundary	= "";

	var	$_header_str	= "";

	var	$_smtp_connect	= "";

	var	$_encoding		= "8bit";

	var $_IP			= FALSE;

	var	$_smtp_auth		= FALSE;

	var $_replyto_flag	= FALSE;

	var	$_debug_msg		= array();

	var	$_recipients	= array();

	var	$_cc_array		= array();

	var	$_bcc_array		= array();

	var	$_headers		= array();

	var	$_attach_name	= array();

	var	$_attach_type	= array();

	var	$_attach_disp	= array();

	var	$_protocols		= array('mail', 'sendmail', 'smtp');

	var	$_base_charsets	= array('us-ascii', 'iso-2022-');	// 7-bit charsets (excluding language suffix)

	var	$_bit_depths	= array('7bit', '8bit');

	var	$_priorities	= array('1 (Highest)', '2 (High)', '3 (Normal)', '4 (Low)', '5 (Lowest)');

	/**

	 * Constructor - Sets Email Preferences

	 *

	 * The constructor can be passed an array of config values

	 */

	function CI_Email($config = array())

	{

		if (count($config) > 0)

		{

			$this->initialize($config);

		}

		else

		{

			$this->_smtp_auth = ($this->smtp_user == '' AND $this->smtp_pass == '') ? FALSE : TRUE;

			$this->_safe_mode = ((boolean)@ini_get("safe_mode") === FALSE) ? FALSE : TRUE;

		}

		log_message('debug', "Email Class Initialized");

	}

	// --------------------------------------------------------------------

	/**

	 * Initialize preferences

	 *

	 * @access	public

	 * @param	array

	 * @return	void

	 */

	function initialize($config = array())

	{

		$this->clear();

		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->_smtp_auth = ($this->smtp_user == '' AND $this->smtp_pass == '') ? FALSE : TRUE;

		$this->_safe_mode = ((boolean)@ini_get("safe_mode") === FALSE) ? FALSE : TRUE;

	}

	// --------------------------------------------------------------------

	/**

	 * Initialize the Email Data

	 *

	 * @access	public

	 * @return	void

	 */

	function clear($clear_attachments = FALSE)

	{

		$this->_subject		= "";

		$this->_body		= "";

		$this->_finalbody	= "";

		$this->_header_str	= "";

		$this->_replyto_flag = FALSE;

		$this->_recipients	= array();

		$this->_headers		= array();

		$this->_debug_msg	= array();

		$this->_set_header('User-Agent', $this->useragent);

		$this->_set_header('Date', $this->_set_date());

		if ($clear_attachments !== FALSE)

		{

			$this->_attach_name = array();

			$this->_attach_type = array();

			$this->_attach_disp = array();

		}

	}

	// --------------------------------------------------------------------

	/**

	 * Set FROM

	 *

	 * @access	public

	 * @param	string

	 * @param	string

	 * @return	void

	 */

	function from($from, $name = '')

	{

		if (preg_match( '/\<(.*)\>/', $from, $match))

		{

			$from = $match['1'];

		}

		if ($this->validate)

		{

			$this->validate_email($this->_str_to_array($from));

		}

		// prepare the display name

		if ($name != '')

		{

			// 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, TRUE);

			}

		}

		$this->_set_header('From', $name.' <'.$from.'>');

		$this->_set_header('Return-Path', '<'.$from.'>');

	}

	// --------------------------------------------------------------------

	/**

	 * Set Reply-to

	 *

	 * @access	public

	 * @param	string

	 * @param	string

	 * @return	void

	 */

	function reply_to($replyto, $name = '')

	{

		if (preg_match( '/\<(.*)\>/', $replyto, $match))

		{

			$replyto = $match['1'];

		}

		if ($this->validate)

		{

			$this->validate_email($this->_str_to_array($replyto));

		}

		if ($name == '')

		{

			$name = $replyto;

		}

		if (strncmp($name, '"', 1) != 0)

		{

			$name = '"'.$name.'"';

		}

		$this->_set_header('Reply-To', $name.' <'.$replyto.'>');

		$this->_replyto_flag = TRUE;

	}

	// --------------------------------------------------------------------

	/**

	 * Set Recipients

	 *

	 * @access	public

	 * @param	string

	 * @return	void

	 */

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

		{

			$this->_set_header('To', implode(", ", $to));

		}

		switch ($this->_get_protocol())

		{

			case 'smtp'		: $this->_recipients = $to;

			break;

			case 'sendmail'	: $this->_recipients = implode(", ", $to);

			break;

			case 'mail'		: $this->_recipients = implode(", ", $to);

			break;

		}

	}

	// --------------------------------------------------------------------

	/**

	 * Set CC

	 *

	 * @access	public

	 * @param	string

	 * @return	void

	 */

	function cc($cc)

	{

		$cc = $this->_str_to_array($cc);

		$cc = $this->clean_email($cc);

		if ($this->validate)

		{

			$this->validate_email($cc);

		}

		$this->_set_header('Cc', implode(", ", $cc));

		if ($this->_get_protocol() == "smtp")

		{

			$this->_cc_array = $cc;

		}

	}

	// --------------------------------------------------------------------

	/**

	 * Set BCC

	 *

	 * @access	public

	 * @param	string

	 * @param	string

	 * @return	void

	 */

	function bcc($bcc, $limit = '')

	{

		if ($limit != '' && is_numeric($limit))

		{

			$this->bcc_batch_mode = TRUE;

			$this->bcc_batch_size = $limit;

		}

		$bcc = $this->_str_to_array($bcc);

		$bcc = $this->clean_email($bcc);

		if ($this->validate)

		{

			$this->validate_email($bcc);

		}

		if (($this->_get_protocol() == "smtp") OR ($this->bcc_batch_mode && count($bcc) > $this->bcc_batch_size))

		{

			$this->_bcc_array = $bcc;

		}

		else

		{

			$this->_set_header('Bcc', implode(", ", $bcc));

		}

	}

	// --------------------------------------------------------------------

	/**

	 * Set Email Subject

	 *

	 * @access	public

	 * @param	string

	 * @return	void

	 */

	function subject($subject)

	{

		$subject = $this->_prep_q_encoding($subject);

		$this->_set_header('Subject', $subject);

	}

	// --------------------------------------------------------------------

	/**

	 * Set Body

	 *

	 * @access	public

	 * @param	string

	 * @return	void

	 */

	function message($body)

	{

		$this->_body = stripslashes(rtrim(str_replace("\r", "", $body)));

	}

	// --------------------------------------------------------------------

	/**

	 * Assign file attachments

	 *

	 * @access	public

	 * @param	string

	 * @return	void

	 */

	function attach($filename, $disposition = 'attachment')

	{

		$this->_attach_name[] = $filename;

		$this->_attach_type[] = $this->_mime_types(next(explode('.', basename($filename))));

		$this->_attach_disp[] = $disposition; // Can also be 'inline'  Not sure if it matters

	}

	// --------------------------------------------------------------------

	/**

	 * Add a Header Item

	 *

	 * @access	private

	 * @param	string

	 * @param	string

	 * @return	void

	 */

	function _set_header($header, $value)

	{

		$this->_headers[$header] = $value;

	}

	// --------------------------------------------------------------------

	/**

	 * Convert a String to an Array

	 *

	 * @access	private

	 * @param	string

	 * @return	array

	 */

	function _str_to_array($email)

	{

		if ( ! is_array($email))

		{

			if (strpos($email, ',') !== FALSE)

			{

				$email = preg_split('/[\s,]/', $email, -1, PREG_SPLIT_NO_EMPTY);

			}

			else

			{

				$email = trim($email);

				settype($email, "array");

			}

		}

		return $email;

	}

	// --------------------------------------------------------------------

	/**

	 * Set Multipart Value

	 *

	 * @access	public

	 * @param	string

	 * @return	void

	 */

	function set_alt_message($str = '')

	{

		$this->alt_message = ($str == '') ? '' : $str;

	}

	// --------------------------------------------------------------------

	/**

	 * Set Mailtype

	 *

	 * @access	public

	 * @param	string

	 * @return	void

	 */

	function set_mailtype($type = 'text')

	{

		$this->mailtype = ($type == 'html') ? 'html' : 'text';

	}

	// --------------------------------------------------------------------

	/**

	 * Set Wordwrap

	 *

	 * @access	public

	 * @param	string

	 * @return	void

	 */

	function set_wordwrap($wordwrap = TRUE)

	{

		$this->wordwrap = ($wordwrap === FALSE) ? FALSE : TRUE;

	}

	// --------------------------------------------------------------------

	/**

	 * Set Protocol

	 *

	 * @access	public

	 * @param	string

	 * @return	void

	 */

	function set_protocol($protocol = 'mail')

	{

		$this->protocol = ( ! in_array($protocol, $this->_protocols, TRUE)) ? 'mail' : strtolower($protocol);

	}

	// --------------------------------------------------------------------

	/**

	 * Set Priority

	 *

	 * @access	public

	 * @param	integer

	 * @return	void

	 */

	function set_priority($n = 3)

	{

		if ( ! is_numeric($n))

		{

			$this->priority = 3;

			return;

		}

		if ($n < 1 OR $n > 5)

		{

			$this->priority = 3;

			return;

		}

		$this->priority = $n;

	}

	// --------------------------------------------------------------------

	/**

	 * Set Newline Character

	 *

	 * @access	public

	 * @param	string

	 * @return	void

	 */

	function set_newline($newline = "\n")

	{

		if ($newline != "\n" AND $newline != "\r\n" AND $newline != "\r")

		{

			$this->newline	= "\n";

			return;

		}

		$this->newline	= $newline;

	}

	// --------------------------------------------------------------------

	/**

	 * Set CRLF

	 *

	 * @access	public

	 * @param	string

	 * @return	void

	 */

	function set_crlf($crlf = "\n")

	{

		if ($crlf != "\n" AND $crlf != "\r\n" AND $crlf != "\r")

		{

			$this->crlf	= "\n";

			return;

		}

		$this->crlf	= $crlf;

	}

	// --------------------------------------------------------------------

	/**

	 * Set Message Boundary

	 *

	 * @access	private

	 * @return	void

	 */

	function _set_boundaries()

	{

		$this->_alt_boundary = "B_ALT_".uniqid(''); // multipart/alternative

		$this->_atc_boundary = "B_ATC_".uniqid(''); // attachment boundary

	}

	// --------------------------------------------------------------------

	/**

	 * Get the Message ID

	 *

	 * @access	private

	 * @return	string

	 */

	function _get_message_id()

	{

		$from = $this->_headers['Return-Path'];

		$from = str_replace(">", "", $from);

		$from = str_replace("<", "", $from);

		return  "<".uniqid('').strstr($from, '@').">";

	}

	// --------------------------------------------------------------------

	/**

	 * Get Mail Protocol

	 *

	 * @access	private

	 * @param	bool

	 * @return	string

	 */

	function _get_protocol($return = TRUE)

	{

		$this->protocol = strtolower($this->protocol);

		$this->protocol = ( ! in_array($this->protocol, $this->_protocols, TRUE)) ? 'mail' : $this->protocol;

		if ($return == TRUE)

		{

			return $this->protocol;

		}

	}

	// --------------------------------------------------------------------

	/**

	 * Get Mail Encoding

	 *

	 * @access	private

	 * @param	bool

	 * @return	string

	 */

	function _get_encoding($return = TRUE)

	{

		$this->_encoding = ( ! in_array($this->_encoding, $this->_bit_depths)) ? '8bit' : $this->_encoding;

		foreach ($this->_base_charsets as $charset)

		{

			if (strncmp($charset, $this->charset, strlen($charset)) == 0)

			{

				$this->_encoding = '7bit';

			}

		}

		if ($return == TRUE)

		{

			return $this->_encoding;

		}

	}

	// --------------------------------------------------------------------

	/**

	 * Get content type (text/html/attachment)

	 *

	 * @access	private

	 * @return	string

	 */

	function _get_content_type()

	{

		if	($this->mailtype == 'html' &&  count($this->_attach_name) == 0)

		{

			return 'html';

		}

		elseif	($this->mailtype == 'html' &&  count($this->_attach_name)  > 0)

		{

			return 'html-attach';

		}

		elseif	($this->mailtype == 'text' &&  count($this->_attach_name)  > 0)

		{

			return 'plain-attach';

		}

		else

		{

			return 'plain';

		}

	}

	// --------------------------------------------------------------------

	/**

	 * Set RFC 822 Date

	 *

	 * @access	private

	 * @return	string

	 */

	function _set_date()

	{

		$timezone = date("Z");

		$operator = (strncmp($timezone, '-', 1) == 0) ? '-' : '+';

		$timezone = abs($timezone);

		$timezone = floor($timezone/3600) * 100 + ($timezone % 3600 ) / 60;

		return sprintf("%s %s%04d", date("D, j M Y H:i:s"), $operator, $timezone);

	}

	// --------------------------------------------------------------------

	/**

	 * Mime message

	 *

	 * @access	private

	 * @return	string

	 */

	function _get_mime_message()

	{

		return "This is a multi-part message in MIME format.".$this->newline."Your email application may not support this format.";

	}

	// --------------------------------------------------------------------

	/**

	 * Validate Email Address

	 *

	 * @access	public

	 * @param	string

	 * @return	bool

	 */

	function validate_email($email)

	{

		if ( ! is_array($email))

		{

			$this->_set_error_message('email_must_be_array');

			return FALSE;

		}

		foreach ($email as $val)

		{

			if ( ! $this->valid_email($val))

			{

				$this->_set_error_message('email_invalid_address', $val);

				return FALSE;

			}

		}

		return TRUE;

	}

	// --------------------------------------------------------------------

	/**

	 * Email Validation

	 *

	 * @access	public

	 * @param	string

	 * @return	bool

	 */

	function valid_email($address)

	{

		return ( ! preg_match("/^([a-z0-9\+_\-]+)(\.[a-z0-9\+_\-]+)*@([a-z0-9\-]+\.)+[a-z]{2,6}$/ix", $address)) ? FALSE : TRUE;

	}

	// --------------------------------------------------------------------

	/**

	 * Clean Extended Email Address: Joe Smith <joe@smith.com>

	 *

	 * @access	public

	 * @param	string

	 * @return	string

	 */

	function clean_email($email)

	{

		if ( ! is_array($email))

		{

			if (preg_match('/\<(.*)\>/', $email, $match))

			{

		   		return $match['1'];

			}

		   	else

			{

		   		return $email;

			}

		}

		$clean_email = array();

		foreach ($email as $addy)

		{

			if (preg_match( '/\<(.*)\>/', $addy, $match))

			{

		   		$clean_email[] = $match['1'];

			}

		   	else

			{

		   		$clean_email[] = $addy;

			}

		}

		return $clean_email;

	}

	// --------------------------------------------------------------------

	/**

	 * Build alternative plain text message

	 *

	 * This function provides the raw message for use

	 * in plain-text headers of HTML-formatted emails.

	 * If the user hasn't specified his own alternative message

	 * it creates one by stripping the HTML

	 *

	 * @access	private

	 * @return	string

	 */

	function _get_alt_message()

	{

		if ($this->alt_message != "")

		{

			return $this->word_wrap($this->alt_message, '76');

		}

		if (preg_match('/\<body.*?\>(.*)\<\/body\>/si', $this->_body, $match))

		{

			$body = $match['1'];

		}

		else

		{

			$body = $this->_body;

		}

		$body = trim(strip_tags($body));

		$body = preg_replace( '#<!--(.*)--\>#', "", $body);

		$body = str_replace("\t", "", $body);

		for ($i = 20; $i >= 3; $i--)

		{

			$n = "";

			for ($x = 1; $x <= $i; $x ++)

			{

				 $n .= "\n";

			}

			$body = str_replace($n, "\n\n", $body);

		}

		return $this->word_wrap($body, '76');

	}

	// --------------------------------------------------------------------

	/**

	 * Word Wrap

	 *

	 * @access	public

	 * @param	string

	 * @param	integer

	 * @return	string

	 */

	function word_wrap($str, $charlim = '')

	{

		// Se the character limit

		if ($charlim == '')

		{

			$charlim = ($this->wrapchars == "") ? "76" : $this->wrapchars;

		}

		// Reduce multiple spaces

		$str = preg_replace("| +|", " ", $str);

		// Standardize newlines

		if (strpos($str, "\r") !== FALSE)

		{

			$str = str_replace(array("\r\n", "\r"), "\n", $str);

		}

		// 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))

		{

			for ($i = 0; $i < count($matches['0']); $i++)

			{

				$unwrap[] = $matches['1'][$i];

				$str = str_replace($matches['1'][$i], "{{unwrapped".$i."}}", $str);

			}

		}

		// Use PHP's native function to do the initial wordwrap.

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

		$str = wordwrap($str, $charlim, "\n", FALSE);

		// Split the string into individual lines of text and cycle through them

		$output = "";

		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 (strlen($line) <= $charlim)

			{

				$output .= $line.$this->newline;

				continue;

			}

			$temp = '';

			while((strlen($line)) > $charlim)

			{

				// If the over-length word is a URL we won't wrap it

				if (preg_match("!\[url.+\]|://|wwww.!", $line))

				{

					break;

				}

				// Trim the word down

				$temp .= substr($line, 0, $charlim-1);

				$line = substr($line, $charlim-1);

			}

			// 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 != '')

			{

				$output .= $temp.$this->newline.$line;

			}

			else

			{

				$output .= $line;

			}

			$output .= $this->newline;

		}

		// Put our markers back

		if (count($unwrap) > 0)

		{

			foreach ($unwrap as $key => $val)

			{

				$output = str_replace("{{unwrapped".$key."}}", $val, $output);

			}

		}

		return $output;

	}

	// --------------------------------------------------------------------

	/**

	 * Build final headers

	 *

	 * @access	private

	 * @param	string

	 * @return	string

	 */

	function _build_headers()

	{

		$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 - 1]);

		$this->_set_header('Message-ID', $this->_get_message_id());

		$this->_set_header('Mime-Version', '1.0');

	}

	// --------------------------------------------------------------------

	/**

	 * Write Headers as a string

	 *

	 * @access	private

	 * @return	void

	 */

	function _write_headers()

	{

		if ($this->protocol == 'mail')

		{

			$this->_subject = $this->_headers['Subject'];

			unset($this->_headers['Subject']);

		}

		reset($this->_headers);

		$this->_header_str = "";

		foreach($this->_headers as $key => $val)

		{

			$val = trim($val);

			if ($val != "")

			{

				$this->_header_str .= $key.": ".$val.$this->newline;

			}

		}

		if ($this->_get_protocol() == 'mail')

		{

			$this->_header_str = rtrim($this->_header_str);

		}

	}

	// --------------------------------------------------------------------

	/**

	 * Build Final Body and attachments

	 *

	 * @access	private

	 * @return	void

	 */

	function _build_message()

	{

		if ($this->wordwrap === TRUE  AND  $this->mailtype != 'html')

		{

			$this->_body = $this->word_wrap($this->_body);

		}

		$this->_set_boundaries();

		$this->_write_headers();

		$hdr = ($this->_get_protocol() == 'mail') ? $this->newline : '';

		switch ($this->_get_content_type())

		{

			case 'plain' :

				$hdr .= "Content-Type: text/plain; charset=" . $this->charset . $this->newline;

				$hdr .= "Content-Transfer-Encoding: " . $this->_get_encoding();

				if ($this->_get_protocol() == 'mail')

				{

					$this->_header_str .= $hdr;

					$this->_finalbody = $this->_body;

					return;

				}

				$hdr .= $this->newline . $this->newline . $this->_body;

				$this->_finalbody = $hdr;

				return;

			break;