mirror of
				https://bitbucket.org/jsuto/piler.git
				synced 2025-10-31 08:22:26 +01:00 
			
		
		
		
	
		
			
				
	
	
		
			1284 lines
		
	
	
		
			32 KiB
		
	
	
	
		
			PHP
		
	
	
	
	
	
			
		
		
	
	
			1284 lines
		
	
	
		
			32 KiB
		
	
	
	
		
			PHP
		
	
	
	
	
	
| <?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    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 Zend_Mail_Transport_Abstract
 | |
|  */
 | |
| require_once 'Zend/Mail/Transport/Abstract.php';
 | |
| 
 | |
| /**
 | |
|  * @see Zend_Mime
 | |
|  */
 | |
| require_once 'Zend/Mime.php';
 | |
| 
 | |
| /**
 | |
|  * @see Zend_Mime_Message
 | |
|  */
 | |
| require_once 'Zend/Mime/Message.php';
 | |
| 
 | |
| /**
 | |
|  * @see Zend_Mime_Part
 | |
|  */
 | |
| require_once 'Zend/Mime/Part.php';
 | |
| 
 | |
| 
 | |
| /**
 | |
|  * Class for sending an email.
 | |
|  *
 | |
|  * @category   Zend
 | |
|  * @package    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 Zend_Mail extends Zend_Mime_Message
 | |
| {
 | |
|     /**#@+
 | |
|      * @access protected
 | |
|      */
 | |
| 
 | |
|     /**
 | |
|      * @var 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 = 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|Zend_Mime_Part
 | |
|      */
 | |
|     protected $_bodyText = false;
 | |
| 
 | |
|     /**
 | |
|      * text/html MIME part
 | |
|      * @var false|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
 | |
|      * 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  Zend_Mail_Transport_Abstract $transport
 | |
|      */
 | |
