Class SmtpTransport

__destructsource public

__destruct( )

Destructor

Tries to disconnect to ensure that the connection is being terminated properly before the socket gets closed.

_authsource protected

_auth( )

Send authentication

Throws

Cake\Network\Exception\SocketException
\Cake\Network\Exception\SocketException

_bufferResponseLinessource protected

_bufferResponseLines( array $responseLines )

Parses and stores the response lines in 'code' => 'message' format.

Parameters

array $responseLines

Response lines to parse.

_connectsource protected

_connect( )

Connect to SMTP Server

Throws

Cake\Network\Exception\SocketException
\Cake\Network\Exception\SocketException

_disconnectsource protected

_disconnect( )

Disconnect

Throws

Cake\Network\Exception\SocketException
\Cake\Network\Exception\SocketException

_generateSocketsource protected

_generateSocket( )

Helper method to generate socket

Throws

Cake\Network\Exception\SocketException
\Cake\Network\Exception\SocketException

_prepareFromAddresssource protected

_prepareFromAddress( Cake\Mailer\Email $email )

Prepares the from email address.

Parameters

Cake\Mailer\Email $email

Email instance

Returns

array
array

_prepareFromCmdsource protected

_prepareFromCmd( string $email )

Prepares the MAIL FROM SMTP command.

Parameters

string $email

The email address to send with the command.

Returns

string
string

_prepareMessagesource protected

_prepareMessage( Cake\Mailer\Email $email )

Prepares the message body.

Parameters

Cake\Mailer\Email $email

Email instance

Returns

string
string

_prepareMessageHeaderssource protected

_prepareMessageHeaders( Cake\Mailer\Email $email )

Prepares the message headers.

Parameters

Cake\Mailer\Email $email

Email instance

Returns

array
array

_prepareRcptCmdsource protected

_prepareRcptCmd( string $email )

Prepares the RCPT TO SMTP command.

Parameters

string $email

The email address to send with the command.

Returns

string
string

_prepareRecipientAddressessource protected

_prepareRecipientAddresses( Cake\Mailer\Email $email )

Prepares the recipient email addresses.

Parameters

Cake\Mailer\Email $email

Email instance

Returns

array
array

_sendDatasource protected

_sendData( Cake\Mailer\Email $email )

Send Data

Parameters

Cake\Mailer\Email $email

Email instance

Throws

Cake\Network\Exception\SocketException
\Cake\Network\Exception\SocketException

_sendRcptsource protected

_sendRcpt( Cake\Mailer\Email $email )

Send emails

Parameters

Cake\Mailer\Email $email

Cake Email

Throws

Cake\Network\Exception\SocketException
\Cake\Network\Exception\SocketException

_smtpSendsource protected

_smtpSend( string|null $data , string|boolean $checkCode '250' )

Protected method for sending data to SMTP connection

Parameters

string|null $data

Data to be sent to SMTP server

string|boolean $checkCode optional '250'

Code to check for in server response, false to skip

Returns

string|null
The matched code, or null if nothing matched

Throws

Cake\Network\Exception\SocketException
\Cake\Network\Exception\SocketException

connectsource public

connect( )

Connect to the SMTP server.

This method tries to connect only in case there is no open connection available already.

connectedsource public

connected( )

Check whether an open connection to the SMTP server is available.

Returns

boolean
bool

disconnectsource public

disconnect( )

Disconnect from the SMTP server.

This method tries to disconnect only in case there is an open connection available.

getLastResponsesource public

getLastResponse( )

Returns the response of the last sent SMTP command.

A response consists of one or more lines containing a response code and an optional response message text:

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

Returns

array
array

sendsource public

send( Cake\Mailer\Email $email )

Send mail

Parameters

Cake\Mailer\Email $email

Email instance

Returns

array
array

Throws

Cake\Network\Exception\SocketException
\Cake\Network\Exception\SocketException

__constructsource public

__construct( array $config [] )

Constructor

Parameters

array $config optional []

Configuration options.

_headersToStringsource protected

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

Help to convert headers in string

Parameters

array $headers

Headers in format key => value

string $eol optional "\r\n"

End of line string.

Returns

string
string

_configDeletesource protected

_configDelete( string $key )

Delete a single config key

Parameters

string $key

Key to delete.

Throws

Cake\Core\Exception\Exception
if attempting to clobber existing config

_configReadsource protected

_configRead( string|null $key )

Read a config variable

Parameters

string|null $key

Key to read.

Returns

mixed
mixed

_configWritesource protected

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

Write a config variable

Parameters

string|array $key

Key to write to.

mixed $value

Value to write.

boolean|string $merge optional false

True to merge recursively, 'shallow' for simple merge, false to overwrite, defaults to false.

Throws

Cake\Core\Exception\Exception
if attempting to clobber existing config

configsource public

config( string|array|null $key null , mixed|null $value null , boolean $merge true )

Usage

Reading the whole config:

$this->config();

Reading a specific value:

$this->config('key');

Reading a nested value:

$this->config('some.nested.key');

Setting a specific value:

$this->config('key', $value);

Setting a nested value:

$this->config('some.nested.key', $value);

Updating multiple config settings at the same time:

$this->config(['one' => 'value', 'another' => 'value']);

Parameters

string|array|null $key optional null

The key to get/set, or a complete array of configs.

mixed|null $value optional null

The value to set.

boolean $merge optional true

Whether to recursively merge or overwrite existing config, defaults to true.

Returns

mixed
Config value being read, or the object itself on write operations.

Throws

Cake\Core\Exception\Exception
When trying to set a key that is invalid.

configShallowsource public

configShallow( string|array $key , mixed|null $value null )

Merge provided config with existing config. Unlike config() which does a recursive merge for nested keys, this method does a simple merge.

Setting a specific value:

$this->config('key', $value);

Setting a nested value:

$this->config('some.nested.key', $value);

Updating multiple config settings at the same time:

$this->config(['one' => 'value', 'another' => 'value']);

Parameters

string|array $key

The key to set, or a complete array of configs.

mixed|null $value optional null

The value to set.

Returns

mixed
$this The object itself.

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

[]

[]

false