yii:yii2:swiftmailer []

Эта страница только для чтения. Вы можете посмотреть её исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.
====== SwiftMailer ======

Создание сообщений в Swift Mailer выполняется с помощью различных объектов MIME, предоставляемых библиотекой. Сложные сообщения могут быть быстро созданы с очень небольшими усилиями.

===== Краткая справка =====

Вы можете думать о создании сообщения как о чем-то похожем на шаги, которые вы выполняете, когда нажимаете кнопку Создать в почтовом клиенте. Вы даете ему тему, указываете некоторых получателей, добавляете любые вложения и пишете свое сообщение:



<code php>
// Create the message
$message = (new Swift_Message())

  // Give the message a subject
  ->setSubject('Your subject')

  // Set the From address with an associative array
  ->setFrom(['john@doe.com' => 'John Doe'])

  // Set the To addresses with an associative array (setTo/setCc/setBcc)
  ->setTo(['receiver@domain.org', 'other@domain.org' => 'A name'])

  // Give it a body
  ->setBody('Here is the message itself')

  // And optionally an alternative body
  ->addPart('<q>Here is the message itself</q>', 'text/html')

  // Optionally add any attachments
  ->attach(Swift_Attachment::fromPath('my-document.pdf'));
</code>

===== Основы сообщений =====

Сообщение - это контейнер для всего, что вы хотите отправить кому-то другому. Есть несколько основных аспектов сообщения, которые вы должны знать.

Сообщение электронной почты состоит из нескольких относительно простых сущностей, которые объединяются различными способами для достижения различных результатов. Все эти сущности имеют один и тот же фундаментальный контур, но служат разным целям. Само Сообщение может быть определено как сущность MIME, Вложение-это сущность MIME, все части MIME-это сущности MIME-и так далее!

Основными единицами каждой сущности MIME-будь то само сообщение или Вложение-являются ее заголовки и тело:


<code php>
Header-Name: A header value
Other-Header: Another value

The body content itself
</code>

Заголовки сущности MIME и ее тело должны соответствовать некоторым строгим стандартам, определенным различными документами RFC. Swift Mailer гарантирует, что эти спецификации выполняются с использованием различных типов объектов, включая Кодеры и различные типы заголовков для генерации сущности.

==== Структура сообщения ====

Из всех мимических сущностей сообщение-''Swift_Message''самое большое и сложное. Он имеет множество свойств, которые могут быть обновлены, и может содержать другие MIME-сущности-например, вложения-вложенные внутри него.

Сообщение имеет много различных заголовков, которые существуют для представления информации о сообщении почтовому клиенту получателей. Большинство из этих заголовков будут знакомы большинству пользователей, но мы перечислим основные из них. Хотя можно работать непосредственно с заголовками сообщения (или другой сущностью MIME), стандартные заголовки имеют методы доступа, предоставляемые для абстрагирования сложных деталей для вас. Например, хотя дата в сообщении записана в строгом формате, вам нужно только передать экземпляр ''setDate()''DateTimeInterface .

^Заголовок^Описание^Аксессоры|
|''Message-ID''|Идентифицирует это сообщение с помощью уникального идентификатора, обычно содержащего сгенерированное доменное имя и время|''getId()'' / ''setId()''|
|''Return-Path''|Указывает, куда должны идти отскоки (Swift Mailer читает это для других целей).|''getReturnPath()'' / ''setReturnPath()''|
|''From''|Указывает адрес человека, от которого пришло сообщение. Это может быть несколько адресов, если сообщение написали несколько человек.|''getFrom()'' / ''setFrom()''|
|''Sender''|Указывает адрес лица, физически отправившего сообщение (более высокий приоритет, чем''From:'').|''getSender()'' / ''setSender()''|
|''To''|Указывает адреса предполагаемых получателей|''getTo()'' / ''setTo()''|
|''Cc''|Указывает адреса получателей которые будут скопированы в сообщение|''getCc()'' / ''setCc()''|
|''Bcc''|Указывает адреса получателей, на которых будет скопировано сообщение вслепую. Другие получатели не будут знать об этих копиях.|''getBcc()'' / ''setBcc()''|
|''Reply-To''|Указывает адрес на который отправляются ответы|''getReplyTo()'' / ''setReplyTo()''|
|''Subject''|Задает строку темы, отображаемую в почтовом клиенте получателей|''getSubject()'' / ''setSubject()''|
|''Date''|Указывает дату отправки сообщения|''getDate()'' / ''setDate()''|
|''Content-Type''|Указывает формат сообщения (обычно ''text/plain''или ''text/html'').|''getContentType()'' / ''setContentType()''|
|''Content-Transfer-Encoding''|Указывает схему кодирования в сообщении|''getEncoder()'' / ''setEncoder()''|

