PHPackages                             comicrelief/guerrillamail - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail &amp; Notifications](/categories/mail)
4. /
5. comicrelief/guerrillamail

ActiveLibrary[Mail &amp; Notifications](/categories/mail)

comicrelief/guerrillamail
=========================

A simple GuerrillaMail library for PHP 5.4+

1.0.12(8y ago)19.5kMITPHPPHP &gt;=5.4.0

Since Aug 8Pushed 8y ago4 watchersCompare

[ Source](https://github.com/comicrelief/GuerrillaMail)[ Packagist](https://packagist.org/packages/comicrelief/guerrillamail)[ Docs](https://github.com/comicrelief/GuerrillaMail)[ RSS](/packages/comicrelief-guerrillamail/feed)WikiDiscussions master Synced 2d ago

READMEChangelog (10)Dependencies (4)Versions (19)Used By (0)

Behat email testing suite
=========================

[](#behat-email-testing-suite)

A Simple Library that utilises [GuerrillaMail](http://www.guerrillamail.com) and provides some basic behat tests, that allow you to test succesful form submissions that send emails.

[GuerrillaMail](http://www.guerrillamail.com) is a free service and is therefore perfect for email testing. This project was forked from [taion809/GuerrillaMail](https://github.com/taion809/GuerrillaMail) and has been reduced marginally to just use CURL and to add some basic modeling to the [GuerrillaMail](http://www.guerrillamail.com) API responses.

It is only recommended to use this library for testing in behat, as we will be undertaking more work to improve underlying API response modeling, however we will try to ensure compatibility with tests in tagged releases.

Installation
------------

[](#installation)

This library uses composer, you can install it using composer on the command like so,

```
composer require comicrelief/guerrillamail
```

Behat Tests
-----------

[](#behat-tests)

The follwing behat tests will check for emails delivered into the guerillamail account for 2 minues and will then fail.

### Generate a new email address

[](#generate-a-new-email-address)

The following will generate a new email inbox.

An email address is initially created when the package is instantiated, this therefore only needs to be run when running multiple tests on email fields.

```
Then I generate a new test email address

```

### Fill a field with a test email address

[](#fill-a-field-with-a-test-email-address)

The following will field a field with a test email address,

```
Then I fill in the "edit-email" field with a test email address

```

### Check inbox for email with subject &amp; body

[](#check-inbox-for-email-with-subject--body)

The following will check the inbox to see if an email exists with 'test' in the body and 'Test' in the subject.

```
Then I should receive an email with "test" in the body and "Test" in the subject

```

### Check inbox for email with subject content

[](#check-inbox-for-email-with-subject-content)

The following will check the inbox to see if there is an email with 'Test' in the email subject.

```
Then I should receive an email with "Test" in the subject

```

### Check inbox for email with body content

[](#check-inbox-for-email-with-body-content)

The following will check the inbox to see if there is an email with 'test' in the email body.

```
Then I should receive an email with "Test" in the body

```

License
-------

[](#license)

This project is licensed under the MIT License.

###  Health Score

33

—

LowBetter than 75% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community14

Small or concentrated contributor base

Maturity67

Established project with proven stability

 Bus Factor2

2 contributors hold 50%+ of commits

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~91 days

Recently: every ~25 days

Total

18

Last Release

3118d ago

Major Versions

0.6.0 → v1.0.02015-04-16

PHP version history (2 changes)0.1.0PHP &gt;=5.3.0

v1.0.0PHP &gt;=5.4.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/f06b1798977e196e99c5d0b7f408c2c3a13cf09c0df2cf93841b6e1b73124b16?d=identicon)[adamclark-dev](/maintainers/adamclark-dev)

---

Top Contributors

[![taion809](https://avatars.githubusercontent.com/u/5170979?v=4)](https://github.com/taion809 "taion809 (28 commits)")[![sq-njohns](https://avatars.githubusercontent.com/u/110409582?v=4)](https://github.com/sq-njohns "sq-njohns (19 commits)")[![adamclark-dev](https://avatars.githubusercontent.com/u/9998404?v=4)](https://github.com/adamclark-dev "adamclark-dev (18 commits)")[![flashmob](https://avatars.githubusercontent.com/u/648767?v=4)](https://github.com/flashmob "flashmob (6 commits)")[![j-r-t](https://avatars.githubusercontent.com/u/2971832?v=4)](https://github.com/j-r-t "j-r-t (1 commits)")

---

Tags

email

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/comicrelief-guerrillamail/health.svg)

```
[![Health](https://phpackages.com/badges/comicrelief-guerrillamail/health.svg)](https://phpackages.com/packages/comicrelief-guerrillamail)
```

###  Alternatives

[egulias/email-validator

A library for validating emails against several RFCs

11.6k691.3M307](/packages/egulias-email-validator)[sendgrid/sendgrid

This library allows you to quickly and easily send emails through Twilio SendGrid using PHP.

1.5k47.5M164](/packages/sendgrid-sendgrid)[pelago/emogrifier

Converts CSS styles into inline style attributes in your HTML code

94944.1M110](/packages/pelago-emogrifier)[zbateson/mail-mime-parser

MIME email message parser

53949.2M79](/packages/zbateson-mail-mime-parser)[soundasleep/html2text

A PHP script to convert HTML into a plain text format

48419.5M75](/packages/soundasleep-html2text)[opcodesio/mail-parser

Parse emails without the mailparse extension

216.8M8](/packages/opcodesio-mail-parser)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)
