|
|
|
<?php
|
|
|
|
/**
|
|
|
|
* @link http://www.yiiframework.com/
|
|
|
|
* @copyright Copyright (c) 2008 Yii Software LLC
|
|
|
|
* @license http://www.yiiframework.com/license/
|
|
|
|
*/
|
|
|
|
|
|
|
|
namespace yii\mail;
|
|
|
|
|
|
|
|
use yii\base\InvalidParamException;
|
|
|
|
use yii\base\Object;
|
|
|
|
use yii\helpers\FileHelper;
|
|
|
|
use Yii;
|
|
|
|
|
|
|
|
/**
|
|
|
|
* BaseMessage represent the single email message.
|
|
|
|
* It functionality depends on application component 'email',
|
|
|
|
* which should provide the actual email sending functionality as well as
|
|
|
|
* default message configuration.
|
|
|
|
*
|
|
|
|
* @see BaseMailer
|
|
|
|
*
|
|
|
|
* @property \yii\mail\BaseMailer $mailer mailer component instance. This property is read-only.
|
|
|
|
* @property string|array $from sender email address.
|
|
|
|
* @property string|array $to receiver email address.
|
|
|
|
* @property string|array $cc copy receiver email address.
|
|
|
|
* @property string|array $bcc hidden copy receiver email address.
|
|
|
|
* @property string $subject message subject.
|
|
|
|
* @property string $text message plain text content.
|
|
|
|
* @property string $html message HTML content.
|
|
|
|
*
|
|
|
|
* @author Paul Klimov <klimov.paul@gmail.com>
|
|
|
|
* @since 2.0
|
|
|
|
*/
|
|
|
|
abstract class BaseMessage extends Object implements MessageInterface
|
|
|
|
{
|
|
|
|
/**
|
|
|
|
* @return \yii\mail\BaseMailer
|
|
|
|
*/
|
|
|
|
public function getMailer()
|
|
|
|
{
|
|
|
|
return Yii::$app->getComponent('email');
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Initializes the object.
|
|
|
|
* This method is invoked at the end of the constructor after the object is initialized with the
|
|
|
|
* given configuration.
|
|
|
|
*/
|
|
|
|
public function init()
|
|
|
|
{
|
|
|
|
Yii::configure($this, $this->getMailer()->messageConfig);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @inheritdoc
|
|
|
|
*/
|
|
|
|
public function send()
|
|
|
|
{
|
|
|
|
return $this->getMailer()->send($this);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @inheritdoc
|
|
|
|
*/
|
|
|
|
public function attachFile($fileName, $contentType = null, $attachFileName = null)
|
|
|
|
{
|
|
|
|
if (!file_exists($fileName)) {
|
|
|
|
throw new InvalidParamException('Unable to attach file "' . $fileName . '": file does not exists!');
|
|
|
|
}
|
|
|
|
if (empty($contentType)) {
|
|
|
|
$contentType = FileHelper::getMimeType($fileName);
|
|
|
|
}
|
|
|
|
if (empty($attachFileName)) {
|
|
|
|
$attachFileName = basename($fileName);
|
|
|
|
}
|
|
|
|
$content = file_get_contents($fileName);
|
|
|
|
$this->attachContentAsFile($content, $attachFileName, $contentType);
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* @inheritdoc
|
|
|
|
*/
|
|
|
|
public function render($view, $params = [])
|
|
|
|
{
|
|
|
|
return $this->getMailer()->render($view, $params);
|
|
|
|
}
|
|
|
|
}
|