Error202
/
yii2-swiftmailer
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
Browse Source

Refactored mail.

tags/2.0.0-beta
Qiang Xue 11 years ago
parent
ed0e44d23b
commit
90a5bcc611
9 changed files with 338 additions and 195 deletions
Whitespace
Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL
Unified View
Diff Options
Show Stats Download Patch File Download Diff File
  1. 31
      extensions/swiftmailer/Mailer.php
  2. 86
      extensions/swiftmailer/Message.php
  3. 138
      framework/yii/mail/BaseMailer.php
  4. 12
      framework/yii/mail/BaseMessage.php
  5. 45
      framework/yii/mail/MailerInterface.php
  6. 111
      framework/yii/mail/MessageInterface.php
  7. 70
      tests/unit/extensions/swiftmailer/MessageTest.php
  8. 16
      tests/unit/framework/mail/BaseMailerTest.php
  9. 16
      tests/unit/framework/mail/BaseMessageTest.php

31
extensions/swiftmailer/Mailer.php
Unescape View File

@ -12,10 +12,10 @@ use yii\base\InvalidConfigException;
use yii\mail\BaseMailer; use yii\mail\BaseMailer;
/** /**
* Mailer based on SwiftMailer library. * Mailer implements a mailer based on SwiftMailer.
*
* To use Mailer, you should configure it in the application configuration like the following,
* *
* By default PHP 'mail' function will be used as default email transport.
* You can setup different email transport via [[vendorMailer]] property:
* ~~~ * ~~~
* 'components' => array( * 'components' => array(
* ... * ...
@ -34,9 +34,20 @@ use yii\mail\BaseMailer;
* ), * ),
* ~~~ * ~~~
* *
* @see http://swiftmailer.org * You may also skip the configuration of the [[transport]] property. In that case, the default
* PHP `mail()` function will be used to send emails.
*
* To send an email, you may use the following code:
*
* ~~~
* Yii::$app->mail->compose('contact/html', ['contactForm' => $form])
* ->setFrom('from@domain.com')
* ->setTo($form->email)
* ->setSubject($form->subject)
* ->send();
* ~~~
* *
* @method Message compose($view = null, array $params = []) creates new message optionally filling up its body via view rendering. * @see http://swiftmailer.org
* *
* @author Paul Klimov <klimov.paul@gmail.com> * @author Paul Klimov <klimov.paul@gmail.com>
* @since 2.0 * @since 2.0
@ -69,7 +80,7 @@ class Mailer extends BaseMailer
/** /**
* @param array|\Swift_Transport $transport * @param array|\Swift_Transport $transport
* @throws \yii\base\InvalidConfigException on invalid argument. * @throws InvalidConfigException on invalid argument.
*/ */
public function setTransport($transport) public function setTransport($transport)
{ {
@ -95,8 +106,12 @@ class Mailer extends BaseMailer
*/ */
public function send($message) public function send($message)
{ {
Yii::trace('Sending email message', __METHOD__); $address = $message->getTo();
return ($this->getSwiftMailer()->send($message->getSwiftMessage()) > 0); if (is_array($address)) {
$address = implode(', ', $address);
}
Yii::trace('Sending email "' . $message->getSubject() . '" to "' . $address . '"', __METHOD__);
return $this->getSwiftMailer()->send($message->getSwiftMessage()) > 0;
} }
/** /**

86
extensions/swiftmailer/Message.php
Unescape View File

@ -10,10 +10,10 @@ namespace yii\swiftmailer;
use yii\mail\BaseMessage; use yii\mail\BaseMessage;
/** /**
* Email message based on SwiftMailer library. * Message implements a message class based on SwiftMailer.
* *
* @see http://swiftmailer.org/docs/messages.html * @see http://swiftmailer.org/docs/messages.html
* @see \yii\swiftmailer\Mailer * @see Mailer
* *
* @method Mailer getMailer() returns mailer instance. * @method Mailer getMailer() returns mailer instance.
* @property \Swift_Message $swiftMessage vendor message instance. * @property \Swift_Message $swiftMessage vendor message instance.
@ -42,7 +42,15 @@ class Message extends BaseMessage
/** /**
* @inheritdoc * @inheritdoc
*/ */
public function charset($charset) public function getCharset()
{
$this->getSwiftMessage()->getCharset();
}
/**
* @inheritdoc
*/
public function setCharset($charset)
{ {
$this->getSwiftMessage()->setCharset($charset); $this->getSwiftMessage()->setCharset($charset);
return $this; return $this;
@ -51,17 +59,49 @@ class Message extends BaseMessage
/** /**
* @inheritdoc * @inheritdoc
*/ */
public function from($from) public function getFrom()
{
$this->getSwiftMessage()->getFrom();
}
/**
* @inheritdoc
*/
public function setFrom($from)
{ {
$this->getSwiftMessage()->setFrom($from); $this->getSwiftMessage()->setFrom($from);
$this->getSwiftMessage()->setReplyTo($from);
return $this; return $this;
} }
/** /**
* @inheritdoc * @inheritdoc
*/ */
public function to($to) public function getReplyTo()
{
$this->getSwiftMessage()->getReplyTo();
}
/**
* @inheritdoc
*/
public function setReplyTo($replyTo)
{
$this->getSwiftMessage()->setReplyTo($replyTo);
return $this;
}
/**
* @inheritdoc
*/
public function getTo()
{
$this->getSwiftMessage()->getTo();
}
/**
* @inheritdoc
*/
public function setTo($to)
{ {
$this->getSwiftMessage()->setTo($to); $this->getSwiftMessage()->setTo($to);
return $this; return $this;
@ -70,7 +110,15 @@ class Message extends BaseMessage
/** /**
* @inheritdoc * @inheritdoc
*/ */
public function cc($cc) public function getCc()
{
$this->getSwiftMessage()->getCc();
}
/**
* @inheritdoc
*/
public function setCc($cc)
{ {
$this->getSwiftMessage()->setCc($cc); $this->getSwiftMessage()->setCc($cc);
return $this; return $this;
@ -79,7 +127,15 @@ class Message extends BaseMessage
/** /**
* @inheritdoc * @inheritdoc
*/ */
public function bcc($bcc) public function getBcc()
{
$this->getSwiftMessage()->getBcc();
}
/**
* @inheritdoc
*/
public function setBcc($bcc)
{ {
$this->getSwiftMessage()->setBcc($bcc); $this->getSwiftMessage()->setBcc($bcc);
return $this; return $this;
@ -88,7 +144,15 @@ class Message extends BaseMessage
/** /**
* @inheritdoc * @inheritdoc
*/ */
public function subject($subject) public function getSubject()
{
$this->getSwiftMessage()->getSubject();
}
/**
* @inheritdoc
*/
public function setSubject($subject)
{ {
$this->getSwiftMessage()->setSubject($subject); $this->getSwiftMessage()->setSubject($subject);
return $this; return $this;
@ -97,7 +161,7 @@ class Message extends BaseMessage
/** /**
* @inheritdoc * @inheritdoc
*/ */
public function textBody($text) public function setTextBody($text)
{ {
$this->setBody($text, 'text/plain'); $this->setBody($text, 'text/plain');
return $this; return $this;
@ -106,7 +170,7 @@ class Message extends BaseMessage
/** /**
* @inheritdoc * @inheritdoc
*/ */
public function htmlBody($html) public function setHtmlBody($html)
{ {
$this->setBody($html, 'text/html'); $this->setBody($html, 'text/html');
return $this; return $this;

138
framework/yii/mail/BaseMailer.php
Unescape View File

@ -11,15 +11,16 @@ use Yii;
use yii\base\Component; use yii\base\Component;
use yii\base\InvalidConfigException; use yii\base\InvalidConfigException;
use yii\base\ViewContextInterface; use yii\base\ViewContextInterface;
use yii\web\View;
/** /**
* BaseMailer provides the basic interface for the email mailer application component. * BaseMailer serves as a base class that implements the basic functions required by [[MailerInterface]].
* It provides the default configuration for the email messages. *
* Particular implementation of mailer should provide implementation for the [[send()]] method. * Concrete child classes should may focus on implementing the [[send()]] method.
* *
* @see BaseMessage * @see BaseMessage
* *
* @property \yii\base\View|array $view view instance or its array configuration. * @property View|array $view view instance or its array configuration.
* *
* @author Paul Klimov <klimov.paul@gmail.com> * @author Paul Klimov <klimov.paul@gmail.com>
* @since 2.0 * @since 2.0
@ -32,60 +33,59 @@ abstract class BaseMailer extends Component implements MailerInterface, ViewCont
private $_view = []; private $_view = [];
/** /**
* @var string directory containing view files for this email messages. * @var string directory containing view files for this email messages.
* This can be specified as an absolute path or path alias.
*/ */
public $viewPath = '@app/mails'; public $viewPath = '@app/mails';
/** /**
* @var string HTML layout view name. * @var string|boolean HTML layout view name. This is the layout used to render HTML mail body.
* The property can take the following values:
*
* - a relative view name: a view file relative to [[viewPath]], e.g., 'layouts/html'.
* - a path alias: an absolute view file path specified as a path alias, e.g., '@app/mails/html'.
* - a boolean false: the layout is disabled.
*/ */
public $htmlLayout = 'layouts/html'; public $htmlLayout = 'layouts/html';
/** /**
* @var string text layout view name. * @var string|boolean text layout view name. This is the layout used to render TEXT mail body.
* Please refer to [[htmlLayout]] for possible values that this property can take.
*/ */
public $textLayout = 'layouts/text'; public $textLayout = 'layouts/text';
/** /**
* @var array configuration, which should be applied by default to any new created * @var array the configuration that should be applied to any newly created
* email message instance. * email message instance by [[createMessage()]] or [[compose()]]. Any valid property defined
* In addition to normal [[Yii::createObject()]] behavior extra config keys are available: * by [[MessageInterface]] can be configured, such as `from`, `to`, `subject`, `textBody`, `htmlBody`, etc.
*
* - 'charset' argument for [[MessageInterface::charset()]]
* - 'from' argument for [[MessageInterface::from()]]
* - 'to' argument for [[MessageInterface::to()]]
* - 'cc' argument for [[MessageInterface::cc()]]
* - 'bcc' argument for [[MessageInterface::bcc()]]
* - 'subject' argument for [[MessageInterface::subject()]]
* - 'textBody' argument for [[MessageInterface::textBody()]]
* - 'htmlBody' argument for [[MessageInterface::htmlBody()]]
* *
* For example: * For example:
* *
* ~~~ * ~~~
* array( * [
* 'charset' => 'UTF-8', * 'charset' => 'UTF-8',
* 'from' => 'noreply@mydomain.com', * 'from' => 'noreply@mydomain.com',
* 'bcc' => 'developer@mydomain.com', * 'bcc' => 'developer@mydomain.com',
* ) * ]
* ~~~ * ~~~
*/ */
public $messageConfig = []; public $messageConfig = [];
/** /**
* @var string message default class name. * @var string the default class name of the new message instances created by [[createMessage()]]
*/ */
public $messageClass = 'yii\mail\BaseMessage'; public $messageClass = 'yii\mail\BaseMessage';
/** /**
* @param array|\yii\base\View $view view instance or its array configuration. * @param array|View $view view instance or its array configuration that will be used to
* @throws \yii\base\InvalidConfigException on invalid argument. * render message bodies.
* @throws InvalidConfigException on invalid argument.
*/ */
public function setView($view) public function setView($view)
{ {
if (!is_array($view) && !is_object($view)) { if (!is_array($view) && !is_object($view)) {
throw new InvalidConfigException('"' . get_class($this) . '::view" should be either object or array, "' . gettype($view) . '" given.'); throw new InvalidConfigException('"' . get_class($this) . '::view" should be either object or configuration array, "' . gettype($view) . '" given.');
} }
$this->_view = $view; $this->_view = $view;
} }
/** /**
* @return \yii\base\View view instance. * @return View view instance.
*/ */
public function getView() public function getView()
{ {
@ -98,18 +98,35 @@ abstract class BaseMailer extends Component implements MailerInterface, ViewCont
/** /**
* Creates view instance from given configuration. * Creates view instance from given configuration.
* @param array $config view configuration. * @param array $config view configuration.
* @return \yii\base\View view instance. * @return View view instance.
*/ */
protected function createView(array $config) protected function createView(array $config)
{ {
if (!array_key_exists('class', $config)) { if (!array_key_exists('class', $config)) {
$config['class'] = 'yii\web\View'; $config['class'] = View::className();
} }
return Yii::createObject($config); return Yii::createObject($config);
} }
/** /**
* @inheritdoc * Creates a new message instance and optionally composes its body content via view rendering.
*
* @param string|array $view the view to be used for rendering the message body. This can be:
*
* - a string, which represents the view name or path alias for rendering the HTML body of the email.
* In this case, the text body will be generated by applying `strip_tags()` to the HTML body.
* - an array with 'html' and/or 'text' elements. The 'html' element refers to the view name or path alias
* for rendering the HTML body, while 'text' element is for rendering the text body. For example,
* `['html' => 'contact-html', 'text' => 'contact-text']`.
* - null, meaning the message instance will be returned without body content.
*
* The view to be rendered can be specified in one of the following formats:
*
* - path alias (e.g. "@app/mails/contact");
* - a relative view name (e.g. "contact"): the actual view file will be resolved by [[findViewFile()]]
*
* @param array $params the parameters (name-value pairs) that will be extracted and made available in the view file.
* @return MessageInterface message instance.
*/ */
public function compose($view = null, array $params = []) public function compose($view = null, array $params = [])
{ {
@ -117,24 +134,32 @@ abstract class BaseMailer extends Component implements MailerInterface, ViewCont
if ($view !== null) { if ($view !== null) {
$params['message'] = $message; $params['message'] = $message;
if (is_array($view)) { if (is_array($view)) {
if (array_key_exists('html', $view)) { if (isset($view['html'])) {
$message->htmlBody($this->render($view['html'], $params, $this->htmlLayout)); $html = $this->render($view['html'], $params, $this->htmlLayout);
} }
if (array_key_exists('text', $view)) { if (isset($view['text'])) {
$message->textBody($this->render($view['text'], $params, $this->textLayout)); $text = $this->render($view['text'], $params, $this->textLayout);
} }
} else { } else {
$html = $this->render($view, $params, $this->htmlLayout); $html = $this->render($view, $params, $this->htmlLayout);
$message->htmlBody($html); }
$message->textBody(strip_tags($html)); if (isset($html)) {
$message->setHtmlBody($html);
}
if (isset($text)) {
$message->setTextBody($text);
} elseif (isset($html)) {
$message->setTextBody(strip_tags($html));
} }
} }
return $message; return $message;
} }
/** /**
* Creates mew message instance using configuration from [[messageConfig]]. * Creates a new message instance.
* If 'class' parameter is omitted, [[messageClass]] will be used. * The newly created instance will be initialized with the configuration specified by [[messageConfig]].
* If the configuration does not specify a 'class', the [[messageClass]] will be used as the class
* of the new message instance.
* @return MessageInterface message instance. * @return MessageInterface message instance.
*/ */
protected function createMessage() protected function createMessage()
@ -143,37 +168,18 @@ abstract class BaseMailer extends Component implements MailerInterface, ViewCont
if (!array_key_exists('class', $config)) { if (!array_key_exists('class', $config)) {
$config['class'] = $this->messageClass; $config['class'] = $this->messageClass;
} }
$directSetterNames = [ return Yii::createObject($config);
'charset',
'from',
'to',
'cc',
'bcc',
'subject',
'textBody',
'htmlBody',
];
$directSetterConfig = [];
foreach ($config as $name => $value) {
if (in_array($name, $directSetterNames, true)) {
$directSetterConfig[$name] = $value;
unset($config[$name]);
}
}
$message = Yii::createObject($config);
foreach ($directSetterConfig as $name => $value) {
$message->$name($value);
}
return $message;
} }
/** /**
* Sends a couple of messages at once. * Sends multiple messages at once.
* Note: some particular mailers may benefit from sending messages as batch, *
* saving resources, for example on open/close connection operations, * The default implementation simply calls [[send()]] multiple times.
* they may override this method to create their specific implementation. * Child classes may override this method to implement more efficient way of
* sending multiple messages.
*
* @param array $messages list of email messages, which should be sent. * @param array $messages list of email messages, which should be sent.
* @return integer number of successful sends. * @return integer number of messages that are successfully sent.
*/ */
public function sendMultiple(array $messages) public function sendMultiple(array $messages)
{ {
@ -187,10 +193,11 @@ abstract class BaseMailer extends Component implements MailerInterface, ViewCont
} }
/** /**
* Renders a view. * Renders the specified view with optional parameters and layout.
* The view will be rendered using the [[view]] component.
* @param string $view the view name or the path alias of the view file. * @param string $view the view name or the path alias of the view file.
* @param array $params the parameters (name-value pairs) that will be extracted and made available in the view file. * @param array $params the parameters (name-value pairs) that will be extracted and made available in the view file.
* @param string|boolean $layout layout view name, if false given no layout will be applied. * @param string|boolean $layout layout view name or path alias. If false, no layout will be applied.
* @return string the rendering result. * @return string the rendering result.
*/ */
public function render($view, $params = [], $layout = false) public function render($view, $params = [], $layout = false)
@ -205,6 +212,7 @@ abstract class BaseMailer extends Component implements MailerInterface, ViewCont
/** /**
* Finds the view file corresponding to the specified relative view name. * Finds the view file corresponding to the specified relative view name.
* This method will return the view file by prefixing the view name with [[viewPath]].
* @param string $view a relative view name. The name does NOT start with a slash. * @param string $view a relative view name. The name does NOT start with a slash.
* @return string the view file path. Note that the file may not exist. * @return string the view file path. Note that the file may not exist.
*/ */

12
framework/yii/mail/BaseMessage.php
Unescape View File

@ -11,14 +11,14 @@ use yii\base\Object;
use Yii; use Yii;
/** /**
* BaseMessage represent the single email message. * BaseMessage serves as a base class that implements the [[send()]] method required by [[MessageInterface]].
* It functionality depends on application component 'email', *
* which should provide the actual email sending functionality as well as * By default, [[send()]] will use the "mail" application component to send the current message.
* default message configuration. * The "mail" application component should be a mailer instance implementing [[MailerInterface]].
* *
* @see BaseMailer * @see BaseMailer
* *
* @property \yii\mail\BaseMailer $mailer mailer component instance. This property is read-only. * @property BaseMailer $mailer mailer component instance. This property is read-only.
* *
* @author Paul Klimov <klimov.paul@gmail.com> * @author Paul Klimov <klimov.paul@gmail.com>
* @since 2.0 * @since 2.0
@ -26,7 +26,7 @@ use Yii;
abstract class BaseMessage extends Object implements MessageInterface abstract class BaseMessage extends Object implements MessageInterface
{ {
/** /**
* @return \yii\mail\BaseMailer mailer component instance. * @return MailerInterface the mailer component
*/ */
public function getMailer() public function getMailer()
{ {

45
framework/yii/mail/MailerInterface.php
Unescape View File

@ -8,15 +8,16 @@
namespace yii\mail; namespace yii\mail;
/** /**
* MailerInterface is an interface, which any mailer should apply. * MailerInterface is the interface that should be implemented by mailer classes.
* Mailer creates and sends messages. Also it allows composition of the message
* body via view rendering:
* *
* ~~~php * A mailer should mainly support creating and sending [[MessageInterface|mail messages]]. It should
* also support composition of the message body through the view rendering mechanism. For example,
*
* ~~~
* Yii::$app->mail->compose('contact/html', ['contactForm' => $form]) * Yii::$app->mail->compose('contact/html', ['contactForm' => $form])
* ->from('from@domain.com') * ->setFrom('from@domain.com')
* ->to($form->email) * ->setTo($form->email)
* ->subject($form->subject) * ->setSubject($form->subject)
* ->send(); * ->send();
* ~~~ * ~~~
* *
@ -28,17 +29,16 @@ namespace yii\mail;
interface MailerInterface interface MailerInterface
{ {
/** /**
* Creates new message optionally filling up its body via view rendering. * Creates a new message instance and optionally composes its body content via view rendering.
* The view to be rendered can be specified in one of the following formats:
*
* - path alias (e.g. "@app/mails/contact/body");
* - relative path (e.g. "contact"): the actual view file will be resolved by [[\yii\base\ViewContextInterface]].
* *
* @param string|array $view view, which should be used to render message body * @param string|array $view the view to be used for rendering the message body. This can be:
* *
* - if string - the view name or the path alias of the HTML body view file, in this case * - a string, which represents the view name or path alias for rendering the HTML body of the email.
* text body will be composed automatically from html one. * In this case, the text body will be generated by applying `strip_tags()` to the HTML body.
* - if array - list of views for each body type in format: ['html' => 'htmlView', 'text' => 'textView'] * - an array with 'html' and/or 'text' elements. The 'html' element refers to the view name or path alias
* for rendering the HTML body, while 'text' element is for rendering the text body. For example,
* `['html' => 'contact-html', 'text' => 'contact-text']`.
* - null, meaning the message instance will be returned without body content.
* *
* @param array $params the parameters (name-value pairs) that will be extracted and made available in the view file. * @param array $params the parameters (name-value pairs) that will be extracted and made available in the view file.
* @return MessageInterface message instance. * @return MessageInterface message instance.
@ -47,17 +47,18 @@ interface MailerInterface
/** /**
* Sends the given email message. * Sends the given email message.
* @param object $message email message instance * @param MessageInterface $message email message instance to be sent
* @return boolean whether the message has been sent. * @return boolean whether the message has been sent successfully
*/ */
public function send($message); public function send($message);
/** /**
* Sends a couple of messages at once. * Sends multiple messages at once.
* Note: some particular mailers may benefit from sending messages as batch, *
* saving resources, for example on open/close connection operations. * This method may be implemented by some mailers which support more efficient way of sending multiple messages in the same batch.
*
* @param array $messages list of email messages, which should be sent. * @param array $messages list of email messages, which should be sent.
* @return integer number of successful sends. * @return integer number of messages that are successfully sent.
*/ */
public function sendMultiple(array $messages); public function sendMultiple(array $messages);
} }

111
framework/yii/mail/MessageInterface.php
Unescape View File

@ -8,17 +8,20 @@
namespace yii\mail; namespace yii\mail;
/** /**
* MessageInterface is an interface, which email message should apply. * MessageInterface is the interface that should be implemented by mail message classes.
* Together with application component, which matches the [[MailerInterface]],
* it introduces following mail sending syntax:
* *
* ~~~php * A message represents the settings and content of an email, such as the sender, recipient,
* subject, body, etc.
*
* Messages are sent by a [[MailerInterface||mailer]], like the following,
*
* ~~~
* Yii::$app->mail->compose() * Yii::$app->mail->compose()
* ->from('from@domain.com') * ->setFrom('from@domain.com')
* ->to('to@domain.com') * ->setTo($form->email)
* ->subject('Message Subject') * ->setSubject($form->subject)
* ->textBody('Plain text content') * ->setTextBody('Plain text content')
* ->htmlBody('<b>HTML content</b>') * ->setHtmlBody('<b>HTML content</b>')
* ->send(); * ->send();
* ~~~ * ~~~
* *
@ -30,72 +33,124 @@ namespace yii\mail;
interface MessageInterface interface MessageInterface
{ {
/** /**
* Set the character set of this message. * Returns the character set of this message.
* @return string the character set of this message.
*/
public function getCharset();
/**
* Sets the character set of this message.
* @param string $charset character set name. * @param string $charset character set name.
* @return static self reference. * @return static self reference.
*/ */
public function charset($charset); public function setCharset($charset);
/**
* Returns the message sender.
* @return string the sender
*/
public function getFrom();
/** /**
* Sets message sender. * Sets the message sender.
* @param string|array $from sender email address. * @param string|array $from sender email address.
* You may pass an array of addresses if this message is from multiple people. * You may pass an array of addresses if this message is from multiple people.
* You may also specify sender name in addition to email address using format: * You may also specify sender name in addition to email address using format:
* [email => name]. * `[email => name]`.
* @return static self reference. * @return static self reference.
*/ */
public function from($from); public function setFrom($from);
/** /**
* Sets message receiver. * Returns the message recipient(s).
* @return array the message recipients
*/
public function getTo();
/**
* Sets the message recipient(s).
* @param string|array $to receiver email address. * @param string|array $to receiver email address.
* You may pass an array of addresses if multiple recipients should receive this message. * You may pass an array of addresses if multiple recipients should receive this message.
* You may also specify receiver name in addition to email address using format: * You may also specify receiver name in addition to email address using format:
* [email => name]. * `[email => name]`.
* @return static self reference.
*/
public function setTo($to);
/**
* Returns the reply-to address of this message.
* @return string the reply-to address of this message.
*/
public function getReplyTo();
/**
* Sets the reply-to address of this message.
* @param string|array $replyTo the reply-to address.
* You may pass an array of addresses if this message should be replied to multiple people.
* You may also specify reply-to name in addition to email address using format:
* `[email => name]`.
* @return static self reference. * @return static self reference.
*/ */
public function to($to); public function setReplyTo($replyTo);
/**
* Returns the Cc (additional copy receiver) addresses of this message.
* @return array the Cc (additional copy receiver) addresses of this message.
*/
public function getCc();
/** /**
* Set the Cc (additional copy receiver) addresses of this message. * Sets the Cc (additional copy receiver) addresses of this message.
* @param string|array $cc copy receiver email address. * @param string|array $cc copy receiver email address.
* You may pass an array of addresses if multiple recipients should receive this message. * You may pass an array of addresses if multiple recipients should receive this message.
* You may also specify receiver name in addition to email address using format: * You may also specify receiver name in addition to email address using format:
* [email => name]. * `[email => name]`.
* @return static self reference. * @return static self reference.
*/ */
public function cc($cc); public function setCc($cc);
/**
* Returns the Bcc (hidden copy receiver) addresses of this message.
* @return array the Bcc (hidden copy receiver) addresses of this message.
*/
public function getBcc();
/** /**
* Set the Bcc (hidden copy receiver) addresses of this message. * Sets the Bcc (hidden copy receiver) addresses of this message.
* @param string|array $bcc hidden copy receiver email address. * @param string|array $bcc hidden copy receiver email address.
* You may pass an array of addresses if multiple recipients should receive this message. * You may pass an array of addresses if multiple recipients should receive this message.
* You may also specify receiver name in addition to email address using format: * You may also specify receiver name in addition to email address using format:
* [email => name]. * `[email => name]`.
* @return static self reference. * @return static self reference.
*/ */
public function bcc($bcc); public function setBcc($bcc);
/**
* Returns the message subject.
* @return string the message subject
*/
public function getSubject();
/** /**
* Sets message subject. * Sets the message subject.
* @param string $subject message subject * @param string $subject message subject
* @return static self reference. * @return static self reference.
*/ */
public function subject($subject); public function setSubject($subject);
/** /**
* Sets message plain text content. * Sets message plain text content.
* @param string $text message plain text content. * @param string $text message plain text content.
* @return static self reference. * @return static self reference.
*/ */
public function textBody($text); public function setTextBody($text);
/** /**
* Sets message HTML content. * Sets message HTML content.
* @param string $html message HTML content. * @param string $html message HTML content.
* @return static self reference. * @return static self reference.
*/ */
public function htmlBody($html); public function setHtmlBody($html);
/** /**
* Attaches existing file to the email message. * Attaches existing file to the email message.
@ -149,7 +204,7 @@ interface MessageInterface
/** /**
* Sends this email message. * Sends this email message.
* @return boolean success. * @return boolean whether this message is sent successfully.
*/ */
public function send(); public function send();

70
tests/unit/extensions/swiftmailer/MessageTest.php
Unescape View File

@ -124,11 +124,11 @@ class MessageTest extends VendorTestCase
$bcc = 'bccuser@somedomain.com'; $bcc = 'bccuser@somedomain.com';
$messageString = $this->createTestMessage() $messageString = $this->createTestMessage()
->charset($charset) ->setCharset($charset)
->subject($subject) ->setSubject($subject)
->to($to) ->setTo($to)
->cc($cc) ->setCc($cc)
->bcc($bcc) ->setBcc($bcc)
->toString(); ->toString();
$this->assertContains('charset=' . $charset, $messageString, 'Incorrect charset!'); $this->assertContains('charset=' . $charset, $messageString, 'Incorrect charset!');
@ -145,7 +145,7 @@ class MessageTest extends VendorTestCase
{ {
$from = 'someuser@somedomain.com'; $from = 'someuser@somedomain.com';
$messageString = $this->createTestMessage() $messageString = $this->createTestMessage()
->from($from) ->setFrom($from)
->toString(); ->toString();
$this->assertContains('From: ' . $from, $messageString, 'Incorrect "From" header!'); $this->assertContains('From: ' . $from, $messageString, 'Incorrect "From" header!');
$this->assertContains('Reply-To: ' . $from, $messageString, 'Incorrect "Reply-To" header!'); $this->assertContains('Reply-To: ' . $from, $messageString, 'Incorrect "Reply-To" header!');
@ -157,10 +157,10 @@ class MessageTest extends VendorTestCase
public function testSend() public function testSend()
{ {
$message = $this->createTestMessage(); $message = $this->createTestMessage();
$message->to($this->testEmailReceiver); $message->setTo($this->testEmailReceiver);
$message->from('someuser@somedomain.com'); $message->setFrom('someuser@somedomain.com');
$message->subject('Yii Swift Test'); $message->setSubject('Yii Swift Test');
$message->textBody('Yii Swift Test body'); $message->setTextBody('Yii Swift Test body');
$this->assertTrue($message->send()); $this->assertTrue($message->send());
} }
@ -171,10 +171,10 @@ class MessageTest extends VendorTestCase
{ {
$message = $this->createTestMessage(); $message = $this->createTestMessage();
$message->to($this->testEmailReceiver); $message->setTo($this->testEmailReceiver);
$message->from('someuser@somedomain.com'); $message->setFrom('someuser@somedomain.com');
$message->subject('Yii Swift Attach File Test'); $message->setSubject('Yii Swift Attach File Test');
$message->textBody('Yii Swift Attach File Test body'); $message->setTextBody('Yii Swift Attach File Test body');
$fileName = __FILE__; $fileName = __FILE__;
$message->attach($fileName); $message->attach($fileName);
@ -192,10 +192,10 @@ class MessageTest extends VendorTestCase
{ {
$message = $this->createTestMessage(); $message = $this->createTestMessage();
$message->to($this->testEmailReceiver); $message->setTo($this->testEmailReceiver);
$message->from('someuser@somedomain.com'); $message->setFrom('someuser@somedomain.com');
$message->subject('Yii Swift Create Attachment Test'); $message->setSubject('Yii Swift Create Attachment Test');
$message->textBody('Yii Swift Create Attachment Test body'); $message->setTextBody('Yii Swift Create Attachment Test body');
$fileName = 'test.txt'; $fileName = 'test.txt';
$fileContent = 'Test attachment content'; $fileContent = 'Test attachment content';
$message->attachContent($fileContent, ['fileName' => $fileName]); $message->attachContent($fileContent, ['fileName' => $fileName]);
@ -218,10 +218,10 @@ class MessageTest extends VendorTestCase
$cid = $message->embed($fileName); $cid = $message->embed($fileName);
$message->to($this->testEmailReceiver); $message->setTo($this->testEmailReceiver);
$message->from('someuser@somedomain.com'); $message->setFrom('someuser@somedomain.com');
$message->subject('Yii Swift Embed File Test'); $message->setSubject('Yii Swift Embed File Test');
$message->htmlBody('Embed image: <img src="' . $cid. '" alt="pic">'); $message->setHtmlBody('Embed image: <img src="' . $cid. '" alt="pic">');
$this->assertTrue($message->send()); $this->assertTrue($message->send());
@ -244,10 +244,10 @@ class MessageTest extends VendorTestCase
$cid = $message->embedContent($fileContent, ['fileName' => $fileName, 'contentType' => $contentType]); $cid = $message->embedContent($fileContent, ['fileName' => $fileName, 'contentType' => $contentType]);
$message->to($this->testEmailReceiver); $message->setTo($this->testEmailReceiver);
$message->from('someuser@somedomain.com'); $message->setFrom('someuser@somedomain.com');
$message->subject('Yii Swift Embed File Test'); $message->setSubject('Yii Swift Embed File Test');
$message->htmlBody('Embed image: <img src="' . $cid. '" alt="pic">'); $message->setHtmlBody('Embed image: <img src="' . $cid. '" alt="pic">');
$this->assertTrue($message->send()); $this->assertTrue($message->send());
@ -264,11 +264,11 @@ class MessageTest extends VendorTestCase
{ {
$message = $this->createTestMessage(); $message = $this->createTestMessage();
$message->to($this->testEmailReceiver); $message->setTo($this->testEmailReceiver);
$message->from('someuser@somedomain.com'); $message->setFrom('someuser@somedomain.com');
$message->subject('Yii Swift Alternative Body Test'); $message->setSubject('Yii Swift Alternative Body Test');
$message->htmlBody('<b>Yii Swift</b> test HTML body'); $message->setHtmlBody('<b>Yii Swift</b> test HTML body');
$message->textBody('Yii Swift test plain text body'); $message->setTextBody('Yii Swift test plain text body');
$this->assertTrue($message->send()); $this->assertTrue($message->send());
@ -297,10 +297,10 @@ class MessageTest extends VendorTestCase
{ {
$message = $this->createTestMessage(); $message = $this->createTestMessage();
$message->to($this->testEmailReceiver); $message->setTo($this->testEmailReceiver);
$message->from('someuser@somedomain.com'); $message->setFrom('someuser@somedomain.com');
$message->subject('Yii Swift Alternative Body Test'); $message->setSubject('Yii Swift Alternative Body Test');
$message->textBody('Yii Swift test plain text body'); $message->setTextBody('Yii Swift test plain text body');
$serializedMessage = serialize($message); $serializedMessage = serialize($message);
$this->assertNotEmpty($serializedMessage, 'Unable to serialize message!'); $this->assertNotEmpty($serializedMessage, 'Unable to serialize message!');

16
tests/unit/framework/mail/BaseMailerTest.php
Unescape View File

@ -240,49 +240,49 @@ class Message extends BaseMessage
public $_textBody; public $_textBody;
public $_htmlBody; public $_htmlBody;
public function charset($charset) public function setCharset($charset)
{ {
$this->_charset = $charset; $this->_charset = $charset;
return $this; return $this;
} }
public function from($from) public function setFrom($from)
{ {
$this->_from = $from; $this->_from = $from;
return $this; return $this;
} }
public function to($to) public function setTo($to)
{ {
$this->_to = $to; $this->_to = $to;
return $this; return $this;
} }
public function cc($cc) public function setCc($cc)
{ {
$this->_cc = $cc; $this->_cc = $cc;
return $this; return $this;
} }
public function bcc($bcc) public function setBcc($bcc)
{ {
$this->_bcc = $bcc; $this->_bcc = $bcc;
return $this; return $this;
} }
public function subject($subject) public function setSubject($subject)
{ {
$this->_subject = $subject; $this->_subject = $subject;
return $this; return $this;
} }
public function textBody($text) public function setTextBody($text)
{ {
$this->_textBody = $text; $this->_textBody = $text;
return $this; return $this;
} }
public function htmlBody($html) public function setHtmlBody($html)
{ {
$this->_htmlBody = $html; $this->_htmlBody = $html;
return $this; return $this;

16
tests/unit/framework/mail/BaseMessageTest.php
Unescape View File

@ -85,23 +85,23 @@ class TestMessage extends BaseMessage
public $text; public $text;
public $html; public $html;
public function charset($charset) {} public function setCharset($charset) {}
public function from($from) {} public function setFrom($from) {}
public function to($to) {} public function setTo($to) {}
public function cc($cc) {} public function setCc($cc) {}
public function bcc($bcc) {} public function setBcc($bcc) {}
public function subject($subject) {} public function setSubject($subject) {}
public function textBody($text) { public function setTextBody($text) {
$this->text = $text; $this->text = $text;
} }
public function htmlBody($html) { public function setHtmlBody($html) {
$this->html = $html; $this->html = $html;
} }

Write Preview
Loading…
Cancel
Save