Spec-Zone.ru › CakePHP 3.7

Класс SmtpTransport

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

Cake\Mailer\AbstractTransport использует Cake\Core\InstanceConfigTrait
Extended by 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 )

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

Возвращает

строка
END_OF_DOCUMENT_MARKER

_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 $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...
]

Возвращает

array

send()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 optional []
Параметры конфигурации.

_headersToString()source protected

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

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

Параметры

array $headers
Заголовки в формате ключ => значение
string $eol optional "\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 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.

Возвращает

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 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
Возвращаемое значение, когда ключ отсутствует.

Возвращает

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
При попытке установить недопустимый ключ.

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

$_contentsource

protected array

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

[]

$_defaultConfigsource

protected array

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

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

$_lastResponsesource

protected array

Ответ на последнюю отправленную команду 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.7/class-Cake.Mailer.Transport.SmtpTransport.html

Spec-Zone.ru

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