Class CakeEmail

Cake e-mail class.

This class is used for handling Internet Message Format based based on the standard outlined in http://www.rfc-editor.org/rfc/rfc2822.txt

Package: Cake\Network\Email
Copyright: Copyright 2005-2011, Cake Software Foundation, Inc. (http://cakefoundation.org)
License: License (http://www.opensource.org/licenses/mit-license.php)
Location: Cake/Network/Email/CakeEmail.php

Constants summary

string

EMAIL_CLIENT ¶

'CakePHP Email'
integer

LINE_LENGTH_MUST ¶

998
integer

LINE_LENGTH_SHOULD ¶

78
string

MESSAGE_HTML ¶

'html'
string

MESSAGE_TEXT ¶

'text'

Properties summary

$_appCharset public

string

The application wide charset, used to encode headers and body
$_attachments protected

array

List of files that should be attached to the email.
$_bcc protected

array

Blind Carbon Copy
$_boundary protected

string

If set, boundary to use for multipart mime messages
$_cc protected

array

Carbon Copy
$_charset8bit protected

array

8Bit character sets
$_config protected

mixed

Configuration to transport
$_emailFormat protected

string

What format should the email be sent in
$_emailFormatAvailable protected

array

Available formats to be sent.
$_from protected

array

The mail which the email is sent from
$_headers protected

array

Associative array of a user defined headers Keys will be prefixed 'X-' as per RFC2822 Section 4.7.5
$_helpers protected

array

Helpers to be used in the render
$_htmlMessage protected

string

Html message
$_layout protected

string

Layout for the View
$_message protected

array

Final message to send
$_messageId protected

mixed

Message ID
$_readReceipt protected

array

The read receipt email
$_replyTo protected

array

The email the recipient will reply to
$_returnPath protected

array

The mail that will be used in case of any errors like - Remote mailserver down - Remote user has exceeded his quota - Unknown user
$_sender protected

array();

The sender email
$_subject protected

string

The subject of the email
$_template protected

string

Template for the view
$_textMessage protected

string

Text message
$_to protected

array

Recipient of the email
$_transportClass protected

AbstractTransport

Instance of transport class
$_transportName protected

string

What method should the email be sent
$_viewRender protected

string

View for render
$_viewVars protected

array

Vars to sent to render
$charset public

string

Charset the email body is sent in
$headerCharset public

string

Charset the email header is sent in If null, the $charset property will be used as default

Method Summary

__construct() public

Constructor
_addEmail() protected

Add email
_applyConfig() protected

Apply the config to an instance
_attachFiles() protected

Attach non-embedded files by adding file contents inside boundaries.
_attachInlineFiles() protected

Attach inline/embedded files to the message.
_createBoundary() protected

Create unique boundary identifier
_encode() protected

Encode the specified string using the current charset
_encodeString() protected

Translates a string for one charset to another if the App.encoding value differs and the mb_convert_encoding function exists
_formatAddress() protected

Format addresses
_getContentTransferEncoding() protected

Return the Content-Transfer Encoding value based on the set charset
_getTypes() protected

Gets the text body types that are in this email message
_readFile() protected

Read the file contents and return a base64 version of the file contents.
_render() protected

Render the body of the email.
_renderTemplates() protected

Build and set all the view properties needed to render the templated emails. If there is no template set, the $content will be returned in a hash of the text content types for the email.
_setEmail() protected

Set email
_setEmailSingle() protected

Set only 1 email
_wrap() protected

Wrap the message to follow the RFC 2822 - 2.1.1
addAttachments() public

Add attachments
addBcc() public

Add Bcc
addCc() public

Add Cc
addHeaders() public

Add header for the message
addTo() public

Add To
attachments() public

Add attachments to the email message
bcc() public

Bcc
cc() public

Cc
config() public

Configuration to use when send email
deliver() public static

Static method to fast create an instance of CakeEmail
emailFormat() public

Email format
from() public

From
getHeaders() public

Get list of headers
helpers() public

Helpers to be used in render
message() public

Get generated message (used by transport classes)
messageId() public

Message-ID
readReceipt() public

Read Receipt (Disposition-Notification-To header)
replyTo() public

Reply-To
reset() public

Reset all EmailComponent internal variables to be able to send out a new email.
returnPath() public

Return Path
send() public

Send an email using the specified content, template and layout
sender() public

Sender
setHeaders() public

Sets headers for the message
subject() public

Get/Set Subject.
template() public

Template and layout
to() public

To
transport() public

Transport name
transportClass() public

Return the transport class
viewRender() public

View class for render
viewVars() public

Variables to be set on render

Method Detail

__construct() public ¶

__construct( mixed $config = null )

Constructor

Parameters

mixed $config optional null: Array of configs, or string to load configs from email.php

_addEmail() protected ¶

_addEmail( string $varName , mixed $email , mixed $name )

Add email

Parameters

string $varName
mixed $email
mixed $name

Returns

CakeEmail
$this

Throws

SocketException

_applyConfig() protected ¶

_applyConfig( CakeEmail $config , array $config ,… )

Apply the config to an instance

Parameters

CakeEmail $config: $obj CakeEmail
array $config ,…

_attachFiles() protected ¶

_attachFiles( string $boundary = null )

Attach non-embedded files by adding file contents inside boundaries.

Parameters

string $boundary optional null: Boundary to use. If null, will default to $this->_boundary

Returns

array
An array of lines to add to the message

_attachInlineFiles() protected ¶

_attachInlineFiles( string $boundary = null )

Attach inline/embedded files to the message.

Parameters

string $boundary optional null: Boundary to use. If null, will default to $this->_boundary

Returns

array
An array of lines to add to the message

_createBoundary() protected ¶

_createBoundary( )

Create unique boundary identifier

_encode() protected ¶

_encode( string $text )

Encode the specified string using the current charset

Parameters

string $text: String to encode

Returns

string
Encoded string

_encodeString() protected ¶

_encodeString( string $text , string $charset )

Translates a string for one charset to another if the App.encoding value differs and the mb_convert_encoding function exists

Parameters

string $text: The text to be converted
string $charset: the target encoding

Returns

string

_formatAddress() protected ¶

_formatAddress( array $address )

Format addresses

Parameters

array $address

Returns

array

_getContentTransferEncoding() protected ¶

_getContentTransferEncoding( )

Return the Content-Transfer Encoding value based on the set charset

_getTypes() protected ¶

_getTypes( )

Gets the text body types that are in this email message

Returns

array
Array of types. Valid types are 'text' and 'html'

_readFile() protected ¶

_readFile( string $file )

Read the file contents and return a base64 version of the file contents.

Parameters

string $file: The file to read.

Returns

string
File contents in base64 encoding

_render() protected ¶

_render( string $content )

Render the body of the email.

Parameters

string $content: Content to render

Returns

array
Email body ready to be sent

_renderTemplates() protected ¶

_renderTemplates( string $content )

Build and set all the view properties needed to render the templated emails. If there is no template set, the $content will be returned in a hash of the text content types for the email.

Parameters

string $content: The content passed in from send() in most cases.

Returns

array
The rendered content with html and text keys.

_setEmail() protected ¶

_setEmail( string $varName , mixed $email , mixed $name )

Set email

Parameters

string $varName
mixed $email
mixed $name

Returns

CakeEmail
$this

Throws

SocketException

_setEmailSingle() protected ¶

_setEmailSingle( string $varName , mixed $email , string $name , string $throwMessage )

Set only 1 email

Parameters

string $varName
mixed $email
string $name
string $throwMessage

Returns

CakeEmail
$this

Throws

SocketException

_wrap() protected ¶

_wrap( string $message )

Wrap the message to follow the RFC 2822 - 2.1.1

Parameters

string $message: Message to wrap

Returns

array
Wrapped message

addAttachments() public ¶

addAttachments( mixed $attachments )

Add attachments

Parameters

mixed $attachments: String with the filename or array with filenames

Returns

CakeEmail
$this

Throws

SocketException

addBcc() public ¶

addBcc( mixed $email , string $name = null )

Add Bcc

Parameters

mixed $email: String with email, Array with email as key, name as value or email as value (without name)
string $name optional null

Returns

CakeEmail
$this

addCc() public ¶

addCc( mixed $email , string $name = null )

Add Cc

Parameters

mixed $email: String with email, Array with email as key, name as value or email as value (without name)
string $name optional null

Returns

CakeEmail
$this

addHeaders() public ¶

addHeaders( array $headers )

Add header for the message

Parameters

array $headers

Returns

object
$this

Throws

SocketException

addTo() public ¶

addTo( mixed $email , string $name = null )

Add To

Parameters

mixed $email: String with email, Array with email as key, name as value or email as value (without name)
string $name optional null

Returns

CakeEmail
$this

attachments() public ¶

attachments( mixed $attachments = null )

Add attachments to the email message

Attachments can be defined in a few forms depending on how much control you need:

Attach a single file:

{{{ $email->attachments('path/to/file'); }}}

Attach a file with a different filename:

{{{ $email->attachments(array('custom_name.txt' => 'path/to/file.txt')); }}}

Attach a file and specify additional properties:

{{{ $email->attachments(array('custom_name.png' => array( 'file' => 'path/to/file', 'mimetype' => 'image/png', 'contentId' => 'abc123' )); }}}

The contentId key allows you to specify an inline attachment. In your email text, you can use <img src="cid:abc123" /> to display the image inline.

Parameters

mixed $attachments optional null: String with the filename or array with filenames

Returns

mixed
Either the array of attachments when getting or $this when setting.

Throws

SocketException

bcc() public ¶

bcc( mixed $email = null , string $name = null )

Bcc

Parameters

mixed $email optional null: String with email, Array with email as key, name as value or email as value (without name)
string $name optional null

Returns

mixed

cc() public ¶

cc( mixed $email = null , string $name = null )

Parameters

mixed $email optional null: String with email, Array with email as key, name as value or email as value (without name)
string $name optional null

Returns

mixed

config() public ¶

config( mixed $config = null )

Configuration to use when send email

Parameters

mixed $config optional null: String with configuration name (from email.php), array with config or null to return current config

Returns

mixed

deliver() public static ¶

deliver( mixed $to = null , mixed $subject = null , mixed $message = null , mixed $transportConfig = 'fast' , boolean $send = true )

Static method to fast create an instance of CakeEmail

Parameters

mixed $to optional null: Address to send (see CakeEmail::to()). If null, will try to use 'to' from transport config
mixed $subject optional null: String of subject or null to use 'subject' from transport config
mixed $message optional null: String with message or array with variables to be used in render
mixed $transportConfig optional 'fast': String to use config from EmailConfig or array with configs
boolean $send optional true: Send the email or just return the instance pre-configured

Returns

CakeEmail
Instance of CakeEmail

Throws

SocketException

emailFormat() public ¶

emailFormat( string $format = null )

Email format

Parameters

string $format optional null

Returns

mixed

Throws

SocketException

from() public ¶

from( mixed $email = null , string $name = null )

From

Parameters

mixed $email optional null
string $name optional null

Returns

mixed

Throws

SocketException

getHeaders() public ¶

getHeaders( array $include = array() )

Get list of headers

Includes:

from
replyTo
readReceipt
returnPath
to
cc
bcc
subject

Parameters

array $include optional array()

Returns

array

helpers() public ¶

helpers( array $helpers = null )

Helpers to be used in render

Parameters

array $helpers optional null

Returns

mixed

message() public ¶

message( mixed $type = null )

Get generated message (used by transport classes)

Parameters

mixed $type optional null: Use MESSAGE_* constants or null to return the full message as array

Returns

mixed
String if have type, array if type is null

messageId() public ¶

messageId( mixed $message = null )

Message-ID

Parameters

mixed $message optional null: True to generate a new Message-ID, False to ignore (not send in email), String to set as Message-ID

Returns

mixed

Throws

SocketException

readReceipt() public ¶

readReceipt( mixed $email = null , string $name = null )

Read Receipt (Disposition-Notification-To header)

Parameters

mixed $email optional null
string $name optional null

Returns

mixed

Throws

SocketException

replyTo() public ¶

replyTo( mixed $email = null , string $name = null )

Reply-To

Parameters

mixed $email optional null
string $name optional null

Returns

mixed

Throws

SocketException

reset() public ¶

reset( )

Reset all EmailComponent internal variables to be able to send out a new email.

Returns

CakeEmail
$this

returnPath() public ¶

returnPath( mixed $email = null , string $name = null )

Return Path

Parameters

mixed $email optional null
string $name optional null

Returns

mixed

Throws

SocketException

send() public ¶

send( $content = null )

Send an email using the specified content, template and layout

Returns

array

Throws

SocketException

sender() public ¶

sender( mixed $email = null , string $name = null )

Sender

Parameters

mixed $email optional null
string $name optional null

Returns

mixed

Throws

SocketException

setHeaders() public ¶

setHeaders( array $headers )

Sets headers for the message

Parameters

array $headers: Associative array containing headers to be set.

Returns

CakeEmail
$this

Throws

SocketException

subject() public ¶

subject( null|string $subject = null )

Get/Set Subject.

Parameters

null|string $subject optional null

Returns

mixed

template() public ¶

template( mixed $template = false , mixed $layout = false )

Template and layout

Parameters

mixed $template optional false: Template name or null to not use
mixed $layout optional false: Layout name or null to not use

Returns

mixed

to() public ¶

to( mixed $email = null , string $name = null )

Parameters

mixed $email optional null: Null to get, String with email, Array with email as key, name as value or email as value (without name)
string $name optional null

Returns

mixed

transport() public ¶

transport( string $name = null )

Transport name

Parameters

string $name optional null

Returns

mixed

transportClass() public ¶

transportClass( )

Return the transport class

Returns

CakeEmail

Throws

SocketException

viewRender() public ¶

viewRender( string $viewClass = null )

View class for render

Parameters

string $viewClass optional null

Returns

mixed

viewVars() public ¶

viewVars( array $viewVars = null )

Variables to be set on render

Parameters

array $viewVars optional null

Returns

mixed

Properties detail

`$_appCharset` ¶

public string

The application wide charset, used to encode headers and body

null

`$_attachments` ¶

protected array

List of files that should be attached to the email.

Only absolute paths

array()

`$_bcc` ¶

protected array

Blind Carbon Copy

List of email's that should receive a copy of the email. The Recipient WILL NOT be able to see this list

array()

`$_boundary` ¶

protected string

If set, boundary to use for multipart mime messages

null

`$_cc` ¶

protected array

Carbon Copy

List of email's that should receive a copy of the email. The Recipient WILL be able to see this list

array()

`$_charset8bit` ¶

protected array

8Bit character sets

array('UTF-8', 'SHIFT_JIS')

`$_config` ¶

protected mixed

Configuration to transport

array()

`$_emailFormat` ¶

protected string

What format should the email be sent in

'text'

`$_emailFormatAvailable` ¶

protected array

Available formats to be sent.

array('text', 'html', 'both')

`$_from` ¶

protected array

The mail which the email is sent from

array()

`$_headers` ¶

protected array

Associative array of a user defined headers Keys will be prefixed 'X-' as per RFC2822 Section 4.7.5

array()

`$_helpers` ¶

protected array

Helpers to be used in the render

array('Html')

`$_htmlMessage` ¶

protected string

Html message

''

`$_layout` ¶

protected string

Layout for the View

'default'

`$_message` ¶

protected array

Final message to send

array()

`$_messageId` ¶

protected mixed

Message ID

true

`$_readReceipt` ¶

protected array

The read receipt email

array()

`$_replyTo` ¶

protected array

The email the recipient will reply to

array()

`$_returnPath` ¶

protected array

The mail that will be used in case of any errors like - Remote mailserver down - Remote user has exceeded his quota - Unknown user

array()

`$_sender` ¶

protected array();

The sender email

array()

`$_subject` ¶

protected string

The subject of the email

''

`$_template` ¶

protected string

Template for the view

''

`$_textMessage` ¶

protected string

Text message

''

`$_to` ¶

protected array

Recipient of the email

array()

`$_transportClass` ¶

protected AbstractTransport

Instance of transport class

null

`$_transportName` ¶

protected string

What method should the email be sent

'Mail'

`$_viewRender` ¶

protected string

View for render

'View'

`$_viewVars` ¶

protected array

Vars to sent to render

array()

`$charset` ¶

public string

Charset the email body is sent in

'utf-8'

`$headerCharset` ¶

public string

Charset the email header is sent in If null, the $charset property will be used as default

null

Packages

Classes

Class CakeEmail

Constants summary

Properties summary

Method Summary

__construct() public

_addEmail() protected

_applyConfig() protected

_attachFiles() protected

_attachInlineFiles() protected

_createBoundary() protected

_encode() protected

_encodeString() protected

_formatAddress() protected

_getContentTransferEncoding() protected

_getTypes() protected

_readFile() protected

_render() protected

_renderTemplates() protected

_setEmail() protected

_setEmailSingle() protected

_wrap() protected

addAttachments() public

addBcc() public

addCc() public

addHeaders() public

addTo() public

attachments() public

bcc() public

cc() public

config() public

deliver() public static

emailFormat() public

from() public

getHeaders() public

helpers() public

message() public

messageId() public

readReceipt() public

replyTo() public

reset() public

returnPath() public

send() public

sender() public

setHeaders() public

subject() public

template() public

to() public

transport() public

transportClass() public

viewRender() public

viewVars() public

Method Detail

__construct() public ¶

Parameters

_addEmail() protected ¶

Parameters

Returns

Throws

_applyConfig() protected ¶

Parameters

_attachFiles() protected ¶

Parameters

Returns

_attachInlineFiles() protected ¶

Parameters

Returns

_createBoundary() protected ¶

_encode() protected ¶

Parameters

Returns

_encodeString() protected ¶

Parameters

Returns

_formatAddress() protected ¶

Parameters

Returns

_getContentTransferEncoding() protected ¶

_getTypes() protected ¶