init

vendor/yiisoft/yii2-swiftmailer/CHANGELOG.md

@@ -0,0 +1,72 @@
+Yii Framework 2 swiftmailer extension Change Log
+================================================
+
+2.0.7 May 01, 2017
+------------------
+
+- Bug #46: Fixed `yii\swiftmailer\Message` does not clones `$swiftMessage` during its own cloning (evpav, klimov-paul)
+- Enh #37: `yii\swiftmailer\Logger` now chooses logging level depending on incoming entry format (klimov-paul)
+- Enh #40: Added `yii\swiftmailer\Message::setHeaders()` allowing to setup custom headers in batch (klimov-paul)
+
+
+2.0.6 September 09, 2016
+------------------------
+
+- Enh #6: Added ability to specify custom mail header at `yii\swiftmailer\Message` (klimov-paul)
+- Enh #23: Added `yii\swiftmailer\Message::setReturnPath()` shortcut method (klimov-paul)
+- Enh #27: Added ability to specify message signature (klimov-paul)
+- Enh #32: Added `yii\swiftmailer\Message::setReadReceiptTo()` shortcut method (klimov-paul)
+- Enh: Added `yii\swiftmailer\Message::setPriority()` shortcut method (klimov-paul)
+
+
+2.0.5 March 17, 2016
+--------------------
+
+- Bug #9: Fixed `Mailer` does not check if property is public, while configuring 'Swift' object (brandonkelly, klimov-paul)
+
+
+2.0.4 May 10, 2015
+------------------
+
+- Enh #4: Added ability to pass SwiftMailer log entries to `Yii::info()` (klimov-paul)
+
+
+2.0.3 March 01, 2015
+--------------------
+
+- no changes in this release.
+
+
+2.0.2 January 11, 2015
+----------------------
+
+- no changes in this release.
+
+
+2.0.1 December 07, 2014
+-----------------------
+
+- no changes in this release.
+
+
+2.0.0 October 12, 2014
+----------------------
+
+- no changes in this release.
+
+
+2.0.0-rc September 27, 2014
+---------------------------
+
+- no changes in this release.
+
+
+2.0.0-beta April 13, 2014
+-------------------------
+
+- Bug #1817: Message charset not applied for alternative bodies (klimov-paul)
+
+2.0.0-alpha, December 1, 2013
+-----------------------------
+
+- Initial release.

vendor/yiisoft/yii2-swiftmailer/LICENSE.md