==== Работа с объектом сообщения ====

Хотя существует много доступных методов для объекта сообщения, вам нужно использовать только небольшое их подмножество. Обычно вы будете использовать ''setSubject()'', ''setTo()''и ''setFrom()''перед установкой тела вашего сообщения с''setBody()'':

<code php>
$message = new Swift_Message();
$message->setSubject('My subject');
</code>

Все сущности MIME (включая сообщение) имеют ''toString()''метод , который можно вызвать, если вы хотите взглянуть на то, что будет отправлено. Например, если ''echo $message->toString();''бы вы увидели что-то подобное:


<code powershell>
Message-ID: 
Date: Thu, 25 Dec 2008 13:54:38 +1100
Subject: Example subject
From: Chris Corbyn 
To: Receiver Name 
MIME-Version: 1.0
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: quoted-printable

Here is the message
</code>

Мы рассмотрим более подробно методы, которые вы используете для создания своего сообщения, в следующих разделах.

===== Добавление контента в Ваше сообщение =====

Богатый контент может быть добавлен к сообщениям в Swift Mailer с относительной легкостью, вызвав такие методы , как''setSubject()'',''setBody()'', ''addPart()''и ''attach()''.

==== Настройка темы ====

Строка темы, отображаемая в почтовом клиенте получателей, может быть задана с ''setSubject()''помощью метода или в качестве параметра''new Swift_Message()'':


<code php>
// Pass it as a parameter when you create the message
$message = new Swift_Message('My amazing subject');

// Or set it after like this
$message->setSubject('My amazing subject');
</code>

==== Настройка содержимого тела ====

Тело сообщения-видимое, когда пользователь открывает сообщение-определяется вызовом ''setBody()''метода. Если необходимо включить альтернативное тело, ''addPart()''его можно использовать.

Тело сообщения - это основная часть, которую читает пользователь. Часто люди хотят отправить сообщение в формате HTML (''text/html''), в других случаях люди хотят отправить в обычном тексте (''text/plain''), или иногда люди хотят отправить обе версии и позволить получателю выбрать, как они видят сообщение.

Как правило, если вы собираетесь отправить электронное письмо в формате HTML, всегда включайте в него обычный текстовый эквивалент того же контента, чтобы пользователи, предпочитающие читать обычный текст, могли это сделать.

Если почтовый клиент получателя предлагает предпочтения для отображения текста, то HTML, то почтовый клиент представит эту часть пользователю там, где она доступна. В других случаях почтовый клиент будет отображать "лучшую" часть, которую он может - обычно HTML, если вы включили HTML:



<code php>
// Pass it as a parameter when you create the message
$message = new Swift_Message('Subject here', 'My amazing body');

// Or set it after like this
$message->setBody('My <em>amazing</em> body', 'text/html');

// Add alternative parts with addPart()
$message->addPart('My amazing body in plain text', 'text/plain');
</code>

===== Прикрепление Файлов =====

Вложения являются загружаемыми частями сообщения и могут быть добавлены путем вызова ''attach()''метода для сообщения. Вы можете добавлять вложения, которые существуют на диске, или создавать вложения на лету.

Хотя мы называем файлы, отправленные по электронной почте, "вложениями"-потому что они прикреплены к сообщению, - многие другие части сообщения на самом деле "прикреплены", даже если мы не называем эти части вложениями.

Файловые вложения создаются ''Swift_Attachment''классом и затем присоединяются к сообщению с помощью ''attach()''метода на нем. Для всех типов MIME "каждый день", таких как все графические форматы, документы word, PDF-файлы и электронные таблицы, вам не нужно явно устанавливать тип содержимого вложения, хотя это не повредит. Для менее распространенных форматов вы должны установить тип контента, который мы рассмотрим чуть позже.

==== Прикрепление Существующих Файлов ====

Файлы, которые уже существуют либо на диске, либо по URL-адресу, могут быть прикреплены к сообщению всего одной строкой кода, используя ''Swift_Attachment::fromPath()''.

Вы можете прикреплять файлы, которые существуют локально, или, если ваша установка PHP ''allow_url_fopen''включена, вы можете прикреплять файлы с других веб-сайтов.

Вложение будет представлено получателю в виде загружаемого файла с тем же именем, что и прикрепленный:


<code php>
// Create the attachment
// * Note that you can technically leave the content-type parameter out
$attachment = Swift_Attachment::fromPath('/path/to/image.jpg', 'image/jpeg');

// Attach it to the message
$message->attach($attachment);

