Spec-Zone.ru › CakePHP 3.6

Класс 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
    Деструктор
  • _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
Объект электронной почты

Возвращает

массив
END_OF_DOCUMENT_MARKER

_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

Истина для рекурсивного слияния, '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 $key optional null
Ключ для получения/установки или весь массив конфигураций.
mixed|null $value optional null
Значение для установки.
boolean $merge optional 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
Значение конфигурации, которое считывается.
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']);

Параметры

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

Spec-Zone.ru

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