Skip to content
forked from tighten/mailthief

A fake mailer for Laravel Applications for testing mail.

Notifications You must be signed in to change notification settings

spyric/mailthief

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

42 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Codeship Status for tightenco/mailthief

MailThief

MailThief is a fake mailer for Laravel applications that makes it easy to test mail without actually sending any emails.

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('noreply@example.com');
        $m->bcc('notifications@example.com');
    });

    // <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\Facades\MailThief;
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' => 'john@example.com',
            'password' => 'secret',
        ]);

        // Check that an email was sent to this email address
        $this->seeMessageFor('john@example.com');

        // BCC addresses are included too
        $this->seeMessageFor('notifications@example.com');

        // Make sure the email has the correct subject
        $this->seeMessageWithSubject('Welcome to my app!');

        // Make sure the email was sent from the correct address
        // (`from` can be a list, so we return it as a collection)
        $this->seeMessageFrom('noreply@example.com');
        
        // Make sure the email contains text in the body of the message
        // Default is to search the html rendered view
        $this->assertTrue(MailThief::lastMessage()->contains('Some text in the message'));
        // To search in the raw text
        $this->assertTrue(MailThief::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.

About

A fake mailer for Laravel Applications for testing mail.

Resources

Stars

Watchers

Forks

Packages

No packages published

Languages

  • PHP 100.0%