// The two statements above could be written in one line instead
$message->attach(Swift_Attachment::fromPath('/path/to/image.jpg'));

// You can attach files from a URL if allow_url_fopen is on in php.ini
$message->attach(Swift_Attachment::fromPath('http://site.tld/logo.png'));
</code>

==== Установка имени файла ====

Обычно вам не нужно явно устанавливать имя файла вложения, потому что имя вложенного файла будет использоваться по умолчанию, но если вы хотите установить имя файла, вы используете ''setFilename()''метод вложения.

Вложение будет прикреплено обычным способом, но метаданные, отправленные внутри письма, переименуют файл во что-то другое:


<code php>
// Create the attachment and call its setFilename() method
$attachment = Swift_Attachment::fromPath('/path/to/image.jpg')
  ->setFilename('cool.jpg');

// Because there's a fluid interface, you can do this in one statement
$message->attach(
  Swift_Attachment::fromPath('/path/to/image.jpg')->setFilename('cool.jpg')
);
</code>

==== Прикрепление Динамического Контента ====

Файлы, созданные во время выполнения, такие как PDF-документы или изображения, созданные с помощью GD, могут быть прикреплены непосредственно к сообщению, не записывая их на диск. Используйте ''Swift_Attachment''непосредственно.

Вложение будет представлено получателю в виде загружаемого файла с указанным именем и типом содержимого:


<code php>
// Create your file contents in the normal way, but don't write them to disk
$data = create_my_pdf_data();

// Create the attachment with your data
$attachment = new Swift_Attachment($data, 'my-file.pdf', 'application/pdf');

// Attach it to the message
$message->attach($attachment);


// You can alternatively use method chaining to build the attachment
$attachment = (new Swift_Attachment())
  ->setFilename('my-file.pdf')
  ->setContentType('application/pdf')
  ->setBody($data);
</code>

<note>
Если вы обычно записываете файл на диск в любом случае, вы должны просто прикрепить его, ''Swift_Attachment::fromPath()''так как это будет использовать меньше памяти.
</note>
==== Изменение диспозиции ====

Вложения просто появляются в виде файлов, которые при желании можно сохранить на рабочем столе. Вы можете сделать так, чтобы вложение отображалось встроенным, где это возможно, с помощью ''setDisposition()''метода вложения.

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

<code php>
// Create the attachment and call its setDisposition() method
$attachment = Swift_Attachment::fromPath('/path/to/image.jpg')
  ->setDisposition('inline');


// Because there's a fluid interface, you can do this in one statement
$message->attach(
  Swift_Attachment::fromPath('/path/to/image.jpg')->setDisposition('inline'));
</code>

<note>

Если вы попытаетесь создать встроенное вложение для не отображаемого типа файла, такого как ZIP-файл, почтовый клиент должен просто представить вложение как обычное.
</note>
==== Встраивание Встроенных медиафайлов ====

Часто люди хотят включить изображение или другой контент в HTML-сообщение. Это легко сделать с помощью HTML-ссылок на удаленные ресурсы, но этот подход обычно блокируется почтовыми клиентами. Swift Mailer позволяет вам вставлять ваши носители непосредственно в сообщение.

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

