Trait
EmailAssertTrait
Email and mailer assertions.
Property Summary
-
$_email protected
Cake\Mailer\Email
Method Summary
-
any() public @method
-
assertEmailAttachmentsContains() public
Asserts the email attachments contain the given filename (and optionally file info).
-
assertEmailBcc() public
Asserts email is BCC'd to only one email address (and optionally name).
-
assertEmailBccContains() public
Asserts email BCC'd addresses contain given email address (and optionally name).
-
assertEmailCc() public
Asserts email is CC'd to only one email address (and optionally name).
-
assertEmailCcContains() public
Asserts email CC'd addresses contain given email address (and optionally name).
-
assertEmailFrom() public
Asserts email's sender email address and optionally name.
-
assertEmailHtmlMessageContains() public
Asserts HTML email content contains
$needle. -
assertEmailMessageContains() public
Asserts email content (both text and HTML) contains
$needle. -
assertEmailSubject() public
Asserts email's subject contains
$expected. -
assertEmailTextMessageContains() public
Asserts text email content contains
$needle. -
assertEmailTo() public
Asserts email is sent to only the given recipient's address (and optionally name).
-
assertEmailToContains() public
Asserts email recipients' list contains given email address (and optionally name).
-
assertSame() public @method
-
assertTextContains() public @method
-
email() public
Creates an email instance overriding its transport for testing purposes.
-
getMockBuilder() public @method
-
getMockForMailer() public
Generates mock for given mailer class.
-
send() public
Sends email using the test email instance.
Method Detail
any() ¶ public @method
any(): PHPUnit_Framework_MockObject_Matcher_AnyInvokedCount
Returns
PHPUnit_Framework_MockObject_Matcher_AnyInvokedCountassertEmailAttachmentsContains() ¶ public
assertEmailAttachmentsContains(string $filename, array|null $file = null, string|null $message = null): void
Asserts the email attachments contain the given filename (and optionally file info).
Parameters
-
string$filename Expected attachment's filename.
-
array|null$file optional Expected attachment's file info.
-
string|null$message optional The failure message to define.
Returns
voidassertEmailBcc() ¶ public
assertEmailBcc(string $email, string|null $name = null, string|null $message = null): void
Asserts email is BCC'd to only one email address (and optionally name).
Parameters
-
string$email BCC'd email address.
-
string|null$name optional BCC'd person name.
-
string|null$message optional The failure message to define.
Returns
voidassertEmailBccContains() ¶ public
assertEmailBccContains(string $email, string|null $name = null, string|null $message = null): void
Asserts email BCC'd addresses contain given email address (and optionally name).
Parameters
-
string$email BCC'd email address.
-
string|null$name optional BCC'd person name.
-
string|null$message optional The failure message to define.
Returns
voidassertEmailCc() ¶ public
assertEmailCc(string $email, string|null $name = null, string|null $message = null): void
Asserts email is CC'd to only one email address (and optionally name).
Parameters
-
string$email CC'd email address.
-
string|null$name optional CC'd person name.
-
string|null$message optional The failure message to define.
Returns
voidassertEmailCcContains() ¶ public
assertEmailCcContains(string $email, string|null $name = null, string|null $message = null): void
Asserts email CC'd addresses contain given email address (and optionally name).
Parameters
-
string$email CC'd email address.
-
string|null$name optional CC'd person name.
-
string|null$message optional The failure message to define.
Returns
voidassertEmailFrom() ¶ public
assertEmailFrom(string $email, string|null $name = null, string|null $message = null): void
Asserts email's sender email address and optionally name.
Parameters
-
string$email Sender's email address.
-
string|null$name optional Sender's name.
-
string|null$message optional The failure message to define.
Returns
voidassertEmailHtmlMessageContains() ¶ public
assertEmailHtmlMessageContains(string $needle, string|null $message = null): void
Asserts HTML email content contains $needle.
Parameters
-
string$needle Text to look for.
-
string|null$message optional The failure message to define.
Returns
voidassertEmailMessageContains() ¶ public
assertEmailMessageContains(string $needle, string|null $message = null): void
Asserts email content (both text and HTML) contains $needle.
Parameters
-
string$needle Text to look for.
-
string|null$message optional The failure message to define.
Returns
voidassertEmailSubject() ¶ public
assertEmailSubject(string $expected, string|null $message = null): void
Asserts email's subject contains $expected.
Parameters
-
string$expected Email's subject.
-
string|null$message optional The failure message to define.
Returns
voidassertEmailTextMessageContains() ¶ public
assertEmailTextMessageContains(string $needle, string|null $message = null): void
Asserts text email content contains $needle.
Parameters
-
string$needle Text to look for.
-
string|null$message optional The failure message to define.
Returns
voidassertEmailTo() ¶ public
assertEmailTo(string $email, string|null $name = null, string|null $message = null): void
Asserts email is sent to only the given recipient's address (and optionally name).
Parameters
-
string$email Recipient's email address.
-
string|null$name optional Recipient's name.
-
string|null$message optional The failure message to define.
Returns
voidassertEmailToContains() ¶ public
assertEmailToContains(string $email, string|null $name = null, string|null $message = null): void
Asserts email recipients' list contains given email address (and optionally name).
Parameters
-
string$email Recipient's email address.
-
string|null$name optional Recipient's name.
-
string|null$message optional The failure message to define.
Returns
voidassertSame() ¶ public @method
assertSame(mixed $expected, mixed $result, mixed $message): void
Parameters
-
$expected -
$result -
$message
Returns
voidassertTextContains() ¶ public @method
assertTextContains(mixed $needle, mixed $haystack, mixed $message): void
Parameters
-
$needle -
$haystack -
$message
Returns
voidemail() ¶ public
email(bool $new = false): Cake\Mailer\Email
Creates an email instance overriding its transport for testing purposes.
Parameters
-
bool$new optional Tells if new instance should forcibly be created.
Returns
Cake\Mailer\EmailgetMockBuilder() ¶ public @method
getMockBuilder(mixed $className): PHPUnit_Framework_MockObject_MockBuilder
Parameters
-
$className
Returns
PHPUnit_Framework_MockObject_MockBuildergetMockForMailer() ¶ public
getMockForMailer(string $className, array $methods = []): Cake\Mailer\Mailer|PHPUnit_Framework_MockObject_MockObject
Generates mock for given mailer class.
Parameters
-
string$className The mailer's FQCN.
-
array$methods optional The methods to mock on the mailer.
Returns
Cake\Mailer\Mailer|PHPUnit_Framework_MockObject_MockObjectsend() ¶ public
send(array|string|null $content = null): void
Sends email using the test email instance.
Parameters
-
array|string|null$content optional The email's content to send.
Returns
void