|     public static function setDefaultTransport(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
 | |
|      */
 | |
|     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 Zend_Mail Implements fluent interface
 | |
|      * @throws Zend_Mail_Exception for types not supported by Zend_Mime
 | |
|      */
 | |
|     public function setType($type)
 | |
|     {
 | |
|         $allowed = array(
 | |
|             Zend_Mime::MULTIPART_ALTERNATIVE,
 | |
|             Zend_Mime::MULTIPART_MIXED,
 | |
|             Zend_Mime::MULTIPART_RELATED,
 | |
|         );
 | |
|         if (!in_array($type, $allowed)) {
 | |
|             /**
 | |
|              * @see Zend_Mail_Exception
 | |
|              */
 | |
|             require_once 'Zend/Mail/Exception.php';
 | |
|             throw new 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, Zend_Mime will generate one.
 | |
|      *
 | |
|      * @param  string    $boundary
 | |
|      * @return 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 Zend_Mime::ENCODING_QUOTEDPRINTABLE or 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 Zend_Mail
 | |
|      */
 | |
|     public function setEncodingOfHeaders($encoding)
 | |
|     {
 | |
|         return $this->setHeaderEncoding($encoding);
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * Set the encoding of mail headers
 | |
|      *
 | |
|      * @param  string $encoding Zend_Mime::ENCODING_QUOTEDPRINTABLE or
 | |
|      *                          Zend_Mime::ENCODING_BASE64
 | |
|      * @return Zend_Mail Provides fluent interface
 | |
|      * @throws Zend_Mail_Exception
 | |
|      */
 | |
|     public function setHeaderEncoding($encoding)
 | |
|     {
 | |
|         $allowed = array(
 | |
|             Zend_Mime::ENCODING_BASE64,
 | |
|             Zend_Mime::ENCODING_QUOTEDPRINTABLE
 | |
|         );
 | |
|         if (!in_array($encoding, $allowed)) {
 | |
|             /**
 | |
|              * @see Zend_Mail_Exception
 | |
|              */
 | |
|             require_once 'Zend/Mail/Exception.php';
 | |
|             throw new 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 Zend_Mail Provides fluent interface
 | |
|     */
 | |
|     public function setBodyText($txt, $charset = null, $encoding = Zend_Mime::ENCODING_QUOTEDPRINTABLE)
 | |
|     {
 | |
|         if ($charset === null) {
 | |
|             $charset = $this->_charset;
 | |
|         }
 | |
| 
 | |
|         $mp = new Zend_Mime_Part($txt);
 | |
|         $mp->encoding = $encoding;
 | |
|         $mp->type = Zend_Mime::TYPE_TEXT;
 | |
|         $mp->disposition = Zend_Mime::DISPOSITION_INLINE;
 | |
|         $mp->charset = $charset;
 | |
| 
 | |
|         $this->_bodyText = $mp;
 | |
| 
 | |
|         return $this;
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * Return text body 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|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 Zend_Mail Provides fluent interface
 | |
|      */
 | |
|     public function setBodyHtml($html, $charset = null, $encoding = Zend_Mime::ENCODING_QUOTEDPRINTABLE)
 | |
|     {
 | |
|         if ($charset === null) {
 | |
|             $charset = $this->_charset;
 | |
|         }
 | |
| 
 | |
|         $mp = new Zend_Mime_Part($html);
 | |
|         $mp->encoding = $encoding;
 | |
|         $mp->type = Zend_Mime::TYPE_HTML;
 | |
|         $mp->disposition = Zend_Mime::DISPOSITION_INLINE;
 | |
|         $mp->charset = $charset;
 | |
| 
 | |
|         $this->_bodyHtml = $mp;
 | |
| 
 | |
|         return $this;
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * Return 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|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  Zend_Mime_Part $attachment
 | |
|      * @return Zend_Mail Provides fluent interface
 | |
|      */
 | |
|     public function addAttachment(Zend_Mime_Part $attachment)
 | |
|     {
 | |
|         $this->addPart($attachment);
 | |
|         $this->hasAttachments = true;
 | |
| 
 | |
|         return $this;
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * Creates a 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 Zend_Mime_Part Newly created Zend_Mime_Part object (to allow
 | |
|      * advanced settings)
 | |
|      */
 | |
|     public function createAttachment($body,
 | |
|                                      $mimeType    = Zend_Mime::TYPE_OCTETSTREAM,
 | |
|                                      $disposition = Zend_Mime::DISPOSITION_ATTACHMENT,
 | |
|                                      $encoding    = Zend_Mime::ENCODING_BASE64,
 | |
|                                      $filename    = null)
 | |
|     {
 | |
| 
 | |
|         $mp = new 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 (Zend_Mime::isPrintable($value) === false) {
 | |
|             if ($this->getHeaderEncoding() === Zend_Mime::ENCODING_QUOTEDPRINTABLE) {
 | |
|                 $value = Zend_Mime::encodeQuotedPrintableHeader($value, $this->getCharset(), Zend_Mime::LINELENGTH, Zend_Mime::LINEEND);
 | |
|             } else {
 | |
|                 $value = Zend_Mime::encodeBase64Header($value, $this->getCharset(), Zend_Mime::LINELENGTH, 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 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 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 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 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 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 Zend_Mail Provides fluent interface
 | |
|      * @throws Zend_Mail_Exception if called subsequent times
 | |
|      */
 | |
|     public function setFrom($email, $name = null)
 | |
|     {
 | |
|         if (null !== $this->_from) {
 | |
|             /**
 | |
|              * @see Zend_Mail_Exception
 | |
|              */
 | |
|             require_once 'Zend/Mail/Exception.php';
 | |
|             throw new 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 Zend_Mail
 | |
|      * @throws Zend_Mail_Exception if called more than one time
 | |
|      */
 | |
|     public function setReplyTo($email, $name = null)
 | |
|     {
 | |
|         if (null !== $this->_replyTo) {
 | |
|             /**
 | |
|              * @see Zend_Mail_Exception
 | |
|              */
 | |
|             require_once 'Zend/Mail/Exception.php';
 | |
|             throw new Zend_Mail_Exception('Reply-To Header set twice');
 | |
|         }
 | |
| 
 | |
|         $email = $this->_filterEmail($email);
 | |
|         $name  = $this->_filterName($name);
 | |
|         $this->_replyTo = $email;
 | |
|         $this->_storeHeader('Reply-To', $this->_formatAddress($email, $name), 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 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 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 $name optional
 | |
|      * @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 Zend_Mail Provides fluent interface
 | |
|      * @throws Zend_Mail_Exception
 | |
|      */
 | |
|     public function setFromToDefaultFrom() {
 | |
|         $from = self::getDefaultFrom();
 | |
|         if($from === null) {
 | |
|             require_once 'Zend/Mail/Exception.php';
 | |
|             throw new 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 $name optional
 | |
|      * @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 Zend_Mail Provides fluent interface
 | |
|      * @throws Zend_Mail_Exception
 | |
|      */
 | |
|     public function setReplyToFromDefault() {
 | |
|         $replyTo = self::getDefaultReplyTo();
 | |
|         if($replyTo === null) {
 | |
|             require_once 'Zend/Mail/Exception.php';
 | |
|             throw new 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 Zend_Mail Provides fluent interface
 | |
|      * @throws Zend_Mail_Exception if set multiple times
 | |
|      */
 | |
|     public function setReturnPath($email)
 | |
|     {
 | |
|         if ($this->_returnPath === null) {
 | |
|             $email = $this->_filterEmail($email);
 | |
|             $this->_returnPath = $email;
 | |
|             $this->_storeHeader('Return-Path', $email, false);
 | |
|         } else {
 | |
|             /**
 | |
|              * @see Zend_Mail_Exception
 | |
|              */
 | |
|             require_once 'Zend/Mail/Exception.php';
 | |
|             throw new 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 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  Zend_Mail Provides fluent interface
 | |
|      * @throws  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 Zend_Mail_Exception
 | |
|              */
 | |
|             require_once 'Zend/Mail/Exception.php';
 | |
|             throw new 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  Zend_Mail Provides fluent interface
 | |
|      */
 | |
|     public function clearSubject()
 | |
|     {
 | |
|         $this->_subject = null;
 | |
|         $this->clearHeader('Subject');
 | |
| 
 | |
|         return $this;
 | |
|     }
 | |
| 
 | |
|     /**
 | |
|      * Sets Date-header
 | |
|      *
 | |
|      * @param  int|string|Zend_Date $date
 | |
|      * @return Zend_Mail Provides fluent interface
 | |
|      * @throws 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 Zend_Mail_Exception
 | |
|                      */
 | |
|                     require_once 'Zend/Mail/Exception.php';
 | |
|                     throw new Zend_Mail_Exception('String representations of Date Header must be ' .
 | |
|                                                   'strtotime()-compatible');
 | |
|                 }
 | |
|                 $date = date('r', $date);
 | |
|             } else if ($date instanceof Zend_Date) {
 | |
|                 $date = $date->get(Zend_Date::RFC_2822);
 | |
|             } else {
 | |
|                 /**
 | |
|                  * @see Zend_Mail_Exception
 | |
|                  */
 | |
|                 require_once 'Zend/Mail/Exception.php';
 | |
|                 throw new Zend_Mail_Exception(__METHOD__ . ' only accepts UNIX timestamps, Zend_Date objects, ' .
 | |
|                                               ' and strtotime()-compatible strings');
 | |
|             }
 | |
|             $this->_date = $date;
 | |
|             $this->_storeHeader('Date', $date);
 | |
|         } else {
 | |
|             /**
 | |
|              * @see Zend_Mail_Exception
 | |
|              */
 | |
|             require_once 'Zend/Mail/Exception.php';
 | |
|             throw new 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 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  Zend_Mail Provides fluent interface
 | |
|      * @throws  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 Zend_Mail_Exception
 | |
|              */
 | |
|             require_once 'Zend/Mail/Exception.php';
 | |
|             throw new 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 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 Zend_Mail           Provides fluent interface
 | |
|      * @throws 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 Zend_Mail_Exception
 | |
|              */
 | |
|             require_once 'Zend/Mail/Exception.php';
 | |
|             throw new 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 array
 | |
|      */
 | |
|     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  Zend_Mail_Transport_Abstract $transport
 | |
|      * @return Zend_Mail                    Provides fluent interface
 | |
|      */
 | |
|     public function send($transport = null)
 | |
|     {
 | |
|         if ($transport === null) {
 | |
|             if (! self::$_defaultTransport instanceof Zend_Mail_Transport_Abstract) {
 | |
|                 require_once 'Zend/Mail/Transport/Sendmail.php';
 | |
|                 $transport = new Zend_Mail_Transport_Sendmail();
 | |
|             } 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);
 | |
|         }
 | |
|     }
 | |
| 
 | |
| }
 |