Spec-Zone.ru › CakePHP 3.8

Класс SmtpTransport

Отправка почты по протоколу SMTP

Cake\Mailer\AbstractTransport использует Cake\Core\InstanceConfigTrait
Расширенный Cake\Mailer\Transport\SmtpTransport
Пространство имён: Cake\Mailer\Transport
Расположение: Mailer/Transport/SmtpTransport.php

Краткое описание свойств

  • $_content protected
    array
    Содержимое почты для возврата
  • $_defaultConfig protected
    array
    Конфигурация по умолчанию для этого класса
  • $_lastResponse protected
    array
    Ответ последней отправленной команды SMTP.
  • $_socket protected
    Cake\Network\Socket
    Сокет к SMTP-серверу

Унаследованные свойства

  • _config, _configInitialized

Краткое описание методов

  • __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 )

Подготавливает адрес электронной почты отправителя.

Параметры

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
Адрес электронной почты для отправки с командой.

Возвращает

строка
END_OF_DOCUMENT_MARKER

_prepareRecipientAddresses()source protected

_prepareRecipientAddresses( Cake\Mailer\Email $email )

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

Параметры

Cake\Mailer\Email $email
Экземпляр Email

Возвращает

массив

_sendData()source protected

_sendData( Cake\Mailer\Email $email )

Отправка данных

Параметры

Cake\Mailer\Email $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 optional '250'
Код для проверки в ответ сервера, false - пропускать проверку

Возвращает

string|null
Соответствующий код или null, если ничего не найдено

Использует

Cake\Network\Exception\SocketException

connect()source public

connect( )

Подключение к SMTP-серверу.

Этот метод пытается подключиться только в том случае, если открытое соединение еще не существует.

connected()source public

connected( )

Проверка наличия открытого подключения к SMTP-серверу.

Возвращает

boolean

disconnect()source public

disconnect( )

Отключение от SMTP-сервера.

Этот метод пытается отключиться только в том случае, если открытое соединение существует.

getLastResponse()source public

getLastResponse( )

Возвращает ответ от последней отправленной SMTP-команды.

Ответ состоит из одной или нескольких строк, содержащих код ответа и необязательный текст сообщения ответа:

[
    [
        'code' => '250',
        'message' => 'mail.example.com'
    ],
    [
        'code' => '250',
        'message' => 'PIPELINING'
    ],
    [
        'code' => '250',
        'message' => '8BITMIME'
    ],
    // etc...
]

Возвращает

массив

send()source public

send( Cake\Mailer\Email $email )

Отправка почты

Параметры

Cake\Mailer\Email $email
Экземпляр Email

Возвращает

массив

Использует

Cake\Network\Exception\SocketException

Методы, унаследованные от Cake\Mailer\AbstractTransport

__construct()source public

__construct( array $config = [] )

Конструктор

Параметры

массив $config optional []
Параметры конфигурации.

_headersToString()source protected

_headersToString( array $headers , string $eol = "\r\n" )

Помощь в преобразовании заголовков в строку

Параметры

массив $headers
Заголовки в формате ключ => значение
строка $eol optional "\r\n"
Строка конца строки.

Возвращает

строка

Методы, используемые из Cake\Core\InstanceConfigTrait

_configDelete()source protected

_configDelete( string $key )

Удаляет один ключ конфигурации.

Параметры

строка $key
Ключ для удаления.

Использует

Cake\Core\Exception\Exception
если происходит попытка перезаписи существующей конфигурации

_configRead()source protected

_configRead( string|null $key )

Читает ключ конфигурации.

Параметры

string|null $key
Ключ для чтения.

Возвращает

смешанное

_configWrite()source protected

_configWrite( string|array $key , mixed $value , boolean|string $merge = false )

Записывает ключ конфигурации.

Параметры

string|array $key
Ключ для записи.
смешанное $value
Значение для записи.
boolean|string $merge optional 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 $key optional null
Ключ для получения/установки или полный массив конфигураций.
mixed|null $value optional null
Значение для установки.
boolean $merge optional true
Выполнять рекурсивное слияние или перезаписывать существующую конфигурацию, по умолчанию true.

Возвращает

смешанное
Прочитанное значение конфигурации или сам объект при операциях записи.

Использует

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 optional 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 optional null
Ключ для получения или null для всей конфигурации.
mixed $default optional null
Возвращаемое значение, если ключ не существует.

Возвращает

смешанное
Данные конфигурации по указанному ключу или null, если ключ не существует.
END_OF_DOCUMENT_MARKER

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
Значение для установки.
boolean $merge необязательно true
Выполнять рекурсивное слияние или перезапись существующей конфигурации, по умолчанию true.

Возвращаемое значение


$this

Исключения

Cake\Core\Exception\Exception
При попытке установить недопустимый ключ.

Подробное описание свойств

$_contentsource

protected массив

Содержание возвращаемого электронного письма

[]

$_defaultConfigsource

protected массив

Настройки по умолчанию для данного класса

[
    'host' => 'localhost',
    'port' => 25,
    'timeout' => 30,
    'username' => null,
    'password' => null,
    'client' => null,
    'tls' => false,
    'keepAlive' => false
]

$_lastResponsesource

protected массив

Ответ последней отправленной команды SMTP.

[]

$_socketsource

protected Cake\Network\Socket

Сокет для SMTP-сервера

© 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.8/class-Cake.Mailer.Transport.SmtpTransport.html

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API