Monthly Downloads: 70,973
Programming language: PHP
License: MIT License
Tags: Email     Imap     Pop3     Mail     Composer Repositories     Mailbox     Receive Emails    
Latest version: v4.1.0

PHP IMAP alternatives and similar libraries

Based on the "Email" category.
Alternatively, view PHP IMAP alternatives based on common mentions on social networks and blogs.

Do you think we are missing an alternative of PHP IMAP or a related project?

Add another 'Email' Library



GitHub release [Software License](LICENSE) Packagist Build Status [Supported PHP Version](README.md) Maintainability Test Coverage Type Coverage

Initially released in December 2012, the PHP IMAP Mailbox is a powerful and open source library to connect to a mailbox by POP3, IMAP and NNTP using the PHP IMAP extension. This library allows you to fetch emails from your email server. Extend the functionality or create powerful web applications to handle your incoming emails.


  • Connect to mailbox by POP3/IMAP/NNTP, using PHP IMAP extension
  • Get emails with attachments and inline images
  • Get emails filtered or sorted by custom criteria
  • Mark emails as seen/unseen
  • Delete emails
  • Manage mailbox folders


PHP Version php-imap Version
5.6 3.x
7.0 3.x
7.1 3.x
7.2 3.x, 4.x
7.3 3.x, 4.x
7.4 >3.0.33, 4.x
8.0 >3.0.33, 4.x
  • PHP fileinfo extension must be present; so make sure this line is active in your php.ini: extension=php_fileinfo.dll
  • PHP iconv extension must be present; so make sure this line is active in your php.ini: extension=php_iconv.dll
  • PHP imap extension must be present; so make sure this line is active in your php.ini: extension=php_imap.dll
  • PHP mbstring extension must be present; so make sure this line is active in your php.ini: extension=php_mbstring.dll

Installation by Composer

Install the latest available release:

$ composer require php-imap/php-imap

Install the latest available and stable source code from master, which is may not released / tagged yet:

$ composer require php-imap/php-imap:dev-master

Install the latest available and may unstable source code from develop, which is may not properly tested yet:

$ composer require php-imap/php-imap:dev-develop

Run Tests

Before you can run the any tests you may need to run composer install to install all (development) dependencies.

Run all tests

You can run all available tests by running the following command (inside of the installed php-imap directory): composer run tests

Run only PHPUnit tests

You can run all PHPUnit tests by running the following command (inside of the installed php-imap directory): php vendor/bin/phpunit --testdox

Integration with frameworks

Getting Started Example

Below, you'll find an example code how you can use this library. For further information and other examples, you may take a look at the wiki.

// Create PhpImap\Mailbox instance for all further actions
$mailbox = new PhpImap\Mailbox(
    '{imap.gmail.com:993/imap/ssl}INBOX', // IMAP server and mailbox folder
    '[email protected]', // Username for the before configured mailbox
    '*********', // Password for the before configured username
    __DIR__, // Directory, where attachments will be saved (optional)
    'UTF-8' // Server encoding (optional)

// set some connection arguments (if appropriate)
    CL_EXPUNGE // expunge deleted mails upon mailbox close
    | OP_SECURE // don't do non-secure authentication

try {
    // Get all emails (messages)
    // PHP.net imap_search criteria: http://php.net/manual/en/function.imap-search.php
    $mailsIds = $mailbox->searchMailbox('ALL');
} catch(PhpImap\Exceptions\ConnectionException $ex) {
    echo "IMAP connection failed: " . $ex;

// If $mailsIds is empty, no emails could be found
if(!$mailsIds) {
    die('Mailbox is empty');

// Get the first message
// If '__DIR__' was defined in the first line, it will automatically
// save all attachments to the specified directory
$mail = $mailbox->getMail($mailsIds[0]);

// Show, if $mail has one or more attachments
echo "\nMail has attachments? ";
if($mail->hasAttachments()) {
    echo "Yes\n";
} else {
    echo "No\n";

// Print all information of $mail

// Print all attachements of $mail
echo "\n\nAttachments:\n";

Method imap() allows to call any PHP IMAP function in a context of the instance. Example:

// Call imap_check() - see http://php.net/manual/function.imap-check.php
$info = $mailbox->imap('check');

// Show current time for the mailbox
$currentServerTime = isset($info->Date) && $info->Date ? date('Y-m-d H:i:s', strtotime($info->Date)) : 'Unknown';

echo $currentServerTime;

Some request require much time and resources:

// If you don't need to grab attachments you can significantly increase performance of your application

// get the list of folders/mailboxes
$folders = $mailbox->getMailboxes('*');

// loop through mailboxs
foreach($folders as $folder) {

    // switch to particular mailbox

    // search in particular mailbox
    $mails_ids[$folder['fullpath']] = $mailbox->searchMailbox('SINCE "1 Jan 2018" BEFORE "28 Jan 2018"');


Upgrading from 3.x

Prior to 3.1, Mailbox used a "magic" method (Mailbox::imap()), with the class Imap now performing it's purpose to call many imap_* functions with automated string encoding/decoding of arguments and return values:


    public function checkMailbox()
        return $this->imap('check');


    public function checkMailbox(): object
        return Imap::check($this->getImapStream());


*Note that all licence references and agreements mentioned in the PHP IMAP README section above are relevant to that project's source code only.