Класс 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Подготавливает адрес электронной почты отправителя.
- _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
$checkCodeoptional '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
$configoptional [] - Параметры конфигурации.
_headersToString()source protected
_headersToString( array $headers , string $eol = "\r\n" )
Помощь в преобразовании заголовков в строку
Параметры
- array
$headers - Заголовки в формате ключ => значение
- string
$eoloptional "\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
$mergeoptional false Истина для рекурсивного слияния, 'shallow' для простого слияния, ложь для перезаписи, по умолчанию ложь.
Исключения
Cake\Core\Exception\Exceptionпри попытке перезаписи существующей конфигурации
config()source public deprecated
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
$keyoptional null - Ключ для получения/установки или весь массив конфигураций.
- mixed|null
$valueoptional null - Значение для установки.
- boolean
$mergeoptional 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
$valueoptional 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
$keyoptional null - Ключ для получения или null для всей конфигурации.
- mixed
$defaultoptional 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']);
Параметры
- string|array
$key - Ключ для установки или массив параметров конфигурации.
- mixed|null
$valueопционально null - Значение для установки.
- boolean
$mergeопционально true - Выполнять рекурсивное слияние или перезапись существующей конфигурации. По умолчанию — true.
Возвращает
$this
Выбрасывает
Cake\Core\Exception\ExceptionПри попытке установить несуществующий ключ.
Подробное описание свойств
$_defaultConfigsource
protected array
Значения конфигурации по умолчанию для данного класса
[
'host' => 'localhost',
'port' => 25,
'timeout' => 30,
'username' => null,
'password' => null,
'client' => null,
'tls' => false,
'keepAlive' => false
]
© 2005–present 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.6/class-Cake.Mailer.Transport.SmtpTransport.html