Class Mailer
Mailer base class.
Mailer classes let you encapsulate related Email logic into a reusable and testable class.
Defining Messages
Mailers make it easy for you to define methods that handle email formatting logic. For example:
class UserMailer extends Mailer { public function resetPassword($user) { $this ->setSubject('Reset Password') ->setTo($user->email) ->set(['token' => $user->token]); } }
Is a trivial example but shows how a mailer could be declared.
Sending Messages
After you have defined some messages you will want to send them:
$mailer = new UserMailer(); $mailer->send('resetPassword', $user);
Event Listener
Mailers can also subscribe to application event allowing you to
decouple email delivery from your application code. By re-declaring the
implementedEvents() method you can define event handlers that can
convert events into email. For example, if your application had a user
registration event:
public function implementedEvents() { return [ 'Model.afterSave' => 'onRegistration', ]; } public function onRegistration(Event $event, Entity $entity, ArrayObject $options) { if ($entity->isNew()) { $this->send('welcome', [$entity]); } }
The onRegistration method converts the application event into a mailer method. Our mailer could either be registered in the application bootstrap, or in the Table class' initialize() hook.
- Cake\Mailer\Mailer implements Cake\Event\EventListenerInterface uses Cake\Datasource\ModelAwareTrait
Properties summary
-
$_clonedEmailprotectedCloned Email instance for restoring instance after email is sent by mailer action.
-
$_emailprotectedEmail instance. -
$namepublic staticstringMailer's name.
Inherited Properties
Method Summary
-
__call() public
Magic method to forward method class to Email instance. -
__construct() public
Constructor. -
getName() public
Returns the mailer's name. -
implementedEvents() public
Implemented events. -
layout() public deprecated
Sets layout to use. -
reset() protected
Reset email instance. -
send() public
Sends email. -
set() public
Sets email view vars. -
viewBuilder() public
Get Email instance's view builder.
Method Detail
__call() public ¶
__call( string $method , array $args )
Magic method to forward method class to Email instance.
Parameters
- string $method
- Method name.
- array $args
- Method arguments
Returns
$this|mixed
implementedEvents() public ¶
implementedEvents( )
Implemented events.
Returns
Implementation of
layout() public deprecated ¶
layout( string $layout )
Sets layout to use.
Deprecated
Parameters
- string $layout
- Name of the layout to use.
Returns
$this
send() public ¶
send( string $action , array $args = [] , array $headers = [] )
Sends email.
Parameters
- string $action
- The name of the mailer action to trigger.
- array $args optional []
- Arguments to pass to the triggered mailer action.
- array $headers optional []
- Headers to set.
Returns
Throws
set() public ¶
set( string|array $key , mixed $value = null )
Sets email view vars.
Parameters
- string|array $key
- Variable name or hash of view variables.
- mixed $value optional null
- View variable value.
Returns
$this
Methods used from Cake\Datasource\ModelAwareTrait
_setModelClass() protected ¶
_setModelClass( string $name )
Set the modelClass and modelKey properties based on conventions.
If the properties are already set they will not be overwritten
Parameters
- string $name
- Class name.
loadModel() public ¶
loadModel( string|null $modelClass = null , string|null $modelType = null )
Loads and constructs repository objects required by this object
Typically used to load ORM Table objects as required. Can also be used to load other types of repository objects your application uses.
If a repository provider does not return an object a MissingModelException will be thrown.
Parameters
- string|null $modelClass optional null
Name of model class to load. Defaults to $this->modelClass. The name can be an alias like
'Post'or FQCN likeApp\Model\Table\PostsTable::class.- string|null $modelType optional null
- The type of repository to load. Defaults to the modelType() value.
Returns
Throws
Cake\Datasource\Exception\MissingModelExceptionIf the model class cannot be found.
InvalidArgumentException
When using a type that has not been registered.
UnexpectedValueException
If no model type has been defined
modelFactory() public ¶
modelFactory( string $type , callable $factory )
Override a existing callable to generate repositories of a given type.
Parameters
- string $type
- The name of the repository type the factory function is for.
- callable $factory
- The factory function used to create instances.
modelType() public deprecated ¶
modelType( string|null $modelType = null )
Set or get the model type to be used by this class
Deprecated
Parameters
- string|null $modelType optional null
- The model type or null to retrieve the current
Returns
setModelType() public ¶
setModelType( string $modelType )
Set the model type to be used by this class
Parameters
- string $modelType
- The model type
Returns
$this
Magic methods summary
Properties detail
$_clonedEmail ¶
Cake\Mailer\Email
Cloned Email instance for restoring instance after email is sent by mailer action.