A simple GuerrillaMail library for PHP 5.4+

1.0 2015-04-16 16:01 UTC


A Simple Library for GuerrillaMail.

Build Status


  • PHP 5.3+, however, PHP 5.5 is recommended.
  • PHP's curl extension is required if using the CurlConnection class.


This library uses composer, you can install it like so

    "require": {
        "johnsn/guerrillamail": "version"

Replace version with the desired version or branch.
You can find additional installation details on this project's packagist page

Example Usage

require_once __DIR__.'/vendor/autoload.php';

use GuerrillaMail\GuerrillaConnect\CurlConnection;
use GuerrillaMail\GuerrillaMail;

//The first parameter is the client's IP.
//The second parameter is the client's Browser Agent.
//There is an optional third parameter to set the api endpoint
//There's an optional fourth parameter to set the site domain
//There's an optional fifth parameter to set the API key (only needed if site access is set private)
$connection = new CurlConnection("", "GuerrillaMail_Library");

//The second parameter is the client's sid (optional)
$gm = new GuerrillaMail($connection);

//Obtain an email address
$response = $gm->get_email_address();

//Fetch user's latest emails.
$emails = $gm->check_email();


I haven't given this library the TLC it deserves for awhile due to having a busy schedule so here are the couple of things that I will be taking care of in the next month or two

In no particular order:

  • Decouple transport from client, currently relies on CurlClient which is not right.
  • Move to the latest guzzle http client
  • Use a middleware for authentication
  • Better documentation and examples

External links

GuerrillaMail - Guerrilla Mail API doc - Register / login for an API key. (API key is only needed for custom domains.)


This project is licensed under the MIT License.