• Stars
    star
    686
  • Rank 63,259 (Top 2 %)
  • Language
    PHP
  • Created over 8 years ago
  • Updated over 1 year ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

A fake mailer for Laravel Applications for testing mail.

Github Actions Status MailThief Logo

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.

More Repositories

1

ziggy

Use your Laravel routes in JavaScript.
JavaScript
3,668
star
2

jigsaw

Simple static sites with Laravel’s Blade.
PHP
2,083
star
3

takeout

Docker-based development-only dependency manager. macOS, Linux, and WSL2-only and installs via PHP's Composer... for now.
PHP
1,569
star
4

collect

A Collections-only split from Laravel's Illuminate Support
PHP
1,505
star
5

parental

Use single table inheritance in your Laravel app
PHP
1,249
star
6

lambo

Quick new application creation with Laravel and Valet
PHP
613
star
7

tlint

Tighten linter for Laravel conventions.
PHP
494
star
8

duster

Automatic configuration for Laravel apps to apply Tighten's standard linting & code standards.
PHP
343
star
9

novapackages

PHP
331
star
10

quicksand

Easily schedule regular cleanup of old soft-deleted Eloquent data.
PHP
294
star
11

gistlog

GistLog - simple, easy blogging based on GitHub gists
CSS
273
star
12

symposium

Management of proposals, bios, photos, etc. for conference speakers.
PHP
171
star
13

nova-google-analytics

Google Analytics integration with Laravel Nova
PHP
161
star
14

onramp

Easing the onramp for new or non-PHP developers to become Laravel devs.
PHP
152
star
15

overload

Method overloading in PHP
PHP
113
star
16

nova-stripe

Easily show information about Stripe charges and balances in your Nova dashboard
JavaScript
105
star
17

giscus

Notifications for Gist Comments
PHP
104
star
18

laravelversions

PHP
94
star
19

jigsaw-blog-template

Starter template for a blog, using Jigsaw by Tighten
Blade
92
star
20

confomo

ConFOMO is a simple tool that makes it easy to track your friends at conferences.
JavaScript
74
star
21

ozzie

Open source project monitor for Tighten
PHP
55
star
22

nova-package-development

A forum for talking about the process of Nova Package Development
52
star
23

jigsaw-docs-template

Starter template for a documentation site, using Jigsaw by Tighten
Blade
44
star
24

liftoff

A quick start for Laravel development in a new environment
Shell
39
star
25

craft-build-query

A plugin for Craft CMS, demonstrating how to build complex or optimized queries by modifying an ElementCriteriaModel.
PHP
39
star
26

builtwithjigsaw

A list of sites built with Jigsaw
Blade
35
star
27

react-gif-search-engine

React GIF Search Engine
JavaScript
33
star
28

react-gif-search-engine-old

JavaScript
32
star
29

jigsaw-site

Jigsaw Documentation Site
Blade
29
star
30

blink-my-lights

Quick proof-of-concept for flashing/blinking lights with Laravel and IFTTT
PHP
26
star
31

laravelm1

Tracking what works and doesn't in the Laravel ecosystem on M1
Blade
25
star
32

configs

Standard config files for Tighten projects
PHP
24
star
33

nova-releases

A package to provide a card and a tool giving information about Nova releases, including whether you're current
Vue
20
star
34

consoles

Quick shortcut list to API developer consoles
PHP
19
star
35

json-api-examples

Implementing JSON:API in laravel
18
star
36

laravel-react-demo

Demo of how to include React components in a Laravel project with Elixir
PHP
17
star
37

laravel-mix-jigsaw

Laravel Mix plugin for Jigsaw.
JavaScript
16
star
38

nova-package-discovery

Nova card for showing stats from novapackages.com
PHP
16
star
39

simplecast-php

Simplecast PHP SDK
PHP
15
star
40

checkmate

Check the version of all your Laravel apps and notify if they're out of date
PHP
14
star
41

tighten-coding-standard

A PHP Code_Sniffer configuration for Tighten's coding standard.
PHP
14
star
42

php-package-skeleton

Tighten's PHP Package skeleton -- inspired by & some source from spatie/skeleton-php
Shell
14
star
43

saasaas

SaaSaaS - create your next "AirBnB for ___" idea
PHP
14
star
44

laravel-elixir-webpack-react

A package to provide support for compiling React JSX files in Laravel Elixir 6
JavaScript
13
star
45

podcast-subscriber

Easy podcast subscriber app
PHP
10
star
46

laravel-mix-react

Easy alternative Laravel Mix configuration for projects using React
JavaScript
10
star
47

laravel-preset-jest

Front-end presets that include Jest for React and Vue
PHP
9
star
48

laraveldrivers

List all third-party Laravel drivers
PHP
9
star
49

easy-embeddable-polls

easy-static-polls
Vue
8
star
50

valet-fallback

Fallback web site for Valet
PHP
8
star
51

blade-style-guide

"PSR-Blade"--style guide for Laravel Blade
8
star
52

dev-battle-1-react

Tighten Co. Senior Dev Battle - React app
PHP
7
star
53

phpreleases-action

GitHub action that integrates with the PHP Releases API.
6
star
54

dev-battle-1-vue

Tighten Co. Senior Dev Battle - Vue app[
JavaScript
6
star
55

react-native-time-input

A simple time input component with autoformatting.
TypeScript
6
star
56

duster-action

Dockerfile
6
star
57

jigsaw-collections-demo

CSS
5
star
58

tlint-plugin

TLint PHPStorm Plugin
Kotlin
4
star
59

gif-gif-vue

Samantha Geitz Jest testing in Vue Laracon talk
PHP
4
star
60

hyperspoon

Lua
4
star
61

gif-gif-react

React version of Samantha Geitz's Jest Testing Laracon talk
PHP
4
star
62

postit

PHP
3
star
63

laravel-elixir-elm

JavaScript
3
star
64

pickr-api

PHP
3
star
65

jazz

JavaScript-inspired development utilities
PHP
2
star
66

tallstack

The new web site for tallstack.dev
PHP
2
star
67

nova-tighten-themes

Tighten's Nova Themes
CSS
2
star
68

learnwebdevelopment

LearnWebDevelopment.org
CSS
2
star
69

intro-to-react

Intro to React workshop given by Samantha Geitz at PeersConf 2018
JavaScript
2
star
70

tlint-sublime-plugin

tlint-sublime-plugin
Python
2
star
71

omgphp

OMGPHP.com
CSS
1
star
72

borsh-php

1
star
73

phpreleases

API endpoints with support information for PHP major/minor versions and releases 5.6 and later
PHP
1
star
74

pickr-nativescript

NativeScript version of Pickr for Tighten Dev Battle 2
CSS
1
star
75

dev-battle-landing

Landing page for the Tighten Dev Battle
PHP
1
star
76

automation-scripts

Lua
1
star
77

pickr-reactnative

JavaScript
1
star
78

mon-petit

PHP
1
star
79

whyphp

CSS
1
star
80

laravelstar

Vue
1
star