@@ -0,0 +1,32 @@
+The Yii framework is free software. It is released under the terms of
+the following BSD License.
+
+Copyright © 2008-2013 by Yii Software LLC (http://www.yiisoft.com)
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+
+ * Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+ * Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in
+   the documentation and/or other materials provided with the
+   distribution.
+ * Neither the name of Yii Software LLC nor the names of its
+   contributors may be used to endorse or promote products derived
+   from this software without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
+"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
+LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
+FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
+COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
+INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
+BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
+LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
+CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
+LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
+ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.

vendor/yiisoft/yii2-swiftmailer/Logger.php

@@ -0,0 +1,76 @@
+<?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+namespace yii\swiftmailer;
+
+use Yii;
+
+/**
+ * Logger is a SwiftMailer plugin, which allows passing of the SwiftMailer internal logs to the
+ * Yii logging mechanism. Each native SwiftMailer log message will be converted into Yii 'info' log entry.
+ *
+ * In order to catch logs written by this class, you need to setup a log route for 'yii\swiftmailer\Logger::add' category.
+ * For example:
+ *
+ * ~~~
+ * 'log' => [
+ *     'targets' => [
+ *         [
+ *             'class' => 'yii\log\FileTarget',
+ *             'categories' => ['yii\swiftmailer\Logger::add'],
+ *         ],
+ *     ],
+ * ],
+ * ~~~
+ *
+ * @author Paul Klimov <klimov.paul@gmail.com>
+ * @since 2.0
+ */
+class Logger implements \Swift_Plugins_Logger
+{
+    /**
+     * @inheritdoc
+     */
+    public function add($entry)
+    {
+        $categoryPrefix = substr($entry, 0, 2);
+        switch ($categoryPrefix) {
+            case '++':
+                $level = \yii\log\Logger::LEVEL_TRACE;
+                break;
+            case '>>':
+            case '<<':
+                $level = \yii\log\Logger::LEVEL_INFO;
+                break;
+            case '!!':
+                $level = \yii\log\Logger::LEVEL_WARNING;
+                break;
+        }
+
+        if (!isset($level)) {
+            $level = \yii\log\Logger::LEVEL_INFO;
+        }
+
+        Yii::getLogger()->log($entry, $level, __METHOD__);
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function clear()
+    {
+        // do nothing
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function dump()
+    {
+        return '';
+    }
+}

vendor/yiisoft/yii2-swiftmailer/Mailer.php

@@ -0,0 +1,249 @@
+<?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+namespace yii\swiftmailer;
+
+use Yii;
+use yii\base\InvalidConfigException;
+use yii\mail\BaseMailer;
+
+/**
+ * Mailer implements a mailer based on SwiftMailer.
+ *
+ * To use Mailer, you should configure it in the application configuration like the following,
+ *
+ * ~~~
+ * 'components' => [
+ *     ...
+ *     'mailer' => [
+ *         'class' => 'yii\swiftmailer\Mailer',
+ *         'transport' => [
+ *             'class' => 'Swift_SmtpTransport',
+ *             'host' => 'localhost',
+ *             'username' => 'username',
+ *             'password' => 'password',
+ *             'port' => '587',
+ *             'encryption' => 'tls',
+ *         ],
+ *     ],
+ *     ...
+ * ],
+ * ~~~
+ *
+ * You may also skip the configuration of the [[transport]] property. In that case, the default
+ * PHP `mail()` function will be used to send emails.
+ *
+ * You specify the transport constructor arguments using 'constructArgs' key in the config.
+ * You can also specify the list of plugins, which should be registered to the transport using
+ * 'plugins' key. For example:
+ *
+ * ~~~
+ * 'transport' => [
+ *     'class' => 'Swift_SmtpTransport',
+ *     'constructArgs' => ['localhost', 25]
+ *     'plugins' => [
+ *         [
+ *             'class' => 'Swift_Plugins_ThrottlerPlugin',
+ *             'constructArgs' => [20],
+ *         ],
+ *     ],
+ * ],
+ * ~~~
+ *
+ * To send an email, you may use the following code:
+ *
+ * ~~~
+ * Yii::$app->mailer->compose('contact/html', ['contactForm' => $form])
+ *     ->setFrom('from@domain.com')
+ *     ->setTo($form->email)
+ *     ->setSubject($form->subject)
+ *     ->send();
+ * ~~~
+ *
+ * @see http://swiftmailer.org
+ *
+ * @property array|\Swift_Mailer $swiftMailer Swift mailer instance or array configuration. This property is
+ * read-only.
+ * @property array|\Swift_Transport $transport This property is read-only.
+ *
+ * @author Paul Klimov <klimov.paul@gmail.com>
+ * @since 2.0
+ */
+class Mailer extends BaseMailer
+{
+    /**
+     * @var string message default class name.
+     */
+    public $messageClass = 'yii\swiftmailer\Message';
+    /**
+     * @var bool whether to enable writing of the SwiftMailer internal logs using Yii log mechanism.
+     * If enabled [[Logger]] plugin will be attached to the [[transport]] for this purpose.
+     * @see Logger
+     */
+    public $enableSwiftMailerLogging = false;
+
+    /**
+     * @var \Swift_Mailer Swift mailer instance.
+     */
+    private $_swiftMailer;
+    /**
+     * @var \Swift_Transport|array Swift transport instance or its array configuration.
+     */
+    private $_transport = [];
+
+
+    /**
+     * @return array|\Swift_Mailer Swift mailer instance or array configuration.
+     */
+    public function getSwiftMailer()
+    {
+        if (!is_object($this->_swiftMailer)) {
+            $this->_swiftMailer = $this->createSwiftMailer();
+        }
+
+        return $this->_swiftMailer;
+    }
+
+    /**
+     * @param array|\Swift_Transport $transport
+     * @throws InvalidConfigException on invalid argument.
+     */
+    public function setTransport($transport)
+    {
+        if (!is_array($transport) && !is_object($transport)) {
+            throw new InvalidConfigException('"' . get_class($this) . '::transport" should be either object or array, "' . gettype($transport) . '" given.');
+        }
+        $this->_transport = $transport;
+    }
+
+    /**
+     * @return array|\Swift_Transport
+     */
+    public function getTransport()
+    {
+        if (!is_object($this->_transport)) {
+            $this->_transport = $this->createTransport($this->_transport);
+        }
+
+        return $this->_transport;
+    }
+
+    /**
+     * @inheritdoc
+     */
+    protected function sendMessage($message)
+    {
+        $address = $message->getTo();
+        if (is_array($address)) {
+            $address = implode(', ', array_keys($address));
+        }
+        Yii::info('Sending email "' . $message->getSubject() . '" to "' . $address . '"', __METHOD__);
+
+        return $this->getSwiftMailer()->send($message->getSwiftMessage()) > 0;
+    }
+
+    /**
+     * Creates Swift mailer instance.
+     * @return \Swift_Mailer mailer instance.
+     */
+    protected function createSwiftMailer()
+    {
+        return \Swift_Mailer::newInstance($this->getTransport());
+    }
+
+    /**
+     * Creates email transport instance by its array configuration.
+     * @param array $config transport configuration.
+     * @throws \yii\base\InvalidConfigException on invalid transport configuration.
+     * @return \Swift_Transport transport instance.
+     */
+    protected function createTransport(array $config)
+    {
+        if (!isset($config['class'])) {
+            $config['class'] = 'Swift_MailTransport';
+        }
+        if (isset($config['plugins'])) {
+            $plugins = $config['plugins'];
+            unset($config['plugins']);
+        } else {
+            $plugins = [];
+        }
+
+        if ($this->enableSwiftMailerLogging) {
+            $plugins[] = [
+                'class' => 'Swift_Plugins_LoggerPlugin',
+                'constructArgs' => [
+                    [
+                        'class' => 'yii\swiftmailer\Logger'
+                    ]
+                ],
+            ];
+        }
+
+        /* @var $transport \Swift_MailTransport */
+        $transport = $this->createSwiftObject($config);
+        if (!empty($plugins)) {
+            foreach ($plugins as $plugin) {
+                if (is_array($plugin) && isset($plugin['class'])) {
+                    $plugin = $this->createSwiftObject($plugin);
+                }
+                $transport->registerPlugin($plugin);
+            }
+        }
+
+        return $transport;
+    }
+
+    /**
+     * Creates Swift library object, from given array configuration.
+     * @param array $config object configuration
+     * @return Object created object
+     * @throws \yii\base\InvalidConfigException on invalid configuration.
+     */
+    protected function createSwiftObject(array $config)
+    {
+        if (isset($config['class'])) {
+            $className = $config['class'];
+            unset($config['class']);
+        } else {
+            throw new InvalidConfigException('Object configuration must be an array containing a "class" element.');
+        }
+
+        if (isset($config['constructArgs'])) {
+            $args = [];
+            foreach ($config['constructArgs'] as $arg) {
+                if (is_array($arg) && isset($arg['class'])) {
+                    $args[] = $this->createSwiftObject($arg);
+                } else {
+                    $args[] = $arg;
+                }
+            }
+            unset($config['constructArgs']);
+            $object = Yii::createObject($className, $args);
+        } else {
+            $object = Yii::createObject($className);
+        }
+
+        if (!empty($config)) {
+            $reflection = new \ReflectionObject($object);
+            foreach ($config as $name => $value) {
+                if ($reflection->hasProperty($name) && $reflection->getProperty($name)->isPublic()) {
+                    $object->$name = $value;
+                } else {
+                    $setter = 'set' . $name;
+                    if ($reflection->hasMethod($setter) || $reflection->hasMethod('__call')) {
+                        $object->$setter($value);
+                    } else {
+                        throw new InvalidConfigException('Setting unknown property: ' . $className . '::' . $name);
+                    }
+                }
+            }
+        }
+
+        return $object;
+    }
+}

vendor/yiisoft/yii2-swiftmailer/Makefile

@@ -0,0 +1,26 @@
+
+# default versions to test against
+# these can be overridden by setting the environment variables in the shell
+PHP_VERSION=php-5.6.8
+YII_VERSION=dev-master
+
+# ensure all the configuration variables above are in environment of the shell commands below
+export
+
+help:
+	@echo "make test    - run phpunit tests using a docker environment"
+#	@echo "make clean   - stop docker and remove container"
+
+test: docker-php
+	composer require "yiisoft/yii2:${YII_VERSION}" --prefer-dist
+	composer install --prefer-dist
+	docker run --rm=true -v $(shell pwd):/opt/test yiitest/php:${PHP_VERSION} phpunit --verbose --color
+
+docker-php: dockerfiles
+	cd tests/docker/php && sh build.sh
+
+dockerfiles:
+	test -d tests/docker || git clone https://github.com/cebe/jenkins-test-docker tests/docker
+	cd tests/docker && git checkout -- . && git pull
+	mkdir -p tests/dockerids
+

vendor/yiisoft/yii2-swiftmailer/Message.php

@@ -0,0 +1,578 @@
+<?php
+/**
+ * @link http://www.yiiframework.com/
+ * @copyright Copyright (c) 2008 Yii Software LLC
+ * @license http://www.yiiframework.com/license/
+ */
+
+namespace yii\swiftmailer;
+
+use Yii;
+use yii\base\InvalidConfigException;
+use yii\helpers\ArrayHelper;
+use yii\mail\BaseMessage;
+
+/**
+ * Message implements a message class based on SwiftMailer.
+ *
+ * @see http://swiftmailer.org/docs/messages.html
+ * @see Mailer
+ *
+ * @method Mailer getMailer() returns mailer instance.
+ *
+ * @property array $headers Headers in format: `[name => value]`. This property is write-only.
+ * @property int $priority Priority value as integer in range: `1..5`, where 1 is the highest priority and 5
+ * is the lowest.
+ * @property string $readReceiptTo Receipt receive email addresses. Note that the type of this property
+ * differs in getter and setter. See [[getReadReceiptTo()]] and [[setReadReceiptTo()]] for details.
+ * @property string $returnPath The bounce email address.
+ * @property array|callable|\Swift_Signer $signature Signature specification. See [[addSignature()]] for
+ * details on how it should be specified. This property is write-only.
+ * @property \Swift_Message $swiftMessage Swift message instance. This property is read-only.
+ *
+ * @author Paul Klimov <klimov.paul@gmail.com>
+ * @since 2.0
+ */
+class Message extends BaseMessage
+{
+    /**
+     * @var \Swift_Message Swift message instance.
+     */
+    private $_swiftMessage;
+    /**
+     * @var \Swift_Signer[] attached signers
+     */
+    private $signers = [];
+
+
+    /**
+     * This method is called after the object is created by cloning an existing one.
+     * It ensures [[swiftMessage]] is also cloned.
+     * @since 2.0.7
+     */
+    public function __clone()
+    {
+        if (is_object($this->_swiftMessage)) {
+            $this->_swiftMessage = clone $this->_swiftMessage;
+        }
+    }
+
+    /**
+     * @return \Swift_Message Swift message instance.
+     */
+    public function getSwiftMessage()
+    {
+        if (!is_object($this->_swiftMessage)) {
+            $this->_swiftMessage = $this->createSwiftMessage();
+        }
+
+        return $this->_swiftMessage;
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function getCharset()
+    {
+        return $this->getSwiftMessage()->getCharset();
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function setCharset($charset)
+    {
+        $this->getSwiftMessage()->setCharset($charset);
+
+        return $this;
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function getFrom()
+    {
+        return $this->getSwiftMessage()->getFrom();
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function setFrom($from)
+    {
+        $this->getSwiftMessage()->setFrom($from);
+
+        return $this;
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function getReplyTo()
+    {
+        return $this->getSwiftMessage()->getReplyTo();
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function setReplyTo($replyTo)
+    {
+        $this->getSwiftMessage()->setReplyTo($replyTo);
+
+        return $this;
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function getTo()
+    {
+        return $this->getSwiftMessage()->getTo();
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function setTo($to)
+    {
+        $this->getSwiftMessage()->setTo($to);
+
+        return $this;
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function getCc()
+    {
+        return $this->getSwiftMessage()->getCc();
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function setCc($cc)
+    {
+        $this->getSwiftMessage()->setCc($cc);
+
+        return $this;
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function getBcc()
+    {
+        return $this->getSwiftMessage()->getBcc();
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function setBcc($bcc)
+    {
+        $this->getSwiftMessage()->setBcc($bcc);
+
+        return $this;
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function getSubject()
+    {
+        return $this->getSwiftMessage()->getSubject();
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function setSubject($subject)
+    {
+        $this->getSwiftMessage()->setSubject($subject);
+
+        return $this;
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function setTextBody($text)
+    {
+        $this->setBody($text, 'text/plain');
+
+        return $this;
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function setHtmlBody($html)
+    {
+        $this->setBody($html, 'text/html');
+
+        return $this;
+    }
+
+    /**
+     * Sets the message body.
+     * If body is already set and its content type matches given one, it will
+     * be overridden, if content type miss match the multipart message will be composed.
+     * @param string $body body content.
+     * @param string $contentType body content type.
+     */
+    protected function setBody($body, $contentType)
+    {
+        $message = $this->getSwiftMessage();
+        $oldBody = $message->getBody();
+        $charset = $message->getCharset();
+        if (empty($oldBody)) {
+            $parts = $message->getChildren();
+            $partFound = false;
+            foreach ($parts as $key => $part) {
+                if (!($part instanceof \Swift_Mime_Attachment)) {
+                    /* @var $part \Swift_Mime_MimePart */
+                    if ($part->getContentType() == $contentType) {
+                        $charset = $part->getCharset();
+                        unset($parts[$key]);
+                        $partFound = true;
+                        break;
+                    }
+                }
+            }
+            if ($partFound) {
+                reset($parts);
+                $message->setChildren($parts);
+                $message->addPart($body, $contentType, $charset);
+            } else {
+                $message->setBody($body, $contentType);
+            }
+        } else {
+            $oldContentType = $message->getContentType();
+            if ($oldContentType == $contentType) {
+                $message->setBody($body, $contentType);
+            } else {
+                $message->setBody(null);
+                $message->setContentType(null);
+                $message->addPart($oldBody, $oldContentType, $charset);
+                $message->addPart($body, $contentType, $charset);
+            }
+        }
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function attach($fileName, array $options = [])
+    {
+        $attachment = \Swift_Attachment::fromPath($fileName);
+        if (!empty($options['fileName'])) {
+            $attachment->setFilename($options['fileName']);
+        }
+        if (!empty($options['contentType'])) {
+            $attachment->setContentType($options['contentType']);
+        }
+        $this->getSwiftMessage()->attach($attachment);
+
+        return $this;
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function attachContent($content, array $options = [])
+    {
+        $attachment = \Swift_Attachment::newInstance($content);
+        if (!empty($options['fileName'])) {
+            $attachment->setFilename($options['fileName']);
+        }
+        if (!empty($options['contentType'])) {
+            $attachment->setContentType($options['contentType']);
+        }
+        $this->getSwiftMessage()->attach($attachment);
+
+        return $this;
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function embed($fileName, array $options = [])
+    {
+        $embedFile = \Swift_EmbeddedFile::fromPath($fileName);
+        if (!empty($options['fileName'])) {
+            $embedFile->setFilename($options['fileName']);
+        }
+        if (!empty($options['contentType'])) {
+            $embedFile->setContentType($options['contentType']);
+        }
+
+        return $this->getSwiftMessage()->embed($embedFile);
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function embedContent($content, array $options = [])
+    {
+        $embedFile = \Swift_EmbeddedFile::newInstance($content);
+        if (!empty($options['fileName'])) {
+            $embedFile->setFilename($options['fileName']);
+        }
+        if (!empty($options['contentType'])) {
+            $embedFile->setContentType($options['contentType']);
+        }
+
+        return $this->getSwiftMessage()->embed($embedFile);
+    }
+
+    /**
+     * Sets message signature
+     * @param array|callable|\Swift_Signer $signature signature specification.
+     * See [[addSignature()]] for details on how it should be specified.
+     * @return $this self reference.
+     * @since 2.0.6
+     */
+    public function setSignature($signature)
+    {
+        if (!empty($this->signers)) {
+            // clear previously set signers
+            $swiftMessage = $this->getSwiftMessage();
+            foreach ($this->signers as $signer) {
+                $swiftMessage->detachSigner($signer);
+            }
+            $this->signers = [];
+        }
+        return $this->addSignature($signature);
+    }
+
+    /**
+     * Adds message signature.
+     * @param array|callable|\Swift_Signer $signature signature specification, this can be:
+     *
+     * - [[\Swift_Signer]] instance
+     * - callable, which returns [[\Swift_Signer]] instance
+     * - configuration array for the signer creation
+     *
+     * @return $this self reference
+     * @throws InvalidConfigException on invalid signature configuration
+     * @since 2.0.6
+     */
+    public function addSignature($signature)
+    {
+        if ($signature instanceof \Swift_Signer) {
+            $signer = $signature;
+        } elseif (is_callable($signature)) {
+            $signer = call_user_func($signature);
+        } elseif (is_array($signature)) {
+            $signer = $this->createSwiftSigner($signature);
+        } else {
+            throw new InvalidConfigException('Signature should be instance of "Swift_Signer", callable or array configuration');
+        }
+
+        $this->getSwiftMessage()->attachSigner($signer);
+        $this->signers[] = $signer;
+
+        return $this;
+    }
+
+    /**
+     * Creates signer from its configuration
+     * @param array $signature signature configuration
+     * @return \Swift_Signer signer instance
+     * @throws InvalidConfigException on invalid configuration provided
+     * @since 2.0.6
+     */
+    protected function createSwiftSigner($signature)
+    {
+        if (!isset($signature['type'])) {
+            throw new InvalidConfigException('Signature configuration should contain "type" key');
+        }
+        switch (strtolower($signature['type'])) {
+            case 'dkim' :
+                $domain = ArrayHelper::getValue($signature, 'domain', null);
+                $selector = ArrayHelper::getValue($signature, 'selector', null);
+                if (isset($signature['key'])) {
+                    $privateKey = $signature['key'];
+                } elseif (isset($signature['file'])) {
+                    $privateKey = file_get_contents(Yii::getAlias($signature['file']));
+                } else {
+                    throw new InvalidConfigException("Either 'key' or 'file' signature option should be specified");
+                }
+                return new \Swift_Signers_DKIMSigner($privateKey, $domain, $selector);
+            case 'opendkim' :
+                $domain = ArrayHelper::getValue($signature, 'domain', null);
+                $selector = ArrayHelper::getValue($signature, 'selector', null);
+                if (isset($signature['key'])) {
+                    $privateKey = $signature['key'];
+                } elseif (isset($signature['file'])) {
+                    $privateKey = file_get_contents(Yii::getAlias($signature['file']));
+                } else {
+                    throw new InvalidConfigException("Either 'key' or 'file' signature option should be specified");
+                }
+                return new \Swift_Signers_OpenDKIMSigner($privateKey, $domain, $selector);
+            default:
+                throw new InvalidConfigException("Unrecognized signature type '{$signature['type']}'");
+        }
+    }
+
+    /**
+     * @inheritdoc
+     */
+    public function toString()
+    {
+        return $this->getSwiftMessage()->toString();
+    }
+
+    /**
+     * Creates the Swift email message instance.
+     * @return \Swift_Message email message instance.
+     */
+    protected function createSwiftMessage()
+    {
+        return new \Swift_Message();
+    }
+
+    // Headers setup :
+
+    /**
+     * Adds custom header value to the message.
+     * Several invocations of this method with the same name will add multiple header values.
+     * @param string $name header name.
+     * @param string $value header value.
+     * @return $this self reference.
+     * @since 2.0.6
+     */
+    public function addHeader($name, $value)
+    {
+        $this->getSwiftMessage()->getHeaders()->addTextHeader($name, $value);
+        return $this;
+    }
+
+    /**
+     * Sets custom header value to the message.
+     * @param string $name header name.
+     * @param string|array $value header value or values.
+     * @return $this self reference.
+     * @since 2.0.6
+     */
+    public function setHeader($name, $value)
+    {
+        $headerSet = $this->getSwiftMessage()->getHeaders();
+
+        if ($headerSet->has($name)) {
+            $headerSet->remove($name);
+        }
+
+        foreach ((array)$value as $v) {
+            $headerSet->addTextHeader($name, $v);
+        }
+
+        return $this;
+    }
+
+    /**
+     * Returns all values for the specified header.
+     * @param string $name header name.
+     * @return array header values list.
+     * @since 2.0.6
+     */
+    public function getHeader($name)
+    {
+        $headerSet = $this->getSwiftMessage()->getHeaders();
+        if (!$headerSet->has($name)) {
+            return [];
+        }
+
+        $headers = [];
+        foreach ($headerSet->getAll($name) as $header) {
+            $headers[] = $header->getValue();
+        }
+        return $headers;
+    }
+
+    /**
+     * Sets custom header values to the message.
+     * @param array $headers headers in format: `[name => value]`.
+     * @return $this self reference.
+     * @since 2.0.7
+     */
+    public function setHeaders($headers)
+    {
+        foreach ($headers as $name => $value) {
+            $this->setHeader($name, $value);
+        }
+        return $this;
+    }
+
+    // SwiftMessage shortcuts :
+
+    /**
+     * Set the return-path (the bounce address) of this message.
+     * @param string $address the bounce email address.
+     * @return $this self reference.
+     * @since 2.0.6
+     */
+    public function setReturnPath($address)
+    {
+        $this->getSwiftMessage()->setReturnPath($address);
+        return $this;
+    }
+
+    /**
+     * Returns the return-path (the bounce address) of this message.
+     * @return string the bounce email address.
+     * @since 2.0.6
+     */
+    public function getReturnPath()
+    {
+        return $this->getSwiftMessage()->getReturnPath();
+    }
+
+    /**
+     * Set the priority of this message.
+     * @param int $priority priority value, should be an integer in range: `1..5`,
+     * where 1 is the highest priority and 5 is the lowest.
+     * @return $this self reference.
+     * @since 2.0.6
+     */
+    public function setPriority($priority)
+    {
+        $this->getSwiftMessage()->setPriority($priority);
+        return $this;
+    }
+
+    /**
+     * Returns the priority of this message.
+     * @return int priority value as integer in range: `1..5`,
+     * where 1 is the highest priority and 5 is the lowest.
+     * @since 2.0.6
+     */
+    public function getPriority()
+    {
+        return $this->getSwiftMessage()->getPriority();
+    }
+
+    /**
+     * Sets the ask for a delivery receipt from the recipient to be sent to $addresses.
+     * @param string|array $addresses receipt receive email address(es).
+     * @return $this self reference.
+     * @since 2.0.6
+     */
+    public function setReadReceiptTo($addresses)
+    {
+        $this->getSwiftMessage()->setReadReceiptTo($addresses);
+        return $this;
+    }
+
+    /**
+     * Get the addresses to which a read-receipt will be sent.
+     * @return string receipt receive email addresses.
+     * @since 2.0.6
+     */
+    public function getReadReceiptTo()
+    {
+        return $this->getSwiftMessage()->getReadReceiptTo();
+    }
+}

vendor/yiisoft/yii2-swiftmailer/README.md

@@ -0,0 +1,58 @@
+SwiftMailer Extension for Yii 2
+===============================
+
+This extension provides a [SwiftMailer](http://swiftmailer.org/) mail solution for [Yii framework 2.0](http://www.yiiframework.com).
+
+For license information check the [LICENSE](LICENSE.md)-file.
+
+[![Latest Stable Version](https://poser.pugx.org/yiisoft/yii2-swiftmailer/v/stable.png)](https://packagist.org/packages/yiisoft/yii2-swiftmailer)
+[![Total Downloads](https://poser.pugx.org/yiisoft/yii2-swiftmailer/downloads.png)](https://packagist.org/packages/yiisoft/yii2-swiftmailer)
+[![Build Status](https://travis-ci.org/yiisoft/yii2-swiftmailer.svg?branch=master)](https://travis-ci.org/yiisoft/yii2-swiftmailer)
+
+Installation
+------------
+
+The preferred way to install this extension is through [composer](http://getcomposer.org/download/).
+
+Either run
+
+```
+php composer.phar require --prefer-dist yiisoft/yii2-swiftmailer
+```
+
+or add
+
+```json
+"yiisoft/yii2-swiftmailer": "~2.0.0"
+```
+
+to the require section of your composer.json.
+
+Usage
+-----
+
+To use this extension,  simply add the following code in your application configuration:
+
+```php
+return [
+    //....
+    'components' => [
+        'mailer' => [
+            'class' => 'yii\swiftmailer\Mailer',
+        ],
+    ],
+];
+```
+
+You can then send an email as follows:
+
+```php
+Yii::$app->mailer->compose('contact/html')
+     ->setFrom('from@domain.com')
+     ->setTo($form->email)
+     ->setSubject($form->subject)
+     ->send();
+```
+
+For further instructions refer to the [related section in the Yii Definitive Guide](http://www.yiiframework.com/doc-2.0/guide-tutorial-mailing.html).
+

vendor/yiisoft/yii2-swiftmailer/composer.json

@@ -0,0 +1,32 @@
+{
+    "name": "yiisoft/yii2-swiftmailer",
+    "description": "The SwiftMailer integration for the Yii framework",
+    "keywords": ["yii2", "swift", "swiftmailer", "mail", "email", "mailer"],
+    "type": "yii2-extension",
+    "license": "BSD-3-Clause",
+    "support": {
+        "issues": "https://github.com/yiisoft/yii2-swiftmailer/issues",
+        "forum": "http://www.yiiframework.com/forum/",
+        "wiki": "http://www.yiiframework.com/wiki/",
+        "irc": "irc://irc.freenode.net/yii",
+        "source": "https://github.com/yiisoft/yii2-swiftmailer"
+    },
+    "authors": [
+        {
+            "name": "Paul Klimov",
+            "email": "klimov.paul@gmail.com"
+        }
+    ],
+    "require": {
+        "yiisoft/yii2": "~2.0.4",
+        "swiftmailer/swiftmailer": "~5.0"
+    },
+    "autoload": {
+        "psr-4": { "yii\\swiftmailer\\": "" }
+    },
+    "extra": {
+        "branch-alias": {
+            "dev-master": "2.0.x-dev"
+        }
+    }
+}