Heim  >  Artikel  >  php教程  >  Zend Framework Erste Schritte-Tutorial – Beispiel für die Verwendung von Zend_Mail

Zend Framework Erste Schritte-Tutorial – Beispiel für die Verwendung von Zend_Mail

高洛峰
高洛峰Original
2017-01-05 10:40:331401Durchsuche

本文实例讲述了Zend Framework入门教程之Zend_Mail用法。分享给大家供大家参考,具体如下:

Zend_Mail组件提供了通用化的功能来创建和发送文本。

Zend_Mail通过PHP内建的mail()函数或者直接通过SMTP连接来发送邮件。

一个简单的邮件由收件人、主题、邮件内容以及发件人等内容组成。

步骤如下

1.创建对象
2.设置邮件内容
3.发送

案例:

<?php
require_once "Zend/Mail.php";
$my_mail = new Zend_Mail();             //创建一个对象
$my_mail->addTo("jiqing9006@126.com","jim");    //添加一个收件人
$my_mail->setSubject("Just a test");        //设置主题
$my_mail->setBodyText("Hello Jim!");        //为邮件设置正文内容
$my_mail->setFrom("706507884@qq.com","jiqing");   //为邮件设置发件人
echo "邮件设置完毕";
echo "<p>";
echo "邮件收件人为:";
$result = $my_mail->getHeaders();
echo $result[&#39;To&#39;][0];
echo "<p>";
echo "邮件主题为:";
echo $my_mail->getSubject();
echo "<p>";
echo "邮件内容为:";
$result = $my_mail->getBodyText();
echo $result->getContent();
echo "<p>";
echo "邮件发件人为:";
echo $my_mail->getFrom();
echo "<p>";
$my_mail->send();

结果:

邮件设置完毕
邮件收件人为:jim
邮件主题为:Just a test
邮件内容为:Hello Jim!
邮件发件人为:706507884@qq.com

Fatal error: Uncaught exception 'Zend_Mail_Transport_Exception' with message 'Unable to send mail. mail() [49ef19f19b5dc1755f8def37af29c7d4function.mail5db79b134e9f6b82c0b36e0489ee08ed]: Failed to connect to mailserver at "localhost" port 25, verify your "SMTP" and "smtp_port" setting in php.ini or use ini_set()' in C:\zend\library\Zend\Mail\Transport\Sendmail.php:137 Stack trace: #0 C:\zend\library\Zend\Mail\Transport\Abstract.php(348): Zend_Mail_Transport_Sendmail->_sendMail() #1 C:\zend\library\Zend\Mail.php(1194): Zend_Mail_Transport_Abstract->send(Object(Zend_Mail)) #2 D:\xampp\htdocs\test.php(24): Zend_Mail->send() #3 {main} thrown in C:\zend\library\Zend\Mail\Transport\Sendmail.php on line 137

点评:

这里执行不能成功,是因为没有配置好Mail服务器。

源码分析:

<?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-2012 Zend Technologies USA Inc. (http://www.zend.com)
 * @license  http://framework.zend.com/license/new-bsd   New BSD License
 * @version  $Id: Mail.php 24593 2012-01-05 20:35:02Z matthew $
 */
/**
 * @see Zend_Mail_Transport_Abstract
 */
require_once &#39;Zend/Mail/Transport/Abstract.php&#39;;
/**
 * @see Zend_Mime
 */
require_once &#39;Zend/Mime.php&#39;;
/**
 * @see Zend_Mime_Message
 */
require_once &#39;Zend/Mime/Message.php&#39;;
/**
 * @see Zend_Mime_Part
 */
require_once &#39;Zend/Mime/Part.php&#39;;
/**
 * Class for sending an email.
 *
 * @category  Zend
 * @package  Zend_Mail
 * @copyright Copyright (c) 2005-2012 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 = &#39;iso-8859-1&#39;;
  /**
   * 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
   * @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 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 &#39;Zend/Mail/Exception.php&#39;;
      throw new Zend_Mail_Exception(&#39;Invalid content type "&#39; . $type . &#39;"&#39;);
    }
    $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
   */
  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 &#39;Zend/Mail/Exception.php&#39;;
      throw new Zend_Mail_Exception(&#39;Invalid encoding "&#39; . $encoding . &#39;"&#39;);
    }
    $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][&#39;append&#39;] = 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=&#39;&#39;)
  {
    if (!is_array($email)) {
      $email = array($name => $email);
    }
    foreach ($email as $n => $recipient) {
      $this->_addRecipientAndHeader(&#39;To&#39;, $recipient, is_int($n) ? &#39;&#39; : $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=&#39;&#39;)
  {
    if (!is_array($email)) {
      $email = array($name => $email);
    }
    foreach ($email as $n => $recipient) {
      $this->_addRecipientAndHeader(&#39;Cc&#39;, $recipient, is_int($n) ? &#39;&#39; : $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(&#39;Bcc&#39;, $recipient, &#39;&#39;);
    }
    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(&#39;To&#39;);
    $this->clearHeader(&#39;Cc&#39;);
    $this->clearHeader(&#39;Bcc&#39;);
    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 &#39;Zend/Mail/Exception.php&#39;;
      throw new Zend_Mail_Exception(&#39;From Header set twice&#39;);
    }
    $email = $this->_filterEmail($email);
    $name = $this->_filterName($name);
    $this->_from = $email;
    $this->_storeHeader(&#39;From&#39;, $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 &#39;Zend/Mail/Exception.php&#39;;
      throw new Zend_Mail_Exception(&#39;Reply-To Header set twice&#39;);
    }
    $email = $this->_filterEmail($email);
    $name = $this->_filterName($name);
    $this->_replyTo = $email;
    $this->_storeHeader(&#39;Reply-To&#39;, $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(&#39;From&#39;);
    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(&#39;Reply-To&#39;);
    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(&#39;email&#39; => $email, &#39;name&#39; => $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
   */
  public function setFromToDefaultFrom() {
    $from = self::getDefaultFrom();
    if($from === null) {
      require_once &#39;Zend/Mail/Exception.php&#39;;
      throw new Zend_Mail_Exception(
        &#39;No default From Address set to use&#39;);
    }
    $this->setFrom($from[&#39;email&#39;], $from[&#39;name&#39;]);
    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(&#39;email&#39; => $email, &#39;name&#39; => $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
   */
  public function setReplyToFromDefault() {
    $replyTo = self::getDefaultReplyTo();
    if($replyTo === null) {
      require_once &#39;Zend/Mail/Exception.php&#39;;
      throw new Zend_Mail_Exception(
        &#39;No default Reply-To Address set to use&#39;);
    }
    $this->setReplyTo($replyTo[&#39;email&#39;], $replyTo[&#39;name&#39;]);
    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(&#39;Return-Path&#39;, $email, false);
    } else {
      /**
       * @see Zend_Mail_Exception
       */
      require_once &#39;Zend/Mail/Exception.php&#39;;
      throw new Zend_Mail_Exception(&#39;Return-Path Header set twice&#39;);
    }
    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(&#39;Return-Path&#39;);
    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(&#39;Subject&#39;, $this->_subject);
    } else {
      /**
       * @see Zend_Mail_Exception
       */
      require_once &#39;Zend/Mail/Exception.php&#39;;
      throw new Zend_Mail_Exception(&#39;Subject set twice&#39;);
    }
    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(&#39;Subject&#39;);
    return $this;
  }
  /**
   * Sets Date-header
   *
   * @param timestamp|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(&#39;r&#39;);
      } else if (is_int($date)) {
        $date = date(&#39;r&#39;, $date);
      } else if (is_string($date)) {
        $date = strtotime($date);
        if ($date === false || $date < 0) {
          /**
           * @see Zend_Mail_Exception
           */
          require_once &#39;Zend/Mail/Exception.php&#39;;
          throw new Zend_Mail_Exception(&#39;String representations of Date Header must be &#39; .
                         &#39;strtotime()-compatible&#39;);
        }
        $date = date(&#39;r&#39;, $date);
      } else if ($date instanceof Zend_Date) {
        $date = $date->get(Zend_Date::RFC_2822);
      } else {
        /**
         * @see Zend_Mail_Exception
         */
        require_once &#39;Zend/Mail/Exception.php&#39;;
        throw new Zend_Mail_Exception(__METHOD__ . &#39; only accepts UNIX timestamps, Zend_Date objects, &#39; .
                       &#39; and strtotime()-compatible strings&#39;);
      }
      $this->_date = $date;
      $this->_storeHeader(&#39;Date&#39;, $date);
    } else {
      /**
       * @see Zend_Mail_Exception
       */
      require_once &#39;Zend/Mail/Exception.php&#39;;
      throw new Zend_Mail_Exception(&#39;Date Header set twice&#39;);
    }
    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(&#39;Date&#39;);
    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(&#39;Message-Id&#39;, &#39;<&#39; . $this->_messageId . &#39;>&#39;);
    } else {
      /**
       * @see Zend_Mail_Exception
       */
      require_once &#39;Zend/Mail/Exception.php&#39;;
      throw new Zend_Mail_Exception(&#39;Message-ID set twice&#39;);
    }
    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(&#39;Message-Id&#39;);
    return $this;
  }
  /**
   * Creates the Message-ID
   *
   * @return string
   */
  public function createMessageId() {
    $time = time();
    if ($this->_from !== null) {
      $user = $this->_from;
    } elseif (isset($_SERVER[&#39;REMOTE_ADDR&#39;])) {
      $user = $_SERVER[&#39;REMOTE_ADDR&#39;];
    } else {
      $user = getmypid();
    }
    $rand = mt_rand();
    if ($this->_recipients !== array()) {
      $recipient = array_rand($this->_recipients);
    } else {
      $recipient = &#39;unknown&#39;;
    }
    if (isset($_SERVER["SERVER_NAME"])) {
      $hostName = $_SERVER["SERVER_NAME"];
    } else {
      $hostName = php_uname(&#39;n&#39;);
    }
    return sha1($time . $user . $rand . $recipient) . &#39;@&#39; . $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(&#39;to&#39;, &#39;cc&#39;, &#39;bcc&#39;, &#39;from&#39;, &#39;subject&#39;,
             &#39;reply-to&#39;, &#39;return-path&#39;,
             &#39;date&#39;, &#39;message-id&#39;,
             );
    if (in_array(strtolower($name), $prohibit)) {
      /**
       * @see Zend_Mail_Exception
       */
      require_once &#39;Zend/Mail/Exception.php&#39;;
      throw new Zend_Mail_Exception(&#39;Cannot set standard header from addHeader()&#39;);
    }
    $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 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 &#39;Zend/Mail/Transport/Sendmail.php&#39;;
        $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" => &#39;&#39;,
           "\n" => &#39;&#39;,
           "\t" => &#39;&#39;,
           &#39;"&#39; => &#39;&#39;,
           &#39;,&#39; => &#39;&#39;,
           &#39;<&#39; => &#39;&#39;,
           &#39;>&#39; => &#39;&#39;,
    );
    return strtr($email, $rule);
  }
  /**
   * Filter of name data
   *
   * @param string $name
   * @return string
   */
  protected function _filterName($name)
  {
    $rule = array("\r" => &#39;&#39;,
           "\n" => &#39;&#39;,
           "\t" => &#39;&#39;,
           &#39;"&#39; => "&#39;",
           &#39;<&#39; => &#39;[&#39;,
           &#39;>&#39; => &#39;]&#39;,
    );
    return trim(strtr($name, $rule));
  }
  /**
   * Filter of other data
   *
   * @param string $data
   * @return string
   */
  protected function _filterOther($data)
  {
    $rule = array("\r" => &#39;&#39;,
           "\n" => &#39;&#39;,
           "\t" => &#39;&#39;,
    );
    return strtr($data, $rule);
  }
  /**
   * Formats e-mail address
   *
   * @param string $email
   * @param string $name
   * @return string
   */
  protected function _formatAddress($email, $name)
  {
    if ($name === &#39;&#39; || $name === null || $name === $email) {
      return $email;
    } else {
      $encodedName = $this->_encodeHeader($name);
      if ($encodedName === $name && strcspn($name, &#39;()<>[]:;@\\,&#39;) != strlen($name)) {
        $format = &#39;"%s" <%s>&#39;;
      } else {
        $format = &#39;%s <%s>&#39;;
      }
      return sprintf($format, $encodedName, $email);
    }
  }
}

希望本文所述对大家基于Zend Framework框架的PHP程序设计有所帮助。

更多Zend Framework入门教程之Zend_Mail用法示例相关文章请关注PHP中文网!

Stellungnahme:
Der Inhalt dieses Artikels wird freiwillig von Internetnutzern beigesteuert und das Urheberrecht liegt beim ursprünglichen Autor. Diese Website übernimmt keine entsprechende rechtliche Verantwortung. Wenn Sie Inhalte finden, bei denen der Verdacht eines Plagiats oder einer Rechtsverletzung besteht, wenden Sie sich bitte an admin@php.cn