Spec-Zone.ru › CakePHP 3.5

Класс 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
    Подготавливает адрес электронной почты 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( )

Деструктор

Попытка отключения для обеспечения надлежащего завершения соединения перед закрытием сокета.

_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
Экземпляр электронной почты

Возвращает

массив
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 опционально '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 опционально []
Параметры конфигурации.

_headersToString()source protected

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

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

Параметры

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

Истинно для рекурсивной слияния, 'shallow' для простого слияния, ложно для перезаписи, по умолчанию ложно.

Исключения

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

config()source public

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

Параметры

строка|массив $key
Ключ для установки или полный массив конфигураций.
смешанное|null $value необязательно null
Значение для установки.
логическое $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–2018 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.5/class-Cake.Mailer.Transport.SmtpTransport.html

Spec-Zone.ru

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