Provides a module and gherkin steps to access a mailhog api for codeception testing

4.0.0 2024-03-13 13:00 UTC

This package is auto-updated.

Last update: 2024-05-13 13:18:02 UTC


Gherkin Steps and module functions to test using Mailhog

How to use


You have to have Mailhog installed and have your application configured to send mails to mailhog. See https://github.com/mailhog/MailHog


You have to add the Webdriver module to your config to use the Mailhog module. Use the module PunktDe\Codeception\Mailhog\Module\Mailhog in your codeception.yaml. You can configure under which uri the mailhog client is reachable (default is

      - WebDriver:
        url: 'http://acceptance.dev.punkt.de/'
        browser: chrome
        restart: true
        window_size: 1920x2080
              - '--headless'
              - '--disable-gpu'
              - '--disable-dev-shm-usage'
              - '--no-sandbox'
      - PunktDe\Codeception\Mailhog\Module\Mailhog:
        base_uri: http://mailhog.project

Gherkin steps

Just add the trait PunktDe\Codeception\Mailhog\ActorTraits\Mailhog to your testing actor. Then you can use *.feature files to write your gherkin tests with the new steps.

Example actor

 *  (c) 2018 punkt.de GmbH - Karlsruhe, Germany - http://punkt.de
 *  All rights reserved.

 * Inherited Methods
 * @method void wantToTest($text)
 * @method void wantTo($text)
 * @method void execute($callable)
 * @method void expectTo($prediction)
 * @method void expect($prediction)
 * @method void amGoingTo($argumentation)
 * @method void am($role)
 * @method void lookForwardTo($achieveValue)
 * @method void comment($description)
 * @method \Codeception\Lib\Friend haveFriend($name, $actorClass = NULL)
 * @SuppressWarnings(PHPMD)
class AcceptanceTester extends \Codeception\Actor
    use _generated\AcceptanceTesterActions;
    use \PunktDe\Codeception\Mailhog\ActorTraits\Mailhog; // use the mailhog steps trait
Which steps are there?

To get all the steps available you can just run the following command:

vendor/bin/codecept -c path/to/codeception.yaml gherkin:steps suiteName

This will give you a table of all the steps available.