Skip to content

Latest commit

 

History

History
220 lines (193 loc) · 9.87 KB

276-280 Библиотека электронной почты SwiftMailer.md

File metadata and controls

220 lines (193 loc) · 9.87 KB

Библиотека электронной почты SwiftMailer

Многие веб-приложения должны отправлять уведомления и подтверждать действия клиента по электронной почте по соображениям безопасности. Yii2 предоставляет обертку yiisoft/yii2 - swiftmailer, для библиотеки SwiftMailer.

Подготовка

Создайте новое приложение с помощью диспетчера пакетов Composer, как описано в официальном руководстве по адресу http://www.yiiframework.com/doc-2.0/guide-start-installation.html. По русски http://yiiframework.domain-na.me/doc/guide/2.0/ru/start-installation Как basic, так и advances приложение содержат это расширение из коробки.

Как это сделать...

Теперь мы попробуем отправить любой вид электронной почты из нашего собственного приложения. Послание текстового сообщения

1 Установите конфигурацию почтовой программы в файле config/console.php:

'components' => [
    // ...
    'mailer' => [
        'class' => 'yii\swiftmailer\Mailer',
        'useFileTransport' => true,
    ],
    // ...
],

2 Создайте контроллер консольного теста, MailController, с помощью следующего кода:

<?php
namespace app\commands;
use yii\console\Controller;
use Yii;
class MailController extends Controller
{
    public function actionSend()
    {
        Yii::$app->mailer->compose()
            ->setTo('[email protected]')
            ->setFrom(['[email protected]' => Yii::$app->name])
            ->setSubject('My Test Message')
            ->setTextBody('My Text Body')
            ->send();
    }
}

3 Выполните следующую команду консоли:

php yii mail/send

4 Проверьте каталог runtime/mail. Он должен содержать файлы с вашими письмами.

Примечание: файлы почты содержат сообщения в специальном формате электронной почты , совместимый с любыми почтовым программное обеспечение. Это сообщение также можно открыть в виде обычного текста.

5 Задайте для параметра useFileTransport значение false или удалите эту строку из конфигурации:

'mailer' => [
    'class' => 'yii\swiftmailer\Mailer',
],

Затем поместите свой реальный идентификатор электронной почты в метод setTo ():

->setTo('[email protected]')

6 Снова выполните команду консоли:

php yii mail/send

7 Проверьте папку входящие.

Примечание: SwiftMailer использует стандартную функцию PHP mail () для отправки почты по умолчанию. Пожалуйста, проверьте это Как ваш сервер настроен для отправки почты через функцию mail(). Многие почтовые системы отклоняют письма без DKIM and SPF подписей (отправленные функцией mail() например) или помещают их в папку спама.

Отправка содержимого HTML

1 Убедитесь, что приложение содержит сообщение mail/layouts/html.php файл и добавить в mail/layouts/text.php файл со следующим содержанием:

<?php
/* @var $this \yii\web\View */
/* @var $message \yii\mail\MessageInterface */
/* @var $content string */
?>
<?php $this->beginPage() ?>
<?php $this->beginBody() ?>
<?= $content ?>
<?php $this->endBody() ?>
<?php $this->endPage() ?>

2 Создайте свой собственный вид в файле mail/message-html.php:

<?php
use yii\helpers\Html;
/* @var $this yii\web\View */
/* @var $name string */
?>
<p>Hello, <?= Html::encode($name) ?>!</p>

Создать mail/message-text.php файл с тем же содержимым, но без HTML тегов:

<?php
use yii\helpers\Html;
/* @var $this yii\web\View */
/* @var $name string */
?>
Hello, <?= Html::encode($name) ?>!

3 Создать контроллер консоли, Mailcontroller, с помощью следующего кода:

<?php
namespace app\commands;
use yii\console\Controller;
use Yii;
class MailController extends Controller
{
    public function actionSendHtml()
    {
        $name = 'John';
        Yii::$app->mailer->compose('message-html',['name' => $name])
            ->setTo('[email protected]')
            ->setFrom(['[email protected]' => Yii::$app->name])
            ->setSubject('My Test Message')
            ->send();
    }
    public function actionSendCombine()
    {
        $name = 'John';
        Yii::$app->mailer->compose(
            ['html' =>'message-html', 
             'text' => 'message-text'], 
             ['name' => $name,])
            ->setTo('[email protected]')
            ->setFrom(['[email protected]' => Yii::$app->name])
            ->setSubject('My Test Message')
            ->send();
    }
}

4 Выполните следующие команды консоли:

php yii mail/send-html
php yii mail/se
nd-combine

Работа с транспортом SMTP

1 Задайте параметр transport для компонента mailer следующим образом:

'mailer' => [
    'class' => 'yii\swiftmailer\Mailer',
    'transport' => [
        'class' => 'Swift_SmtpTransport',
        'host' => 'smtp.gmail.com',
        'username' => '[email protected]',
        'password' => 'password',
        'port' => '587',
        'encryption' => 'tls',
    ],
],

2 Напишите и запустите следующий код:

Yii::$app->mailer->compose()
    ->setTo('[email protected]')
    ->setFrom('[email protected]')
    ->setSubject('My Test Message')
    ->setTextBody('My Text Body')
    ->send();

3 Проверьте свой почтовый ящик Gmail.

Примечание. Gmail автоматически переписывает поле " От " в ваш идентификатор электронной почты профиля по умолчанию, но другие системы электронной почты не делают то же самое. Всегда используйте идентичный идентификатор электронной почты в конфигурации транспорта и в методе setFrom () для передачи политик защиты от спама для других систем электронной почты.

Прикрепление файлов и встраивание изображений

Добавьте соответствующий метод, чтобы прикрепить любой файл к вашей почте:

class MailController extends Controller
{
    public function actionSendAttach()
    {
        Yii::$app->mailer->compose()
            ->setTo('[email protected]' )
            ->setFrom(['[email protected]' => Yii::$app->name])
            ->setSubject('My Test Message')
            ->setTextBody('My Text Body')
            ->attach(Yii::getAlias('@app/README.md'))
            ->send();
    }
}

Или используйте метод embed () в файле представления электронной почты, чтобы вставить изображение в содержимое электронной почты:

<img src="<?= $message->embed($imageFile); ?>">

Он автоматически прикрепляет файл изображения и вставляет его уникальный идентификатор.

Как это работает...

Обертка реализует базовый \yii\mail\MailerInterface. Его compose () метод возвращает объект сообщения (реализация \yii\mail\MessageInterface). Вы можете вручную задать простой текст и содержимое HTML с помощью методов setTextBody () и setHtmlBody (), или вы можете передать параметры представления и представления в метод compose (). В этом случае почтовая программа вызывает метод \yii\web\view::render() для отрисовки соответствующего содержимого. Параметр useFileTransport хранит письма в файлах вместо реальной отправки. Это полезно для локальной разработки и тестирования приложений.

Смотрите так же

Для получения дополнительной информации о коде расширения yii2 - swiftmailer, посетите следующие руководства: