Класс SmtpTransport
Отправка почты с использованием протокола SMTP
- Cake\Mailer\AbstractTransport использует Cake\Core\InstanceConfigTrait
-
Cake\Mailer\Transport\SmtpTransport
Краткое описание свойств
-
$_contentprotectedСодержимое возвращаемого электронного письмаarray -
$_defaultConfigprotectedКонфигурация по умолчанию для этого классаarray -
$_lastResponseprotectedОтвет последней отправленной команды SMTP.array - Сокет для сервера SMTP
$_socketprotected
Унаследованные свойства
Краткое описание методов
- __destruct() publicДеструктор
- _auth() protectedОтправка аутентификации
- _bufferResponseLines() protectedПарсит и хранит строки ответа в формате
'code' => 'message'. - _connect() protectedПодключение к SMTP-серверу
- _disconnect() protectedОтключение
- _generateSocket() protectedВспомогательный метод для создания сокета
- _prepareFromAddress() protectedПодготавливает адрес электронной почты
from. - _prepareFromCmd() protectedПодготавливает команду SMTP
MAIL FROM. - _prepareMessage() protectedПодготавливает тело сообщения.
- _prepareMessageHeaders() protectedПодготавливает заголовки сообщения.
- _prepareRcptCmd() protectedПодготавливает команду SMTP
RCPT TO. - _prepareRecipientAddresses() protectedПодготавливает адреса электронной почты получателей.
- _sendData() protectedОтправка данных
- _sendRcpt() protectedОтправка писем
- _smtpSend() protectedЗащищённый метод для отправки данных на SMTP-соединение
- connect() publicПодключение к SMTP-серверу.
- connected() publicПроверка наличия открытого соединения с SMTP-сервером.
- disconnect() publicОтключение от SMTP-сервера.
- getLastResponse() publicВозвращает ответ последней отправленной команды SMTP.
- send() publicОтправка почты
Подробное описание методов
__destruct()source public
__destruct( )
Деструктор
Попытка отключения для обеспечения надлежащего завершения соединения перед закрытием сокета.
_auth()source protected
_auth( )
Отправка аутентификации
Исключения
Cake\Network\Exception\SocketException_bufferResponseLines()source protected
_bufferResponseLines( array $responseLines )
Парсит и хранит строки ответа в формате 'code' => 'message'.
Параметры
- массив
$responseLines - Строки ответа для парсинга.
_connect()source protected
_connect( )
Подключение к SMTP-серверу
Исключения
Cake\Network\Exception\SocketException_disconnect()source protected
_disconnect( )
Отключение
Исключения
Cake\Network\Exception\SocketException_generateSocket()source protected
_generateSocket( )
Вспомогательный метод для создания сокета
Исключения
Cake\Network\Exception\SocketException_prepareFromAddress()source protected
_prepareFromAddress( Cake\Mailer\Email $email )
Подготавливает адрес электронной почты from.
Параметры
-
Cake\Mailer\Email$email - Экземпляр электронной почты
Возвращает
массив_prepareFromCmd()source protected
_prepareFromCmd( string $email )
Подготавливает команду SMTP MAIL FROM.
Параметры
- строка
$email - Адрес электронной почты для отправки с командой.
Возвращает
строка_prepareMessage()source protected
_prepareMessage( Cake\Mailer\Email $email )
Подготавливает тело сообщения.
Параметры
-
Cake\Mailer\Email$email - Экземпляр электронной почты
Возвращает
строка_prepareMessageHeaders()source protected
_prepareMessageHeaders( Cake\Mailer\Email $email )
Подготавливает заголовки сообщения.
Параметры
-
Cake\Mailer\Email$email - Экземпляр электронной почты
Возвращает
массив_prepareRcptCmd()source protected
_prepareRcptCmd( string $email )
Подготавливает команду SMTP RCPT TO.
Параметры
- строка
$email - Адрес электронной почты для отправки с командой.
Возвращает
строка_prepareRecipientAddresses()source protected
_prepareRecipientAddresses( Cake\Mailer\Email $email )
Подготавливает адреса электронной почты получателей.
Параметры
-
Cake\Mailer\Email$email - Экземпляр электронной почты
Возвращает
массив_sendData()source protected
_sendData( Cake\Mailer\Email $email )
Отправка данных
Параметры
-
Cake\Mailer\Email$email - Экземпляр электронной почты
Исключения
Cake\Network\Exception\SocketException_sendRcpt()source protected
_sendRcpt( Cake\Mailer\Email $email )
Отправка электронных писем
Параметры
-
Cake\Mailer\Email$email - Cake Email
Исключения
Cake\Network\Exception\SocketException_smtpSend()source protected
_smtpSend( string|null $data , string|boolean $checkCode '250' )
Защищённый метод для отправки данных на SMTP-соединение
Параметры
- string|null
$data - Данные, которые будут отправлены на SMTP-сервер
- string|boolean
$checkCodeопционально '250' - Код для проверки в ответе сервера, false для пропуска
Возвращает
string|nullСоответствующий код или null, если ничего не найдено
Исключения
Cake\Network\Exception\SocketExceptionconnect()source public
connect( )
Подключение к SMTP-серверу.
Этот метод пытается подключиться только в случае, если открытое соединение не доступно.
connected()source public
connected( )
Проверка наличия открытого соединения с SMTP-сервером.
Возвращает
booleandisconnect()source public
disconnect( )
Отключение от SMTP-сервера.
Этот метод пытается отключиться только в случае наличия открытого соединения.
getLastResponse()source public
getLastResponse( )
Возвращает ответ последней отправленной SMTP-команды.
Ответ состоит из одной или нескольких строк, содержащих код ответа и необязательный текст сообщения ответа:
[
[
'code' => '250',
'message' => 'mail.example.com'
],
[
'code' => '250',
'message' => 'PIPELINING'
],
[
'code' => '250',
'message' => '8BITMIME'
],
// etc...
] Возвращает
arraysend()source public
send( Cake\Mailer\Email $email )
Отправка почты
Параметры
-
Cake\Mailer\Email$email - Экземпляр электронной почты
Возвращает
arrayИсключения
Cake\Network\Exception\SocketExceptionМетоды, унаследованные от Cake\Mailer\AbstractTransport
__construct()source public
__construct( array $config [] )
Конструктор
Параметры
- array
$configопционально [] - Параметры конфигурации.
_headersToString()source protected
_headersToString( array $headers , string $eol "\r\n" )
Помогает в преобразовании заголовков в строку
Параметры
- array
$headers - Заголовки в формате ключ => значение
- string
$eolопционально "\r\n" - Строка конца строки.
Возвращает
stringМетоды, используемые из Cake\Core\InstanceConfigTrait
_configDelete()source protected
_configDelete( string $key )
Удаляет один ключ конфигурации.
Параметры
- string
$key - Ключ для удаления.
Исключения
Cake\Core\Exception\Exceptionпри попытке перезаписи существующей конфигурации
_configRead()source protected
_configRead( string|null $key )
Считывает ключ конфигурации.
Параметры
- string|null
$key - Ключ для считывания.
Возвращает
mixed_configWrite()source protected
_configWrite( string|array $key , mixed $value , boolean|string $merge false )
Записывает ключ конфигурации.
Параметры
- string|array
$key - Ключ для записи.
- mixed
$value - Значение для записи.
- boolean|string
$mergeопционально false Истинно для рекурсивной слияния, 'shallow' для простого слияния, ложно для перезаписи, по умолчанию ложно.
Исключения
Cake\Core\Exception\Exceptionпри попытке перезаписи существующей конфигурации
config()source public
config( string|array|null $key null , mixed|null $value null , boolean $merge true )
Получение/Установка конфигурации.
Использование
Чтение всей конфигурации:
$this->config();
Чтение определённого значения:
$this->config('key'); Чтение вложенного значения:
$this->config('some.nested.key'); Установка определённого значения:
$this->config('key', $value); Установка вложенного значения:
$this->config('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->config(['one' => 'value', 'another' => 'value']);
Устарело
3.4.0 использовать setConfig()/getConfig() вместо.Параметры
- string|array|null
$keyопционально null - Ключ для получения/установки или полный массив конфигураций.
- mixed|null
$valueопционально null - Значение для установки.
- boolean
$mergeопционально true - Выполнять рекурсивное слияние или перезапись существующей конфигурации, по умолчанию истинно.
Возвращает
mixedЗначение конфигурации, которое считывается, или сам объект при операциях записи.
Исключения
Cake\Core\Exception\ExceptionПри попытке установить недопустимый ключ.
configShallow()source public
configShallow( string|array $key , mixed|null $value null )
Слияние предоставленной конфигурации с существующей конфигурацией. В отличие от config(), которое выполняет рекурсивное слияние для вложенных ключей, этот метод выполняет простое слияние.
Установка определённого значения:
$this->configShallow('key', $value); Установка вложенного значения:
$this->configShallow('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->configShallow(['one' => 'value', 'another' => 'value']);
Параметры
- string|array
$key - Ключ для установки или полный массив конфигураций.
- mixed|null
$valueопционально null - Значение для установки.
Возвращает
$this
getConfig()source public
getConfig( string|null $key null , mixed $default null )
Возвращает конфигурацию.
Использование
Чтение всей конфигурации:
$this->getConfig();
Чтение определённого значения:
$this->getConfig('key'); Чтение вложенного значения:
$this->getConfig('some.nested.key'); Чтение со значением по умолчанию:
$this->getConfig('some-key', 'default-value'); Параметры
- string|null
$keyопционально null - Ключ для получения или null для всей конфигурации.
- mixed
$defaultопционально null - Возвращаемое значение, когда ключ не существует.
Возвращает
mixedЗначение конфигурации, которое считывается.
setConfig()source public
setConfig( string|array $key , mixed|null $value null , boolean $merge true )
Устанавливает конфигурацию.
Использование
Установка определенного значения:
$this->setConfig('key', $value); Установка вложенного значения:
$this->setConfig('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->setConfig(['one' => 'value', 'another' => 'value']);
Параметры
- строка|массив
$key - Ключ для установки или полный массив конфигураций.
- смешанное|null
$valueнеобязательно null - Значение для установки.
- логическое
$mergeнеобязательно true - Выполнять рекурсивное слияние или перезапись существующей конфигурации, по умолчанию — true.
Возвращает
$this
Выбрасывает
Cake\Core\Exception\ExceptionПри попытке установить неверный ключ.
Подробное описание свойств
$_defaultConfigsource
protected массив
Конфигурация по умолчанию для этого класса
[
'host' => 'localhost',
'port' => 25,
'timeout' => 30,
'username' => null,
'password' => null,
'client' => null,
'tls' => false,
'keepAlive' => false
]
© 2005–2018 The Cake Software Foundation, Inc.
Licensed under the MIT License.
CakePHP is a registered trademark of Cake Software Foundation, Inc.
We are not endorsed by or affiliated with CakePHP.
https://api.cakephp.org/3.5/class-Cake.Mailer.Transport.SmtpTransport.html