diff options
Diffstat (limited to 'Postman/Postman-Mail/Zend-1.12.10/Mail.php')
| -rw-r--r-- | Postman/Postman-Mail/Zend-1.12.10/Mail.php | 1291 |
1 files changed, 0 insertions, 1291 deletions
diff --git a/Postman/Postman-Mail/Zend-1.12.10/Mail.php b/Postman/Postman-Mail/Zend-1.12.10/Mail.php deleted file mode 100644 index 702add0..0000000 --- a/Postman/Postman-Mail/Zend-1.12.10/Mail.php +++ /dev/null @@ -1,1291 +0,0 @@ -<?php -/** - * Zend Framework - * - * LICENSE - * - * This source file is subject to the new BSD license that is bundled - * with this package in the file LICENSE.txt. - * It is also available through the world-wide-web at this URL: - * http://framework.zend.com/license/new-bsd - * If you did not receive a copy of the license and are unable to - * obtain it through the world-wide-web, please send an email - * to license@zend.com so we can send you a copy immediately. - * - * @category Zend - * @package Postman_Zend_Mail - * @copyright Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com) - * @license http://framework.zend.com/license/new-bsd New BSD License - * @version $Id$ - */ - - -/** - * @see Postman_Zend_Mail_Transport_Abstract - */ -// require_once 'Zend/Mail/Transport/Abstract.php'; - -/** - * @see Postman_Zend_Mime - */ -// require_once 'Zend/Mime.php'; - -/** - * @see Postman_Zend_Mime_Message - */ -// require_once 'Zend/Mime/Message.php'; - -/** - * @see Postman_Zend_Mime_Part - */ -// require_once 'Zend/Mime/Part.php'; - - -/** - * Class for sending an email. - * - * @category Zend - * @package Postman_Zend_Mail - * @copyright Copyright (c) 2005-2015 Zend Technologies USA Inc. (http://www.zend.com) - * @license http://framework.zend.com/license/new-bsd New BSD License - */ -class Postman_Zend_Mail extends Postman_Zend_Mime_Message -{ - /**#@+ - * @access protected - */ - - /** - * @var Postman_Zend_Mail_Transport_Abstract - * @static - */ - protected static $_defaultTransport = null; - - /** - * @var array - * @static - */ - protected static $_defaultFrom; - - /** - * @var array - * @static - */ - protected static $_defaultReplyTo; - - /** - * Mail character set - * @var string - */ - protected $_charset = 'iso-8859-1'; - - /** - * Mail headers - * @var array - */ - protected $_headers = array(); - - /** - * Encoding of Mail headers - * @var string - */ - protected $_headerEncoding = Postman_Zend_Mime::ENCODING_QUOTEDPRINTABLE; - - /** - * From: address - * @var string - */ - protected $_from = null; - - /** - * To: addresses - * @var array - */ - protected $_to = array(); - - /** - * Array of all recipients - * @var array - */ - protected $_recipients = array(); - - /** - * Reply-To header - * @var string - */ - protected $_replyTo = null; - - /** - * Return-Path header - * @var string - */ - protected $_returnPath = null; - - /** - * Subject: header - * @var string - */ - protected $_subject = null; - - /** - * Date: header - * @var string - */ - protected $_date = null; - - /** - * Message-ID: header - * @var string - */ - protected $_messageId = null; - - /** - * text/plain MIME part - * @var false|Postman_Zend_Mime_Part - */ - protected $_bodyText = false; - - /** - * text/html MIME part - * @var false|Postman_Zend_Mime_Part - */ - protected $_bodyHtml = false; - - /** - * MIME boundary string - * @var string - */ - protected $_mimeBoundary = null; - - /** - * Content type of the message - * @var string - */ - protected $_type = null; - - /**#@-*/ - - /** - * Flag: whether or not email has attachments - * @var boolean - */ - public $hasAttachments = false; - - - /** - * Sets the default mail transport for all following uses of - * Postman_Zend_Mail::send(); - * - * @todo Allow passing a string to indicate the transport to load - * @todo Allow passing in optional options for the transport to load - * @param Postman_Zend_Mail_Transport_Abstract $transport - */ - public static function setDefaultTransport(Postman_Zend_Mail_Transport_Abstract $transport) - { - self::$_defaultTransport = $transport; - } - - /** - * Gets the default mail transport for all following uses of - * unittests - * - * @todo Allow passing a string to indicate the transport to load - * @todo Allow passing in optional options for the transport to load - */ - public static function getDefaultTransport() - { - return self::$_defaultTransport; - } - - /** - * Clear the default transport property - */ - public static function clearDefaultTransport() - { - self::$_defaultTransport = null; - } - - /** - * Public constructor - * - * @param string $charset - * @return void - */ - public function __construct($charset = null) - { - if ($charset != null) { - $this->_charset = $charset; - } - } - - /** - * Return charset string - * - * @return string - */ - public function getCharset() - { - return $this->_charset; - } - - /** - * Set content type - * - * Should only be used for manually setting multipart content types. - * - * @param string $type Content type - * @return Postman_Zend_Mail Implements fluent interface - * @throws Postman_Zend_Mail_Exception for types not supported by Postman_Zend_Mime - */ - public function setType($type) - { - $allowed = array( - Postman_Zend_Mime::MULTIPART_ALTERNATIVE, - Postman_Zend_Mime::MULTIPART_MIXED, - Postman_Zend_Mime::MULTIPART_RELATED, - ); - if (!in_array($type, $allowed)) { - /** - * @see Postman_Zend_Mail_Exception - */ -// require_once 'Zend/Mail/Exception.php'; - throw new Postman_Zend_Mail_Exception('Invalid content type "' . $type . '"'); - } - - $this->_type = $type; - return $this; - } - - /** - * Get content type of the message - * - * @return string - */ - public function getType() - { - return $this->_type; - } - - /** - * Set an arbitrary mime boundary for the message - * - * If not set, Postman_Zend_Mime will generate one. - * - * @param string $boundary - * @return Postman_Zend_Mail Provides fluent interface - */ - public function setMimeBoundary($boundary) - { - $this->_mimeBoundary = $boundary; - - return $this; - } - - /** - * Return the boundary string used for the message - * - * @return string - */ - public function getMimeBoundary() - { - return $this->_mimeBoundary; - } - - /** - * Return encoding of mail headers - * - * @deprecated use {@link getHeaderEncoding()} instead - * @return string - */ - public function getEncodingOfHeaders() - { - return $this->getHeaderEncoding(); - } - - /** - * Return the encoding of mail headers - * - * Either Postman_Zend_Mime::ENCODING_QUOTEDPRINTABLE or Postman_Zend_Mime::ENCODING_BASE64 - * - * @return string - */ - public function getHeaderEncoding() - { - return $this->_headerEncoding; - } - - /** - * Set the encoding of mail headers - * - * @deprecated Use {@link setHeaderEncoding()} instead. - * @param string $encoding - * @return Postman_Zend_Mail - */ - public function setEncodingOfHeaders($encoding) - { - return $this->setHeaderEncoding($encoding); - } - - /** - * Set the encoding of mail headers - * - * @param string $encoding Postman_Zend_Mime::ENCODING_QUOTEDPRINTABLE or Postman_Zend_Mime::ENCODING_BASE64 - * @return Postman_Zend_Mail Provides fluent interface - */ - public function setHeaderEncoding($encoding) - { - $allowed = array( - Postman_Zend_Mime::ENCODING_BASE64, - Postman_Zend_Mime::ENCODING_QUOTEDPRINTABLE - ); - if (!in_array($encoding, $allowed)) { - /** - * @see Postman_Zend_Mail_Exception - */ -// require_once 'Zend/Mail/Exception.php'; - throw new Postman_Zend_Mail_Exception('Invalid encoding "' . $encoding . '"'); - } - $this->_headerEncoding = $encoding; - - return $this; - } - - /** - * Sets the text body for the message. - * - * @param string $txt - * @param string $charset - * @param string $encoding - * @return Postman_Zend_Mail Provides fluent interface - */ - public function setBodyText($txt, $charset = null, $encoding = Postman_Zend_Mime::ENCODING_QUOTEDPRINTABLE) - { - if ($charset === null) { - $charset = $this->_charset; - } - - $mp = new Postman_Zend_Mime_Part($txt); - $mp->encoding = apply_filters( 'post_smtp_content_transfer_encoding', $encoding, Postman_Zend_Mime::TYPE_TEXT); - $mp->type = Postman_Zend_Mime::TYPE_TEXT; - $mp->disposition = Postman_Zend_Mime::DISPOSITION_INLINE; - $mp->charset = $charset; - - $this->_bodyText = $mp; - - return $this; - } - - /** - * Return text body Postman_Zend_Mime_Part or string - * - * @param bool textOnly Whether to return just the body text content or the MIME part; defaults to false, the MIME part - * @return false|Postman_Zend_Mime_Part|string - */ - public function getBodyText($textOnly = false) - { - if ($textOnly && $this->_bodyText) { - $body = $this->_bodyText; - return $body->getContent(); - } - - return $this->_bodyText; - } - - /** - * Sets the HTML body for the message - * - * @param string $html - * @param string $charset - * @param string $encoding - * @return Postman_Zend_Mail Provides fluent interface - */ - public function setBodyHtml($html, $charset = null, $encoding = Postman_Zend_Mime::ENCODING_QUOTEDPRINTABLE) - { - if ($charset === null) { - $charset = $this->_charset; - } - - $mp = new Postman_Zend_Mime_Part($html); - $mp->encoding = apply_filters( 'post_smtp_content_transfer_encoding', $encoding, Postman_Zend_Mime::TYPE_HTML ); - $mp->type = Postman_Zend_Mime::TYPE_HTML; - $mp->disposition = Postman_Zend_Mime::DISPOSITION_INLINE; - $mp->charset = $charset; - - $this->_bodyHtml = $mp; - - return $this; - } - - /** - * Return Postman_Zend_Mime_Part representing body HTML - * - * @param bool $htmlOnly Whether to return the body HTML only, or the MIME part; defaults to false, the MIME part - * @return false|Postman_Zend_Mime_Part|string - */ - public function getBodyHtml($htmlOnly = false) - { - if ($htmlOnly && $this->_bodyHtml) { - $body = $this->_bodyHtml; - return $body->getContent(); - } - - return $this->_bodyHtml; - } - - /** - * Adds an existing attachment to the mail message - * - * @param Postman_Zend_Mime_Part $attachment - * @return Postman_Zend_Mail Provides fluent interface - */ - public function addAttachment(Postman_Zend_Mime_Part $attachment) - { - $this->addPart($attachment); - $this->hasAttachments = true; - - return $this; - } - - /** - * Creates a Postman_Zend_Mime_Part attachment - * - * Attachment is automatically added to the mail object after creation. The - * attachment object is returned to allow for further manipulation. - * - * @param string $body - * @param string $mimeType - * @param string $disposition - * @param string $encoding - * @param string $filename OPTIONAL A filename for the attachment - * @return Postman_Zend_Mime_Part Newly created Postman_Zend_Mime_Part object (to allow - * advanced settings) - */ - public function createAttachment($body, - $mimeType = Postman_Zend_Mime::TYPE_OCTETSTREAM, - $disposition = Postman_Zend_Mime::DISPOSITION_ATTACHMENT, - $encoding = Postman_Zend_Mime::ENCODING_BASE64, - $filename = null) - { - - $mp = new Postman_Zend_Mime_Part($body); - $mp->encoding = $encoding; - $mp->type = $mimeType; - $mp->disposition = $disposition; - $mp->filename = $filename; - - $this->addAttachment($mp); - - return $mp; - } - - /** - * Return a count of message parts - * - * @return integer - */ - public function getPartCount() - { - return count($this->_parts); - } - - /** - * Encode header fields - * - * Encodes header content according to RFC1522 if it contains non-printable - * characters. - * - * @param string $value - * @return string - */ - protected function _encodeHeader($value) - { - if (Postman_Zend_Mime::isPrintable($value) === false) { - if ($this->getHeaderEncoding() === Postman_Zend_Mime::ENCODING_QUOTEDPRINTABLE) { - $value = Postman_Zend_Mime::encodeQuotedPrintableHeader($value, $this->getCharset(), Postman_Zend_Mime::LINELENGTH, Postman_Zend_Mime::LINEEND); - } else { - $value = Postman_Zend_Mime::encodeBase64Header($value, $this->getCharset(), Postman_Zend_Mime::LINELENGTH, Postman_Zend_Mime::LINEEND); - } - } - - return $value; - } - - /** - * Add a header to the message - * - * Adds a header to this message. If append is true and the header already - * exists, raises a flag indicating that the header should be appended. - * - * @param string $headerName - * @param string $value - * @param bool $append - */ - protected function _storeHeader($headerName, $value, $append = false) - { - if (isset($this->_headers[$headerName])) { - $this->_headers[$headerName][] = $value; - } else { - $this->_headers[$headerName] = array($value); - } - - if ($append) { - $this->_headers[$headerName]['append'] = true; - } - - } - - /** - * Clear header from the message - * - * @param string $headerName - * @deprecated use public method directly - */ - protected function _clearHeader($headerName) - { - $this->clearHeader($headerName); - } - - /** - * Helper function for adding a recipient and the corresponding header - * - * @param string $headerName - * @param string $email - * @param string $name - */ - protected function _addRecipientAndHeader($headerName, $email, $name) - { - $email = $this->_filterEmail($email); - $name = $this->_filterName($name); - // prevent duplicates - $this->_recipients[$email] = 1; - $this->_storeHeader($headerName, $this->_formatAddress($email, $name), true); - } - - /** - * Adds To-header and recipient, $email can be an array, or a single string address - * - * @param string|array $email - * @param string $name - * @return Postman_Zend_Mail Provides fluent interface - */ - public function addTo($email, $name='') - { - if (!is_array($email)) { - $email = array($name => $email); - } - - foreach ($email as $n => $recipient) { - $this->_addRecipientAndHeader('To', $recipient, is_int($n) ? '' : $n); - $this->_to[] = $recipient; - } - - return $this; - } - - /** - * Adds Cc-header and recipient, $email can be an array, or a single string address - * - * @param string|array $email - * @param string $name - * @return Postman_Zend_Mail Provides fluent interface - */ - public function addCc($email, $name='') - { - if (!is_array($email)) { - $email = array($name => $email); - } - - foreach ($email as $n => $recipient) { - $this->_addRecipientAndHeader('Cc', $recipient, is_int($n) ? '' : $n); - } - - return $this; - } - - /** - * Adds Bcc recipient, $email can be an array, or a single string address - * - * @param string|array $email - * @return Postman_Zend_Mail Provides fluent interface - */ - public function addBcc($email) - { - if (!is_array($email)) { - $email = array($email); - } - - foreach ($email as $recipient) { - $this->_addRecipientAndHeader('Bcc', $recipient, ''); - } - - return $this; - } - - /** - * Return list of recipient email addresses - * - * @return array (of strings) - */ - public function getRecipients() - { - return array_keys($this->_recipients); - } - - /** - * Clear header from the message - * - * @param string $headerName - * @return Postman_Zend_Mail Provides fluent inter - */ - public function clearHeader($headerName) - { - if (isset($this->_headers[$headerName])){ - unset($this->_headers[$headerName]); - } - return $this; - } - - /** - * Clears list of recipient email addresses - * - * @return Postman_Zend_Mail Provides fluent interface - */ - public function clearRecipients() - { - $this->_recipients = array(); - $this->_to = array(); - - $this->clearHeader('To'); - $this->clearHeader('Cc'); - $this->clearHeader('Bcc'); - - return $this; - } - - /** - * Sets From-header and sender of the message - * - * @param string $email - * @param string $name - * @return Postman_Zend_Mail Provides fluent interface - * @throws Postman_Zend_Mail_Exception if called subsequent times - */ - public function setFrom($email, $name = null) - { - if (null !== $this->_from) { - /** - * @see Postman_Zend_Mail_Exception - */ -// require_once 'Zend/Mail/Exception.php'; - throw new Postman_Zend_Mail_Exception('From Header set twice'); - } - - $email = $this->_filterEmail($email); - $name = $this->_filterName($name); - $this->_from = $email; - $this->_storeHeader('From', $this->_formatAddress($email, $name), true); - - return $this; - } - - /** - * Set Reply-To Header - * - * @param string $email - * @param string $name - * @return Postman_Zend_Mail - * @throws Postman_Zend_Mail_Exception if called more than one time - */ - public function setReplyTo($email, $name = null) - { - if (null !== $this->_replyTo) { - /** - * @see Postman_Zend_Mail_Exception - */ -// require_once 'Zend/Mail/Exception.php'; - throw new Postman_Zend_Mail_Exception('Reply-To Header set twice'); - } - - $name = $this->_filterName($name); - $this->_replyTo = $email; - - if ( strpos( $email, ',' ) !== false ) { - $emails = explode(',', $email ); - foreach ( $emails as $email ) { - $email = $this->_filterEmail($email); - $replyToList[] = $this->_formatAddress($email, $name); - } - } else { - $email = $this->_filterEmail($email); - $replyToList[] = $this->_formatAddress($email, $name); - } - - $this->_storeHeader('Reply-To', implode(',', $replyToList ), true); - - return $this; - } - - /** - * Returns the sender of the mail - * - * @return string - */ - public function getFrom() - { - return $this->_from; - } - - /** - * Returns the current Reply-To address of the message - * - * @return string|null Reply-To address, null when not set - */ - public function getReplyTo() - { - return $this->_replyTo; - } - - /** - * Clears the sender from the mail - * - * @return Postman_Zend_Mail Provides fluent interface - */ - public function clearFrom() - { - $this->_from = null; - $this->clearHeader('From'); - - return $this; - } - - /** - * Clears the current Reply-To address from the message - * - * @return Postman_Zend_Mail Provides fluent interface - */ - public function clearReplyTo() - { - $this->_replyTo = null; - $this->clearHeader('Reply-To'); - - return $this; - } - - /** - * Sets Default From-email and name of the message - * - * @param string $email - * @param string Optional $name - * @return void - */ - public static function setDefaultFrom($email, $name = null) - { - self::$_defaultFrom = array('email' => $email, 'name' => $name); - } - - /** - * Returns the default sender of the mail - * - * @return null|array Null if none was set. - */ - public static function getDefaultFrom() - { - return self::$_defaultFrom; - } - - /** - * Clears the default sender from the mail - * - * @return void - */ - public static function clearDefaultFrom() - { - self::$_defaultFrom = null; - } - - /** - * Sets From-name and -email based on the defaults - * - * @return Postman_Zend_Mail Provides fluent interface - */ - public function setFromToDefaultFrom() { - $from = self::getDefaultFrom(); - if($from === null) { -// require_once 'Zend/Mail/Exception.php'; - throw new Postman_Zend_Mail_Exception( - 'No default From Address set to use'); - } - - $this->setFrom($from['email'], $from['name']); - - return $this; - } - - /** - * Sets Default ReplyTo-address and -name of the message - * - * @param string $email - * @param string Optional $name - * @return void - */ - public static function setDefaultReplyTo($email, $name = null) - { - self::$_defaultReplyTo = array('email' => $email, 'name' => $name); - } - - /** - * Returns the default Reply-To Address and Name of the mail - * - * @return null|array Null if none was set. - */ - public static function getDefaultReplyTo() - { - return self::$_defaultReplyTo; - } - - /** - * Clears the default ReplyTo-address and -name from the mail - * - * @return void - */ - public static function clearDefaultReplyTo() - { - self::$_defaultReplyTo = null; - } - - /** - * Sets ReplyTo-name and -email based on the defaults - * - * @return Postman_Zend_Mail Provides fluent interface - */ - public function setReplyToFromDefault() { - $replyTo = self::getDefaultReplyTo(); - if($replyTo === null) { -// require_once 'Zend/Mail/Exception.php'; - throw new Postman_Zend_Mail_Exception( - 'No default Reply-To Address set to use'); - } - - $this->setReplyTo($replyTo['email'], $replyTo['name']); - - return $this; - } - - /** - * Sets the Return-Path header of the message - * - * @param string $email - * @return Postman_Zend_Mail Provides fluent interface - * @throws Postman_Zend_Mail_Exception if set multiple times - */ - public function setReturnPath($email) - { - if ($this->_returnPath === null) { - $email = $this->_filterEmail($email); - $this->_returnPath = $email; - // Postman SMTP Fix - Jason Hendriks - // according to RFC 5321, Return-Path should not be set my the MUA - // http://tools.ietf.org/html/rfc5321#section-4.4 - // $this->_storeHeader('Return-Path', $email, false); - } else { - /** - * @see Postman_Zend_Mail_Exception - */ -// require_once 'Zend/Mail/Exception.php'; - throw new Postman_Zend_Mail_Exception('Return-Path Header set twice'); - } - return $this; - } - - /** - * Returns the current Return-Path address of the message - * - * If no Return-Path header is set, returns the value of {@link $_from}. - * - * @return string - */ - public function getReturnPath() - { - if (null !== $this->_returnPath) { - return $this->_returnPath; - } - - return $this->_from; - } - - /** - * Clears the current Return-Path address from the message - * - * @return Postman_Zend_Mail Provides fluent interface - */ - public function clearReturnPath() - { - $this->_returnPath = null; - $this->clearHeader('Return-Path'); - - return $this; - } - - /** - * Sets the subject of the message - * - * @param string $subject - * @return Postman_Zend_Mail Provides fluent interface - * @throws Postman_Zend_Mail_Exception - */ - public function setSubject($subject) - { - if ($this->_subject === null) { - $subject = $this->_filterOther($subject); - $this->_subject = $this->_encodeHeader($subject); - $this->_storeHeader('Subject', $this->_subject); - } else { - /** - * @see Postman_Zend_Mail_Exception - */ -// require_once 'Zend/Mail/Exception.php'; - throw new Postman_Zend_Mail_Exception('Subject set twice'); - } - return $this; - } - - /** - * Returns the encoded subject of the message - * - * @return string - */ - public function getSubject() - { - return $this->_subject; - } - - /** - * Clears the encoded subject from the message - * - * @return Postman_Zend_Mail Provides fluent interface - */ - public function clearSubject() - { - $this->_subject = null; - $this->clearHeader('Subject'); - - return $this; - } - - /** - * Sets Date-header - * - * @param timestamp|string|Postman_Zend_Date $date - * @return Postman_Zend_Mail Provides fluent interface - * @throws Postman_Zend_Mail_Exception if called subsequent times or wrong date format. - */ - public function setDate($date = null) - { - if ($this->_date === null) { - if ($date === null) { - $date = date('r'); - } else if (is_int($date)) { - $date = date('r', $date); - } else if (is_string($date)) { - $date = strtotime($date); - if ($date === false || $date < 0) { - /** - * @see Postman_Zend_Mail_Exception - */ -// require_once 'Zend/Mail/Exception.php'; - throw new Postman_Zend_Mail_Exception('String representations of Date Header must be ' . - 'strtotime()-compatible'); - } - $date = date('r', $date); - } else if ($date instanceof Postman_Zend_Date) { - $date = $date->get(Postman_Zend_Date::RFC_2822); - } else { - /** - * @see Postman_Zend_Mail_Exception - */ -// require_once 'Zend/Mail/Exception.php'; - throw new Postman_Zend_Mail_Exception(__METHOD__ . ' only accepts UNIX timestamps, Postman_Zend_Date objects, ' . - ' and strtotime()-compatible strings'); - } - $this->_date = $date; - $this->_storeHeader('Date', $date); - } else { - /** - * @see Postman_Zend_Mail_Exception - */ -// require_once 'Zend/Mail/Exception.php'; - throw new Postman_Zend_Mail_Exception('Date Header set twice'); - } - return $this; - } - - /** - * Returns the formatted date of the message - * - * @return string - */ - public function getDate() - { - return $this->_date; - } - - /** - * Clears the formatted date from the message - * - * @return Postman_Zend_Mail Provides fluent interface - */ - public function clearDate() - { - $this->_date = null; - $this->clearHeader('Date'); - - return $this; - } - - /** - * Sets the Message-ID of the message - * - * @param boolean|string $id - * true :Auto - * false :No set - * null :No set - * string:Sets given string (Angle brackets is not necessary) - * @return Postman_Zend_Mail Provides fluent interface - * @throws Postman_Zend_Mail_Exception - */ - public function setMessageId($id = true) - { - if ($id === null || $id === false) { - return $this; - } elseif ($id === true) { - $id = $this->createMessageId(); - } - - if ($this->_messageId === null) { - $id = $this->_filterOther($id); - $this->_messageId = $id; - $this->_storeHeader('Message-Id', '<' . $this->_messageId . '>'); - } else { - /** - * @see Postman_Zend_Mail_Exception - */ -// require_once 'Zend/Mail/Exception.php'; - throw new Postman_Zend_Mail_Exception('Message-ID set twice'); - } - - return $this; - } - - /** - * Returns the Message-ID of the message - * - * @return string - */ - public function getMessageId() - { - return $this->_messageId; - } - - - /** - * Clears the Message-ID from the message - * - * @return Postman_Zend_Mail Provides fluent interface - */ - public function clearMessageId() - { - $this->_messageId = null; - $this->clearHeader('Message-Id'); - - return $this; - } - - /** - * Creates the Message-ID - * - * @return string - */ - public function createMessageId() { - - $time = time(); - - if ($this->_from !== null) { - $user = $this->_from; - } elseif (isset($_SERVER['REMOTE_ADDR'])) { - $user = $_SERVER['REMOTE_ADDR']; - } else { - $user = getmypid(); - } - - $rand = mt_rand(); - - if ($this->_recipients !== array()) { - $recipient = array_rand($this->_recipients); - } else { - $recipient = 'unknown'; - } - - if (isset($_SERVER["SERVER_NAME"])) { - $hostName = $_SERVER["SERVER_NAME"]; - } else { - $hostName = php_uname('n'); - } - - return sha1($time . $user . $rand . $recipient) . '@' . $hostName; - } - - /** - * Add a custom header to the message - * - * @param string $name - * @param string $value - * @param boolean $append - * @return Postman_Zend_Mail Provides fluent interface - * @throws Postman_Zend_Mail_Exception on attempts to create standard headers - */ - public function addHeader($name, $value, $append = false) - { - $prohibit = array('to', 'cc', 'bcc', 'from', 'subject', - 'reply-to', 'return-path', - 'date', 'message-id', - ); - if (in_array(strtolower($name), $prohibit)) { - /** - * @see Postman_Zend_Mail_Exception - */ -// require_once 'Zend/Mail/Exception.php'; - throw new Postman_Zend_Mail_Exception('Cannot set standard header from addHeader()'); - } - - $value = $this->_filterOther($value); - $value = $this->_encodeHeader($value); - $this->_storeHeader($name, $value, $append); - - return $this; - } - - /** - * Return mail headers - * - * @return void - */ - public function getHeaders() - { - return $this->_headers; - } - - /** - * Sends this email using the given transport or a previously - * set DefaultTransport or the internal mail function if no - * default transport had been set. - * - * @param Postman_Zend_Mail_Transport_Abstract $transport - * @return Postman_Zend_Mail Provides fluent interface - */ - public function send($transport = null) - { - if ($transport === null) { - if (! self::$_defaultTransport instanceof Postman_Zend_Mail_Transport_Abstract) { - require_once 'Mail/Transport/Sendmail.php'; - - $transport = new Postman_Zend_Mail_Transport_Sendmail("-f{$this->_from}"); - } else { - $transport = self::$_defaultTransport; - } - } - - if ($this->_date === null) { - $this->setDate(); - } - - if(null === $this->_from && null !== self::getDefaultFrom()) { - $this->setFromToDefaultFrom(); - } - - if(null === $this->_replyTo && null !== self::getDefaultReplyTo()) { - $this->setReplyToFromDefault(); - } - - $transport->send($this); - - return $this; - } - - /** - * Filter of email data - * - * @param string $email - * @return string - */ - protected function _filterEmail($email) - { - $rule = array("\r" => '', - "\n" => '', - "\t" => '', - '"' => '', - ',' => '', - '<' => '', - '>' => '', - ); - - return strtr($email, $rule); - } - - /** - * Filter of name data - * - * @param string $name - * @return string - */ - protected function _filterName($name) - { - $rule = array("\r" => '', - "\n" => '', - "\t" => '', - '"' => "'", - '<' => '[', - '>' => ']', - ); - - return trim(strtr($name, $rule)); - } - - /** - * Filter of other data - * - * @param string $data - * @return string - */ - protected function _filterOther($data) - { - $rule = array("\r" => '', - "\n" => '', - "\t" => '', - ); - - return strtr($data, $rule); - } - - /** - * Formats e-mail address - * - * @param string $email - * @param string $name - * @return string - */ - protected function _formatAddress($email, $name) - { - if ($name === '' || $name === null || $name === $email) { - return $email; - } else { - $encodedName = $this->_encodeHeader($name); - if ($encodedName === $name && strcspn($name, '()<>[]:;@\\,.') != strlen($name)) { - $format = '"%s" <%s>'; - } else { - $format = '%s <%s>'; - } - return sprintf($format, $encodedName, $email); - } - } - -} |