micc83 / mailamie

🌈 Mailamie is a simple SMTP catch all server for testing written in PHP.

Mailamie

Catch All SMTP Server for testing

Index

• Why
• About
• Install
• Usage
• Settings
• Changelog
• License

Why

Sometime you just need a simple tool to verify that some legacy project, without tests in place or with some very complex environment, sends the right emails to the right people. Surely there're many valid tools out there for the job but as it's not something happening every day it's pretty cumbersome having to install these tools.

Mailamie is a side project I've put up in my summer vacations for playing with async PHP. Using it is as simple as setting a few parameters on your project:

# Ex. Laravel .env file
MAIL_MAILER=smtp
MAIL_HOST=127.0.0.1
MAIL_PORT=8025
MAIL_ENCRYPTION=null

and running it with the command:

$ mailamie

How

Mailamie is a pretty simple Catch All SMTP Server for local testing completely written in PHP and based on the great work made by the folks at ReactPhp.

It's in no way a replacement for more complete tools such as Mailhog as it doesn't actually check SMTP implementantion details, instead it only cares about getting emails headers and body for high level delivery testing.

DO NOT USE IN PRODUCTION. Mailamie starts three different servers (SMTP on port 8025, HTTP on port 8080, WebSocket on port 1338). No steps have been taken to secure any of the three. Also, external access to those ports should be blocked.

Mailamie can be used directly from the CLI:

or, for better UX, in the browser:

Install

Mailamie requires PHP ^7.4. To install it globally on your system run the following command to install:

composer global require micc83/mailamie

Usage

Run the following command to get help:

mailamie --help

The output will be:

Description:
  Mailamie is catch all SMTP server for testing.

Usage:
  mailamie [options]
  mailamie --host=127.0.0.1 --port=25    Ex. SMTP Host definition

Options:
  -H, --host=HOST       Set the host on which to listen for calls
  -p, --port=PORT       Set the port on which to listen for SMTP calls
  -h, --help            Display this help message
  -q, --quiet           Do not output any message
  -V, --version         Display this application version
      --ansi            Force ANSI output
      --no-ansi         Disable ANSI output
  -n, --no-interaction  Do not ask any interactive question
  -v|vv|vvv, --verbose  Increase the verbosity of messages: 1 for normal output, 2 for more verbose output and 3 for debug

Help:
  You can define custom configuration from the file ~/.mailamie.config.php,
  check the project readme file at https://github.com/micc83/mailamie
  for all the available settings.

Settings

You can define default settings in ~/.mailamie.config.php, in order to do so run:

$ touch ~/.mailamie.config.php && vim ~/.mailamie.config.php

This files returns a PHP array with the following available settings.

<?php

return [
    'smtp' => [
        'host' => '127.0.0.1',
        'port' => '8025'
    ],

    'http' => [
        'host' => '127.0.0.1',
        'port' => '8080'
    ],

    'websocket' => [
        'host' => '127.0.0.1',
        'port' => '1338'
    ],
];

You'd better define only the needed ones, in case something should change after upgrades.

mailamie's Issues

Add codecov badge to readme.md file

See https://codecov.io/gh/micc83/mailamie

Write missing test for HttpController

After this we might consider refactoring all unit/integration tests and improve the acceptance test.

Add flag to automatically open web interface as a Chrome App

Add a --chrome-app flag to automatically open the web interface as a Chrome App.

For reference on macOs:

/Applications/Google\ Chrome.app/Contents/MacOS/Google\ Chrome --app=http://127.0.0.1:8080

In many circumstances dots are duplicated in the html version

Ex. https://comodohotel-v4..test/storage/seeds/etc

Double check dependencies licenses

Already did it before but better safe than sorry.

Allow emails forwarding

A nice feature would be to allow to forward singular email from the web ui or setting a --forwardto [email protected] option to the CLI that would forward all the emails to the given address.

In order to do so we can leverage PHP mail or allow to set SMTP settings in the config file (I wouldn't add CLI options for that as it would be cumbersome).

Any thought on this issue would be appreciated.

Fatal error: Uncaught TypeError: Mailamie\Emails\Message::__construct(): Argument #7 ($textBody) must be of type string, null given

Fatal error: Uncaught TypeError: Mailamie\Emails\Message::__construct(): 
Argument #7 ($textBody) must be of type string, null given

Called in:
  /mailamie/src/Emails/Parser.php on line 35
and defined in 
  /mailamie/src/Emails/Message.php:45