Class SmtpTransport

Send mail using SMTP protocol

Cake\Mailer\AbstractTransport uses Cake\Core\InstanceConfigTrait
Extended by Cake\Mailer\Transport\SmtpTransport

Properties summary

Inherited Properties

Method Summary

Method Detail

__destruct()source public

__destruct( )

Destructor

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

_auth()source protected

_auth( )

Send authentication

Throws

Cake\Network\Exception\SocketException

_bufferResponseLines()source protected

_bufferResponseLines( array $responseLines )

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

Parameters

array $responseLines
Response lines to parse.

_connect()source protected

_connect( )

Connect to SMTP Server

Throws

Cake\Network\Exception\SocketException

_disconnect()source protected

_disconnect( )

Disconnect

Throws

Cake\Network\Exception\SocketException

_generateSocket()source protected

_generateSocket( )

Helper method to generate socket

Throws

Cake\Network\Exception\SocketException

_prepareFromAddress()source protected

_prepareFromAddress( Cake\Mailer\Email $email )

Prepares the from email address.

Parameters

Cake\Mailer\Email $email
Email instance

Returns

array

_prepareFromCmd()source protected

_prepareFromCmd( string $email )

Prepares the MAIL FROM SMTP command.

Parameters

string $email
The email address to send with the command.

Returns

string

_prepareMessage()source protected

_prepareMessage( Cake\Mailer\Email $email )

Prepares the message body.

Parameters

Cake\Mailer\Email $email
Email instance

Returns

string

_prepareMessageHeaders()source protected

_prepareMessageHeaders( Cake\Mailer\Email $email )

Prepares the message headers.

Parameters

Cake\Mailer\Email $email
Email instance

Returns

array

_prepareRcptCmd()source protected

_prepareRcptCmd( string $email )

Prepares the RCPT TO SMTP command.

Parameters

string $email
The email address to send with the command.

Returns

string

_prepareRecipientAddresses()source protected

_prepareRecipientAddresses( Cake\Mailer\Email $email )

Prepares the recipient email addresses.

Parameters

Cake\Mailer\Email $email
Email instance

Returns

array

_sendData()source protected

_sendData( Cake\Mailer\Email $email )

Send Data

Parameters

Cake\Mailer\Email $email
Email instance

Throws

Cake\Network\Exception\SocketException

_sendRcpt()source protected

_sendRcpt( Cake\Mailer\Email $email )

Send emails

Parameters

Cake\Mailer\Email $email
Cake Email

Throws

Cake\Network\Exception\SocketException

_smtpSend()source 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

connect()source public

connect( )

Connect to the SMTP server.

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

connected()source public

connected( )

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

Returns

boolean

disconnect()source public

disconnect( )

Disconnect from the SMTP server.

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

getLastResponse()source 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

send()source public

send( Cake\Mailer\Email $email )

Send mail

Parameters

Cake\Mailer\Email $email
Email instance

Returns

array

Throws

Cake\Network\Exception\SocketException

Methods inherited from Cake\Mailer\AbstractTransport

__construct()source public

__construct( array $config [] )

Constructor

Parameters

array $config optional []
Configuration options.

_headersToString()source 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

Methods used from Cake\Core\InstanceConfigTrait

_configDelete()source protected

_configDelete( string $key )

Deletes a single config key.

Parameters

string $key
Key to delete.

Throws

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

_configRead()source protected

_configRead( string|null $key )

Reads a config key.

Parameters

string|null $key
Key to read.

Returns

mixed

_configWrite()source protected

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

Writes a config key.

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

config()source public

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

Gets/Sets the config.

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']);

Deprecated

3.4.0 use setConfig()/getConfig() instead.

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.

configShallow()source 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->configShallow('key', $value);

Setting a nested value:

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

Updating multiple config settings at the same time:

$this->configShallow(['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


$this

getConfig()source public

getConfig( string|null $key null , mixed $default null )

Returns the config.

Usage

Reading the whole config:

$this->getConfig();

Reading a specific value:

$this->getConfig('key');

Reading a nested value:

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

Reading with default value:

$this->getConfig('some-key', 'default-value');

Parameters

string|null $key optional null
The key to get or null for the whole config.
mixed $default optional null
The return value when the key does not exist.

Returns

mixed
Config value being read.

setConfig()source public

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

Sets the config.

Usage

Setting a specific value:

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

Setting a nested value:

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

Updating multiple config settings at the same time:

$this->setConfig(['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.
boolean $merge optional true
Whether to recursively merge or overwrite existing config, defaults to true.

Returns


$this

Throws

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

Properties detail

$_contentsource

protected array

Content of email to return

[]

$_defaultConfigsource

protected array

Default config for this class

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

$_lastResponsesource

protected array

The response of the last sent SMTP command.

[]

$_socketsource

protected Cake\Network\Socket

Socket to SMTP server

© 2005–2017 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.4/class-Cake.Mailer.Transport.SmtpTransport.html