Swift Mailer делает встраивание файлов в сообщения чрезвычайно упрощенным. Вы вставляете файл, вызывая ''embed()''метод сообщения, который возвращает значение, которое вы можете использовать в ''src''''href''атрибуте a или в вашем HTML.

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

Встроенные файлы отправляются по электронной почте в виде специального типа вложений с уникальным идентификатором, используемым для ссылки на них в ваших HTML-атрибутах. В почтовых клиентах, которые не поддерживают встроенные файлы, они могут отображаться как вложения.

Хотя это обычно делается для изображений, теоретически это будет работать для любого отображаемого (или воспроизводимого) типа носителей. Однако поддержка других типов носителей (например, видео) зависит от почтового клиента.

=== Встраивание Существующих Файлов ===

Файлы, которые уже существуют либо на диске, либо по URL-адресу, могут быть встроены в сообщение всего одной строкой кода, используя ''Swift_EmbeddedFile::fromPath()''.

Вы можете вставлять файлы, существующие локально, или, если ваша установка PHP ''allow_url_fopen''включена, вы можете вставлять файлы с других веб-сайтов.

Файл будет отображаться с сообщением встроенным в HTML код везде где его идентификатор используется в качестве ''src''атрибута:


<code php>
// Create the message
$message = new Swift_Message('My subject');

// Set the body
$message->setBody(
'<html>' .
' <body>' .
'  Here is an image <img src="' . // Embed the file
     $message->embed(Swift_Image::fromPath('image.png')) .
   '" alt="Image" />' .
'  Rest of message' .
' </body>' .
'</html>',
  'text/html' // Mark the content-type as HTML
);

// You can embed files from a URL if allow_url_fopen is on in php.ini
$message->setBody(
'<html>' .
' <body>' .
'  Here is an image <img src="' .
     $message->embed(Swift_Image::fromPath('http://site.tld/logo.png')) .
   '" alt="Image" />' .
'  Rest of message' .
' </body>' .
'</html>',
  'text/html'
);
</code>


<note tip>
''Swift_Image'' и ''Swift_EmbeddedFile''являются просто псевдонимами друг друга. ''Swift_Image'' существует для семантических целей.
</note>


<note>
Вы можете вставлять файлы в два этапа, если хотите. Просто захватите возвращаемое значение ''embed()''переменной in и используйте его в качестве ''src''атрибута:
</note>


<code php>
// If placing the embed() code inline becomes cumbersome
// it's easy to do this in two steps
$cid = $message->embed(Swift_Image::fromPath('image.png'));

$message->setBody(
'<html>' .
' <body>' .
'  Here is an image <img src="' . $cid . '" alt="Image" />' .
'  Rest of message' .
' </body>' .
'</html>',
  'text/html' // Mark the content-type as HTML
);
</code>

=== Встраивание Динамического контента ===

Образы, созданные во время выполнения, например образы, созданные с помощью GD, могут быть встроены непосредственно в сообщение без записи их на диск. Используйте стандартный ''new Swift_Image()''метод.

Файл будет отображаться с сообщением встроенным в HTML везде где его идентификатор используется в качестве ''src''атрибута:



<code php>
// Create your file contents in the normal way, but don't write them to disk
$img_data = create_my_image_data();

// Create the message
$message = new Swift_Message('My subject');

// Set the body
$message->setBody(
'<html>' .
' <body>' .
'  Here is an image <img src="' . // Embed the file
     $message->embed(new Swift_Image($img_data, 'image.jpg', 'image/jpeg')) .
   '" alt="Image" />' .
'  Rest of message' .
' </body>' .
'</html>',
  'text/html' // Mark the content-type as HTML
);
</code>

<note tip>
''Swift_Image'' и ''Swift_EmbeddedFile''являются просто псевдонимами друг друга. ''Swift_Image'' существует для семантических целей.
</note>


<note>
Вы можете вставлять файлы в два этапа, если хотите. Просто захватите возвращаемое значение ''embed()''переменной in и используйте его в качестве ''src''атрибута:
</note>

<code php>
// If placing the embed() code inline becomes cumbersome
// it's easy to do this in two steps
$cid = $message->embed(new Swift_Image($img_data, 'image.jpg', 'image/jpeg'));

$message->setBody(
'<html>' .
' <body>' .
'  Here is an image <img src="' . $cid . '" alt="Image" />' .
'  Rest of message' .
' </body>' .
'</html>',
  'text/html' // Mark the content-type as HTML
);
</code>

===== Добавление получателей к Вашему сообщению =====

Получатели указываются в самом сообщении через ''setTo()'', ''setCc()''и ''setBcc()''. Swift Mailer считывает этих получателей из сообщения, когда оно отправляется, чтобы знать, куда его отправить.

Получатели сообщений бывают трех типов:

  * ''To:'' получатели - первичные получатели (обязательно)
  * ''Cc:'' получатели - получают копию сообщения (необязательно).
  * ''Bcc:'' получатели -- скрыты от других получателей (необязательно)

Каждый тип может содержать один или несколько адресов. Можно перечислить только адреса получателей или персонализировать адрес, указав настоящее имя получателя.

Обязательно добавьте в качестве получателей только действительные адреса электронной почты. Если вы попытаетесь добавить недопустимый адрес электронной почты с ''setTo()''''setCc()''помощью или ''setBcc()'', Swift Mailer выдаст a ''Swift_RfcComplianceException''.

Если вы добавляете получателей автоматически на основе источника данных, который может содержать недопустимые адреса электронной почты, вы можете предотвратить возможные исключения, проверив эти адреса с помощью:

<code php>
use Egulias\EmailValidator\EmailValidator;
use Egulias\EmailValidator\Validation\RFCValidation;

$validator = new EmailValidator();
$validator->isValid("example@example.com", new RFCValidation()); //true
</code>

