2014-10-17 06:53:52 +02:00
|
|
|
title: How to test emails within unit tests
|
|
|
|
|
|
|
|
# Testing Email within Unit Tests
|
|
|
|
|
2016-02-17 22:21:59 +01:00
|
|
|
SilverStripe's test system has built-in support for testing emails sent using the [api:Email] class. If you are
|
|
|
|
running a [api:SapphireTest] test, then it holds off actually sending the email, and instead lets you assert that an
|
2014-10-17 06:53:52 +02:00
|
|
|
email was sent using this method.
|
|
|
|
|
|
|
|
:::php
|
|
|
|
public function MyMethod() {
|
|
|
|
$e = new Email();
|
|
|
|
$e->To = "someone@example.com";
|
|
|
|
$e->Subject = "Hi there";
|
|
|
|
$e->Body = "I just really wanted to email you and say hi.";
|
|
|
|
$e->send();
|
|
|
|
}
|
|
|
|
|
2016-02-17 22:21:59 +01:00
|
|
|
To test that `MyMethod` sends the correct email, use the [api:SapphireTest::assertEmailSent()] method.
|
2014-10-17 06:53:52 +02:00
|
|
|
|
|
|
|
:::php
|
2015-04-21 08:17:56 +02:00
|
|
|
$this->assertEmailSent($to, $from, $subject, $body);
|
2014-10-17 06:53:52 +02:00
|
|
|
|
|
|
|
// to assert that the email is sent to the correct person
|
|
|
|
$this->assertEmailSent("someone@example.com", null, "/th.*e$/");
|
|
|
|
|
|
|
|
|
|
|
|
Each of the arguments (`$to`, `$from`, `$subject` and `$body`) can be either one of the following.
|
|
|
|
|
|
|
|
* A string: match exactly that string
|
|
|
|
* `null/false`: match anything
|
|
|
|
* A PERL regular expression (starting with '/')
|
|
|
|
|
|
|
|
## Related Documentation
|
|
|
|
|
|
|
|
* [Email](../../email)
|
|
|
|
|
|
|
|
## API Documentation
|
|
|
|
|
|
|
|
* [api:Email]
|
|
|
|
|