MailEvent

API reference › yii › mail › MailEvent

class	`yii\mail\MailEvent`
Extends	`yii\base\Event` » `yii\base\BaseObject`
Implements	`yii\base\Configurable`
Since	2.0
Source	`framework/mail/MailEvent.php`

MailEvent represents the event parameter used for events triggered by BaseMailer.

By setting the $isValid property, one may control whether to continue running the action.

Properties

Property	Type	Description	Defined by
`$data`	`mixed`	The data that is passed to `Component::on()` when attaching an event handler. Default: `null`.	`yii\base\Event`
`$handled`	`bool`	Whether the event is handled. Default: `false`.	`yii\base\Event`
`$isSuccessful`	`bool`	If message was sent successfully. Default: `null`.	`MailEvent`
`$isValid`	`bool`	Whether to continue sending an email. Default: `true`.	`MailEvent`
`$message`	`MessageInterface`	The mail message being send. Default: `null`.	`MailEvent`
`$name`	`string`	The event name. Default: `null`.	`yii\base\Event`
`$sender`	`object\|null`	The sender of this event. Default: `null`.	`yii\base\Event`

Method	Description	Defined by
`__construct()`	Constructor.	`yii\base\BaseObject`
`__call()`	Calls the named method which is not a class method.	`yii\base\BaseObject`
`__get()`	Returns the value of an object property.	`yii\base\BaseObject`
`__isset()`	Checks if a property is set, i.e. defined and not null.	`yii\base\BaseObject`
`__set()`	Sets value of an object property.	`yii\base\BaseObject`
`__unset()`	Sets an object property to null.	`yii\base\BaseObject`
`canGetProperty()`	Returns a value indicating whether a property can be read.	`yii\base\BaseObject`
`canSetProperty()`	Returns a value indicating whether a property can be set.	`yii\base\BaseObject`
`className()` static	Returns the fully qualified name of this class.	`yii\base\BaseObject`
`hasHandlers()` static	Returns a value indicating whether there is any handler attached to the specified class-level event.	`yii\base\Event`
`hasMethod()`	Returns a value indicating whether a method is defined.	`yii\base\BaseObject`
`hasProperty()`	Returns a value indicating whether a property is defined.	`yii\base\BaseObject`
`init()`	Initializes the object.	`yii\base\BaseObject`
`off()` static	Detaches an event handler from a class-level event.	`yii\base\Event`
`offAll()` static	Detaches all registered class-level event handlers.	`yii\base\Event`
`on()` static	Attaches an event handler to a class-level event.	`yii\base\Event`
`trigger()` static	Triggers a class-level event.	`yii\base\Event`

public bool $isValid = true

Whether to continue sending an email.

Event handlers of BaseMailer::EVENT_BEFORE_SEND may set this property to decide whether to continue send or not.