и только добавляя адреса, которые проверяют. Другой способ-обернуть ваш ''setTo()''''setCc()''и ''setBcc()''вызывает блок try-catch и обрабатывать ''Swift_RfcComplianceException''его в блоке catch.

Синтаксис для адресов

Если вы хотите ссылаться только на один адрес электронной почты (например, ваш ''From:''адрес), вы можете просто использовать строку:


<code php>
$message->setFrom('some@address.tld');
</code>

Если вы хотите включить имя, то вы должны использовать ассоциативный массив:


<code php>
$message->setFrom(['some@address.tld' => 'The Name']);
</code>

Если вы хотите включить несколько адресов, то вы должны использовать массив:

<code php>
$message->setTo(['some@address.tld', 'other@address.tld']);
</code>

Вы можете смешивать персонализированные (адреса с именем) и неперсонифицированные адреса в одном списке, смешивая использование ассоциативного и неассоциативного синтаксиса массива:

<code php>
$message->setTo([
  'recipient-with-name@example.org' => 'Recipient Name One',
  'no-name@example.org', // Note that this is not a key-value pair
  'named-recipient@example.org' => 'Recipient Name Two'
]);
</code>

==== Настройка To:получателей ====

''To:'' получатели требуются в сообщении и задаются с ''setTo()''''addTo()''помощью методов или сообщения.

Чтобы задать ''To:''получателей, создайте объект сообщения с помощью либо ''new Swift_Message( ... )'', затем вызовите ''setTo()''метод с полным массивом адресов, либо используйте ''addTo()''метод для итеративного добавления получателей.

''setTo()''Метод принимает входные данные в различных форматах, как описано ранее в этой главе. ''addTo()''Метод принимает один или два параметра. Первый-адрес электронной почты, а второй необязательный параметр-имя получателя.

''To:'' получатели видны в заголовках сообщений и будут видны другим получателям:


<code php>
// Using setTo() to set all recipients in one go
$message->setTo([
  'person1@example.org',
  'person2@otherdomain.org' => 'Person 2 Name',
  'person3@example.org',
  'person4@example.org',
  'person5@example.org' => 'Person 5 Name'
]);
</code>

<note>
Многократные вызовы ''setTo()''не добавят новых получателей-каждый вызов переопределяет предыдущие вызовы. Если вы хотите итеративно добавлять получателей, используйте этот ''addTo()''метод:
</note>

<code php>
// Using addTo() to add recipients iteratively
$message->addTo('person1@example.org');
$message->addTo('person2@example.org', 'Person 2 Name');
</code>

==== Настройка Cc:получателей ====

''Cc:'' получатели задаются с ''setCc()''''addCc()''помощью методов или сообщения.

Чтобы задать ''Cc:''получателей, создайте объект сообщения с помощью либо ''new Swift_Message( ... )'', затем вызовите ''setCc()''метод с полным массивом адресов, либо используйте ''addCc()''метод для итеративного добавления получателей.

''setCc()''Метод принимает входные данные в различных форматах, как описано ранее в этой главе. ''addCc()''Метод принимает один или два параметра. Первый-адрес электронной почты, а второй необязательный параметр-имя получателя.

''Cc:'' получатели видны в заголовках сообщений и будут видны другим получателям:


<code php>
// Using setTo() to set all recipients in one go
$message->setTo([
  'person1@example.org',
  'person2@otherdomain.org' => 'Person 2 Name',
  'person3@example.org',
  'person4@example.org',
  'person5@example.org' => 'Person 5 Name'
]);
</code>

<note>
Многократные вызовы ''setCc()''не добавят новых получателей-каждый вызов переопределяет предыдущие вызовы. Если вы хотите итеративно добавить Cc: recipients, используйте этот ''addCc()''метод:
</note>

<code php>
// Using addCc() to add recipients iteratively
$message->addCc('person1@example.org');
$message->addCc('person2@example.org', 'Person 2 Name');
</code>

==== Настройка Bcc:получателей ====

''Bcc:'' получатели получают копию сообщения так, чтобы никто другой об этом не знал, и им задаются методы ''setBcc()''или ''addBcc()''этого сообщения.

Чтобы задать ''Bcc:''получателей, создайте объект message с помощью любого ''new Swift_Message( ... )''из них , затем вызовите ''setBcc()''метод с полным массивом адресов или используйте этот ''addBcc()''метод для итеративного добавления получателей.

Этот ''setBcc()''метод принимает входные данные в различных форматах, как описано ранее в этой главе. ''addBcc()''Метод принимает один или два параметра. Первый - это адрес электронной почты, а второй необязательный параметр - имя получателя.

Только отдельный ''Bcc:''получатель будет видеть свой адрес в заголовках сообщений. Другие получатели (включая других ''Bcc:''получателей) не увидят этот адрес:


<code php>
// Using setBcc() to set all recipients in one go
$message->setBcc([
  'person1@example.org',
  'person2@otherdomain.org' => 'Person 2 Name',
  'person3@example.org',
  'person4@example.org',
  'person5@example.org' => 'Person 5 Name'
]);
</code>

<note>
Многократные вызовы ''setBcc()''не добавят новых получателей-каждый вызов переопределяет предыдущие вызовы. Если вы хотите итеративно добавить Bcc: recipients, используйте этот ''addBcc()''метод:
</note>

<code php>
// Using addBcc() to add recipients iteratively
$message->addBcc('person1@example.org');
$message->addBcc('person2@example.org', 'Person 2 Name');
</code>


<note important>
Интернационализированные Адреса Электронной Почты

Традиционно в адресах электронной почты разрешались только символы ASCII. С введением интернационализированных доменных имен (IDN) в доменном имени могут появиться символы, отличные от ASCII. По умолчанию Swiftmailer кодирует такие доменные имена в Punycode (например, xn--xample-ova.invalid). Это совместимо со всеми почтовыми серверами.

RFC 6531 ввел расширение SMTP, SMTPUTF8, которое позволяет использовать символы, отличные от ASCII, в адресах электронной почты с обеих сторон знака@. Для отправки на такие адреса ваш исходящий SMTP-сервер должен поддерживать расширение SMTPUTF8. Вы должны использовать кодировщик ''Swift_AddressEncoder_Utf8AddressEncoder''адресов и включить обработчик ''Swift_Transport_Esmtp_SmtpUtf8Handler''расширений SMTP:
</note>
<code php>
$smtpUtf8 = new Swift_Transport_Esmtp_SmtpUtf8Handler();
$transport->setExtensionHandlers([$smtpUtf8]);
$utf8Encoder = new Swift_AddressEncoder_Utf8AddressEncoder();
$transport->setAddressEncoder($utf8Encoder);
</code>

===== Указание сведений об отправителе =====

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

Информация об отправителе содержится в трех возможных местах:

  * ''From:'' -- адрес(адреса) автора сообщения (обязательно)
  * ''Sender:'' -- адрес одного человека, отправившего сообщение (необязательно)
  * ''Return-Path:'' -- адрес, куда должны идти отскоки (необязательно)

Вы всегда должны включать ''From:''''setFrom()''в сообщение адрес. Swift Mailer будет использовать это значение по умолчанию''Return-Path:'', если не указано иное.

