Класс SmtpTransport
Отправка почты с использованием протокола SMTP
- Cake\Mailer\AbstractTransport использует Cake\Core\InstanceConfigTrait
-
Cake\Mailer\Transport\SmtpTransport
Краткое описание свойств
-
$_contentprotectedСодержимое возвращаемого электронного письмаstring -
$_defaultConfigprotectedКонфигурация по умолчанию для этого классаarray -
$_lastResponseprotectedОтвет последней отправленной команды SMTP.array - Сокет к SMTP серверу
$_socketprotected
Унаследованные свойства
Краткое описание методов
- __destruct() publicДеструктор
- _auth() protectedОтправка аутентификации
- _bufferResponseLines() protectedРазбирает и хранит строки ответа в формате
'code' => 'message'. - _connect() protectedПодключение к SMTP серверу
- _disconnect() protectedОтключение
- _generateSocket() protectedВспомогательный метод для создания сокета
- _prepareFromAddress() protectedПодготовка адреса отправителя электронной почты.
- _prepareFromCmd() protectedПодготовка команды SMTP для отправителя.
- _prepareMessage() protectedПодготовка тела сообщения.
- _prepareMessageHeaders() protectedПодготовка заголовков сообщения.
- _prepareRcptCmd() protectedПодготовка команды SMTP для получателей.
- _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 )
Подготовка адреса отправителя электронной почты.
Параметры
-
Cake\Mailer\Email$email - Экземпляр электронной почты
Возвращает
массив_prepareFromCmd()source protected
_prepareFromCmd( string $email )
Подготовка команды SMTP для отправителя.
Параметры
- строка
$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 для получателей.
Параметры
- строка
$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 True для рекурсивного слияния, 'shallow' для простого слияния, false для перезаписи, по умолчанию false.
Исключения
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']);
Параметры
- string|array|null
$keyнеобязательно null - Ключ для получения/установки или весь массив конфигураций.
- mixed|null
$valueнеобязательно null - Значение для установки.
- boolean
$mergeнеобязательно true - Выполнять ли рекурсивное слияние или перезаписывать существующую конфигурацию, по умолчанию true.
Возвращает
mixedЧитаемое значение конфигурации или сам объект при операциях записи.
Исключения
Cake\Core\Exception\ExceptionПри попытке установить некорректный ключ.
configShallow()source public
configShallow( string|array $key , mixed|null $value null )
Объединение предоставленной конфигурации с существующей конфигурацией. В отличие от config() , которая выполняет рекурсивное объединение для вложенных ключей, этот метод выполняет простое объединение.
Установка определенного значения:
$this->config('key', $value); Установка вложенного значения:
$this->config('some.nested.key', $value); Обновление нескольких настроек конфигурации одновременно:
$this->config(['one' => 'value', 'another' => 'value']);
Параметры
- string|array
$key - Ключ для установки или весь массив конфигураций.
- mixed|null
$valueнеобязательно null - Значение для установки.
Возвращает
$this Объект самого себя.
Подробное описание свойств
$_defaultConfigsource
protected array
Настройки по умолчанию для этого класса
[
'host' => 'localhost',
'port' => 25,
'timeout' => 30,
'username' => null,
'password' => null,
'client' => null,
'tls' => false,
'keepAlive' => false
]
© 2005–2016 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.
http://api.cakephp.org/3.2/class-Cake.Mailer.Transport.SmtpTransport.html