PHPUnit mail assertions for testing email in Laravel.

0.3.2 2018-03-05 13:55 UTC


NOTE: This is based off a video titled "Testing Email With Custom Assertions" that Jeffrey Way did on If you do not have an account on that site, then you should make one. It is an amazing resource. We have just taken that example & made it an easy to install package. Thanks Jeffrey!

Latest Stable Version Total Downloads Latest Unstable Version Dependency Status License

PHPUnit mail assertions for testing email in Laravel.

Build Status

Branch Status Coverage Code Quality
Develop Build Status Coverage Status Scrutinizer Code Quality
Master Build Status Coverage Status Scrutinizer Code Quality


Install the package:

    $ composer require spinen/laravel-mail-assertions


In order for the package to be able to make assertions on your emails, it has to be able to "read" the messages. It does so by parsing the laravel log, so your mail driver has to be "log" for this package to function.


You mixin the assertions with the Spinen\MailAssertions\MailTracking trait. You get the following assertions...

  • seeEmailBcc
  • seeEmailCc
  • seeEmailContains
  • seeEmailContentTypeEquals
  • seeEmailCountEquals
  • seeEmailDoesNotContain
  • seeEmailEquals
  • seeEmailFrom
  • seeEmailPriorityEquals
  • seeEmailReplyTo
  • seeEmailSubjectContains
  • seeEmailSubjectDoesNotContain
  • seeEmailSubjectEquals
  • seeEmailTo
  • seeEmailWasNotSent
  • seeEmailWasSent

NOTE: If there was more than 1 email sent, then the assertions look at the last email.


use Illuminate\Foundation\Testing\WithoutMiddleware;
use Illuminate\Foundation\Testing\DatabaseMigrations;
use Illuminate\Foundation\Testing\DatabaseTransactions;
use Spinen\MailAssertions\MailTracking;

class ExampleTest extends TestCase
    use MailTracking;

     * A basic functional test example.
     * @return void
    public function testBasicExample()
             ->seeEmailSubject('Hello World')
             ->seeEmailEquals('Click here to buy this jewelry.')
             ->seeEmailContains('Click here');