''Sender:''Адрес существует потому, что человек, который действительно отправил электронное письмо, может быть не тем человеком, который его написал. Он имеет более высокий приоритет, чем ''From:''адрес, и будет использоваться в качестве ''Return-Path:''адреса, если не указано иное.

==== Установка From:адреса ====

''From:''Адрес является обязательным и устанавливается с ''setFrom()''помощью метода сообщения. ''From:'' адреса указывают, кто на самом деле написал письмо и, как правило, кто его отправил.

Большинство людей, вероятно, не понимают, что у вас может быть более одного ''From:''адреса, если письмо написал более одного человека-например, если письмо было составлено комитетом.

''From:''Адреса видны в заголовках сообщений и будут видны получателям.

<note>
Если вы установили несколько ''From:''адресов, то вы абсолютно должны установить ''Sender:''адрес, чтобы указать, кто физически отправил сообщение.
</note>

<code php>
// Set a single From: address
$message->setFrom('your@address.tld');

// Set a From: address including a name
$message->setFrom(['your@address.tld' => 'Your Name']);

// Set multiple From: addresses if multiple people wrote the email
$message->setFrom([
  'person1@example.org' => 'Sender One',
  'person2@example.org' => 'Sender Two'
]);
</code>

==== Установка Sender:адреса ====

''Sender:''Адрес указывает, кто отправил сообщение, и устанавливается с ''setSender()''помощью метода сообщения.

''Sender:''Адрес виден в заголовках сообщений и будет виден получателям.

Этот адрес будет использоваться, ''Return-Path:''если не указано иное.

<note>
Если вы установили несколько ''From:''адресов, то вы абсолютно должны установить ''Sender:''адрес, чтобы указать, кто физически отправил сообщение.
</note>

Вы не должны устанавливать более одного адреса отправителя на сообщение, потому что это не возможно для более чем одного человека, чтобы отправить одно сообщение:


<code php>
$message->setSender('your@address.tld');
</code>

==== Установка Return-Path:(отскок) Адрес ====

''Return-Path:''Адрес указывает, куда должны быть отправлены уведомления об отказе, и устанавливается с ''setReturnPath()''помощью метода сообщения.

Вы можете иметь только один''Return-Path:'', и он не должен включать личное имя.

Уведомления об отказе будут отправлены на этот адрес:


<code php>
$message->setReturnPath('bounces@address.tld');
</code>

