Класс SmtpTransport
Отправка почты по протоколу SMTP
- Cake\Mailer\AbstractTransport использует Cake\Core\InstanceConfigTrait
-
Cake\Mailer\Transport\SmtpTransport
Краткое описание свойств
-
$_contentprotectedСодержимое возвращаемого электронного письмаarray -
$_defaultConfigprotectedКонфигурация по умолчанию для этого классаarray -
$_lastResponseprotectedОтвет на последнюю отправленную команду SMTP.array - Сокет к SMTP серверу
$_socketprotected
Унаследованные свойства
Краткое описание методов
- __destruct() publicДеструктор
- __wakeup() 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( )
Деструктор
Пытается отключиться, чтобы убедиться, что подключение корректно закрыто перед закрытием сокета.
__wakeup()source public
__wakeup( )
Обработчик десериализации.
Убедитесь, что свойство сокета не инициализировано в нерабочем состоянии.
_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 - Экземпляр электронной почты
Возвращает
array_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 True для рекурсивной слияния, 'shallow' для простого слияния, false для перезаписи, по умолчанию false.
Исключение
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 - Производить рекурсивное слияние или перезапись существующей конфигурации, по умолчанию 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.7/class-Cake.Mailer.Transport.SmtpTransport.html