MailThief
MailThief is a fake mailer for Laravel applications (5.0+) that makes it easy to test mail without actually sending any emails.
Note:
Due to changes in the way mail testing is handled by Laravel; MailThief is not needed for recent versions of the framework. MailThief will remain compatible with Laravel up to version 5.5.
Quickstart
Installation:
composer require tightenco/mailthief --dev
Example route:
Route::post('register', function () {
// <snip> Validation, create account, etc. </snip>
Mail::send('emails.welcome', [], function ($m) {
$email = request('email');
$m->to($email);
$m->subject('Welcome to my app!');
$m->from('[email protected]');
$m->bcc('[email protected]');
$m->getHeaders()->addTextHeader('X-MailThief-Variables', 'mailthief');
});
// <snip> Return response </snip>
});
If you're copying this sample test, remember to create an email view at resources/views/emails/welcome.blade.php
.
Example test:
use MailThief\Testing\InteractsWithMail;
class RegistrationTest extends TestCase
{
// Provides convenient testing traits and initializes MailThief
use InteractsWithMail;
public function test_new_users_are_sent_a_welcome_email()
{
$this->post('register', [
'name' => 'John Doe',
'email' => '[email protected]',
'password' => 'secret',
]);
// Check that an email was sent to this email address
$this->seeMessageFor('[email protected]');
// BCC addresses are included too
$this->seeMessageFor('[email protected]');
// Make sure the email has the correct subject
$this->seeMessageWithSubject('Welcome to my app!');
// Make sure the email was sent from the correct address
$this->seeMessageFrom('[email protected]');
// Make sure a given header is set on an email
$this->seeHeaders('X-MailThief-Variables');
// Make sure the header is set to a given value
$this->seeHeaders('X-MailThief-Variables', 'mailthief');
// Make sure the email contains text in the body of the message
// Default is to search the html rendered view
$this->assertTrue($this->lastMessage()->contains('Some text in the message'));
// To search in the raw text
$this->assertTrue($this->lastMessage()->contains('Some text in the message', 'raw'));
}
}
MailThief supports just about everything you can do with the regular Laravel Mailer
and Message
classes. More detailed documentation is coming soon, but in the mean time, explore the MailThief and Message classes to get an idea of what's available.
If youโre using the new Mailables syntax in Laravel 5.3, you can use the native mail assertions. But if youโre using the classic mail syntax in any version of Laravel, MailThief is still your best option.