===== Подписанное/Зашифрованное сообщение =====

Для повышения целостности/безопасности сообщения можно подписать и/или зашифровать сообщение с помощью одного или нескольких подписывающих устройств.

==== S/MIME ====

S/MIME может подписывать и/или шифровать сообщение с помощью расширения OpenSSL.

Подписывая сообщение, подписчик создает подпись всего содержимого сообщения (включая вложения).

Сертификат и закрытый ключ должны быть закодированы PEM и могут быть либо созданы с использованием, например, OpenSSL, либо получены в официальном Центре сертификации (CA).

**Для проверки подписи получатель должен иметь сертификат ЦС в списке доверенных эмитентов.**

**Убедитесь, что сертификат поддерживает защиту электронной почты.**

При использовании OpenSSL это можно сделать с помощью параметра-addtrust emailProtection при создании сертификата:


<code php>
$message = new Swift_Message();

$smimeSigner = new Swift_Signers_SMimeSigner();
$smimeSigner->setSignCertificate('/path/to/certificate.pem', '/path/to/private-key.pem');
$message->attachSigner($smimeSigner);
</code>

Когда закрытый ключ защищен с помощью парольной фразы, используйте вместо этого следующее:


<code php>
$message = new Swift_Message();

$smimeSigner = new Swift_Signers_SMimeSigner();
$smimeSigner->setSignCertificate('/path/to/certificate.pem', ['/path/to/private-key.pem', 'passphrase']);
$message->attachSigner($smimeSigner);
</code>

По умолчанию подпись добавляется как вложение, делая сообщение все еще читаемым для почтовых агентов, не поддерживающих подписанные сообщения.

Хранение сообщения в двоичном виде также возможно, но не рекомендуется:


<code php>
$smimeSigner->setSignCertificate('/path/to/certificate.pem', '/path/to/private-key.pem', PKCS7_BINARY);
</code>

При шифровании сообщения (также известном как обертывание) все сообщение (включая вложения) шифруется с помощью сертификата, и получатель может затем расшифровать сообщение с помощью соответствующего закрытого ключа.

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

Обычно получатель предоставляет сертификат для шифрования и сохранения ключа дешифрования в тайне.

Также возможно использование как подписи, так и шифрования:


<code php>
$message = new Swift_Message();

$smimeSigner = new Swift_Signers_SMimeSigner();
$smimeSigner->setSignCertificate('/path/to/sign-certificate.pem', '/path/to/private-key.pem');
$smimeSigner->setEncryptCertificate('/path/to/encrypt-certificate.pem');
$message->attachSigner($smimeSigner);
</code>

Используемый шифр шифрования может быть установлен в качестве второго параметра setEncryptCertificate ().

