summaryrefslogtreecommitdiff
path: root/Postman/Postman-Mail/Zend-1.12.10/Mail.php
diff options
context:
space:
mode:
authoryehudah <yehudah@b8457f37-d9ea-0310-8a92-e5e31aec5664>2019-11-25 07:50:30 +0000
committeryehudah <yehudah@b8457f37-d9ea-0310-8a92-e5e31aec5664>2019-11-25 07:50:30 +0000
commit907ce8c044159ca8da6ccce3ec5362ac61e7c142 (patch)
tree4e4b83a3aa041a1826e4ac876b001195fce3f7c2 /Postman/Postman-Mail/Zend-1.12.10/Mail.php
parenta41b9219a66f4018dc581f561fbe3fedd24e73f2 (diff)
downloadPost-SMTP-907ce8c044159ca8da6ccce3ec5362ac61e7c142.zip
deleted by mistake
Diffstat (limited to 'Postman/Postman-Mail/Zend-1.12.10/Mail.php')
-rw-r--r--Postman/Postman-Mail/Zend-1.12.10/Mail.php1291
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);
- }
- }
-
-}