Видишь [[https://z5h64q92x9.net/proxy_u/en-ru.ru.c8e08476-610154fe-59489edd-74722d776562/https/secure.php.net/manual/openssl.ciphers|https://secure.php.net/manual/openssl.ciphers]] список поддерживаемых шифров.

По умолчанию сообщение сначала подписывается, а затем шифруется, это можно изменить, добавив:


<code php>
$smimeSigner->setSignThenEncrypt(false);
</code>

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

Только если у вас возникли проблемы с методом sign then encrypt, это должно быть изменено.

===== Запрос квитанции на чтение =====

При открытии электронной почты можно запросить отправку квитанции на чтение на указанный адрес. Чтобы запросить квитанцию на чтение, установите адрес с помощью''setReadReceiptTo()'':

<code php>
$message->setReadReceiptTo('your@address.tld');
</code>

При открытии письма, если почтовый клиент его поддерживает , на этот адрес будет отправлено уведомление.

<note tip>
Чтение квитанций не будет работать для большинства получателей, так как многие почтовые клиенты автоматически отключают их. Те клиенты, которые отправят квитанцию на чтение, сообщат пользователю, что она была запрошена.
</note>
===== Настройка набора символов =====

Набор символов сообщения (и его частей MIME) устанавливается с ''setCharset()''помощью метода. Вы также можете изменить глобальное значение по умолчанию UTF-8, работая с ''Swift_Preferences''классом.

Swift Mailer будет по умолчанию использовать набор символов UTF-8, если не переопределено иное. UTF-8 будет работать в большинстве случаев, так как он включает в себя все стандартные символы клавиатуры США в дополнение к большинству международных символов.

Это абсолютно жизненно важно, однако, что вы знаете, какой набор символов ваше сообщение (или это части MIME) написаны в противном случае ваше сообщение может быть получено полностью искаженным.

В Swift Mailer есть два места, где вы можете изменить набор символов:

  * В ''Swift_Preferences''классе
  * На каждом отдельном сообщении и/или части MIME

Чтобы установить набор символов вашего сообщения:

  * Измените глобальную настройку UTF-8, позвонив по телефону ''Swift_Preferences::setCharset()''; или
  * Вызовите ''setCharset()''метод для сообщения или части MIME: 1

<code php>
// Approach 1: Change the global setting (suggested)
Swift_Preferences::getInstance()->setCharset('iso-8859-2');

// Approach 2: Call the setCharset() method of the message
$message = (new Swift_Message())
  ->setCharset('iso-8859-2');

// Approach 3: Specify the charset when setting the body
$message->setBody('My body', 'text/html', 'iso-8859-2');

// Approach 4: Specify the charset for each part added
$message->addPart('My part', 'text/plain', 'iso-8859-2');
</code>

===== Настройка кодировки =====

Тело каждой части пантомимы должно быть закодировано. Двоичные вложения кодируются в base64 с помощью ''Swift_Mime_ContentEncoder_Base64ContentEncoder''. Текстовые части традиционно кодируются в кавычках с помощью ''Swift_Mime_ContentEncoder_QpContentEncoder''or ''Swift_Mime_ContentEncoder_NativeQpContentEncoder''.

Кодер сообщения или MIME-части устанавливается с помощью этого ''setEncoder()''метода.

Quoted-printable-это безопасный выбор, потому что он преобразует 8-битный текст в 7-битный. Большинство современных SMTP-серверов поддерживают 8-битный текст. Это объявляется через расширение SMTP 8BITMIME. Если ваш исходящий SMTP-сервер поддерживает это расширение SMTP и поддерживает понижение уровня сообщения (например, преобразование в кавычки для печати на лету) при доставке на нисходящий сервер, который не поддерживает это расширение, вы можете использовать ''Swift_Mime_ContentEncoder_PlainContentEncoder''вместо ''8bit''него режим in. Это имеет то преимущество, что исходные данные немного более читабельны и компактны, особенно для незападных языков.

<code php>
$eightBitMime = new Swift_Transport_Esmtp_EightBitMimeHandler(); $transport->setExtensionHandlers%%([%%$eightBitMime]); $plainEncoder = new Swift_Mime_ContentEncoder_PlainContentEncoder%%('%%8bit'); $message->>setEncoder($plainEncoder); 
</code>

===== Установка длины линии =====

Длина строк в сообщении может быть изменена с помощью ''setMaxLineLength()''метода на сообщении:


<code>
$message->setMaxLineLength(1000);
</code>

Swift Mailer по умолчанию использует 78 символов в строке сообщения. Это делается по историческим причинам и для того, чтобы сообщение можно было легко просмотреть в обычных текстовых терминалах

Строки, длина которых превышает указанную длину строки, будут заключены между словами.


<note important>
Вы никогда не должны устанавливать максимальную длину более 1000 символов в соответствии с RFC 2822. Это может привести к неопределенным побочным эффектам, таким как усечение частей вашего сообщения при его передаче между SMTP-серверами.
</note>
===== Установка приоритета сообщения =====

Вы можете изменить приоритет сообщения с ''setPriority()''помощью кнопки . Установка приоритета не изменит способ отправки вашей электронной почты-это чисто ориентировочная настройка для получателя:


<code php>
// Indicate "High" priority
$message->setPriority(2);
</code>

Приоритет сообщения - это указание получателю, какое значение оно имеет. Swift Mailer позволяет установить приоритет, вызвав ''setPriority''метод. Этот метод принимает целочисленное значение от 1 до 5:

  * ''Swift_Mime_SimpleMessage::PRIORITY_HIGHEST'': 1
  * ''Swift_Mime_SimpleMessage::PRIORITY_HIGH'': 2
  * ''Swift_Mime_SimpleMessage::PRIORITY_NORMAL'': 3
  * ''Swift_Mime_SimpleMessage::PRIORITY_LOW'': 4
  * ''Swift_Mime_SimpleMessage::PRIORITY_LOWEST'': 5

<code php>
// Or use the constant to be more explicit
$message->setPriority(Swift_Mime_SimpleMessage::PRIORITY_HIGH);
</code>

====передать переменную в шаблон====

<code php>
Yii::$app->mail
    ->compose(['html' => 'layouts/html2'], ['content' => $content])
    ->setFrom(['noreply@mailer.com' => 'Mailer'])
</code>

<code html>
<body>
    <?php $this->beginBody() ?>
    <?= $content ?>
    <?php $this->endBody() ?>
</body>
</code>
Инструменты пользователя

Инструменты сайта

Инструменты страницы
