PHPackages                             ricard0d/php-imap - 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. ricard0d/php-imap

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

ricard0d/php-imap
=================

PHP IMAP client

3.2.3(3y ago)0103MITPHPPHP &gt;=7.0.0

Since Aug 13Pushed 3y agoCompare

[ Source](https://github.com/ricard0d/php-imap)[ Packagist](https://packagist.org/packages/ricard0d/php-imap)[ Docs](https://github.com/ricard0d/php-imap)[ RSS](/packages/ricard0d-php-imap/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (1)Dependencies (4)Versions (51)Used By (0)

IMAP Library for PHP
====================

[](#imap-library-for-php)

[![Latest release on Packagist](https://camo.githubusercontent.com/142852f622bbcf734787efabdce1019dfac29ceaf8fd10de086706aec2675524/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f5765626b6c65782f7068702d696d61702e7376673f7374796c653d666c61742d737175617265266c6162656c3d76657273696f6e)](https://packagist.org/packages/Webklex/php-imap)[![Latest prerelease on Packagist](https://camo.githubusercontent.com/181ad0b7f5139e391b8a29eb732fc01bef80c4facc377ade7a51882f352dd3e9/68747470733a2f2f696d672e736869656c64732e696f2f6769746875622f762f72656c656173652f7765626b6c65782f7068702d696d61703f696e636c7564655f70726572656c6561736573267374796c653d666c61742d737175617265266c6162656c3d7072652d72656c65617365)](https://packagist.org/packages/Webklex/php-imap)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](https://github.com/Webklex/php-imap/blob/master/LICENSE)[![Build Status](https://camo.githubusercontent.com/f0047ce6fcd9df7c8d5b583a81730a18c627e214b5042d9096ff1674a040e9e4/68747470733a2f2f696d672e736869656c64732e696f2f7472617669732f5765626b6c65782f7068702d696d61702f6d61737465722e7376673f7374796c653d666c61742d737175617265)](https://scrutinizer-ci.com/g/Webklex/php-imap/code-structure)[![Total Downloads](https://camo.githubusercontent.com/095b04338c33d3732932ec5233258d879813091fe55721061687aaa33f8b28b0/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f5765626b6c65782f7068702d696d61702e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/Webklex/php-imap)[![Hits](https://camo.githubusercontent.com/3d0c66224e82cc1267b034c33b902fcddccc1d90596082538461da2fccc0eaa8/68747470733a2f2f686974732e7765626b6c65782e636f6d2f7376672f7765626b6c65782f7068702d696d6170)](https://hits.webklex.com)[![Discord](https://camo.githubusercontent.com/4ad30c86d0a652df92d405540650f42db0147223b8be76ad2f1e4f1791ae7ecd/68747470733a2f2f696d672e736869656c64732e696f2f7374617469632f76313f6c6162656c3d646973636f7264266d6573736167653d6f70656e26636f6c6f723d353836356632267374796c653d666c61742d737175617265)](https://discord.gg/jCcZWCSq)[![Snyk](https://camo.githubusercontent.com/20e6f987efc5803350feab12d0668250407f00ed5fec352c93284418ca875b4f/68747470733a2f2f736e796b2d7769646765742e6865726f6b756170702e636f6d2f62616467652f636f6d706f7365722f7765626b6c65782f7068702d696d61702f62616467652e737667)](https://snyk.io/vuln/composer:webklex%2Fphp-imap)

Description
-----------

[](#description)

PHP-IMAP is a wrapper for common IMAP communication without the need to have the php-imap module installed / enabled. The protocol is completely integrated and therefore supports IMAP IDLE operation and the "new" oAuth authentication process as well. You can enable the `php-imap` module in order to handle edge cases, improve message decoding quality and is required if you want to use legacy protocols such as pop3.

Official documentation: [php-imap.com](https://www.php-imap.com/)

Laravel wrapper: [webklex/laravel-imap](https://github.com/Webklex/laravel-imap)

Discord: [discord.gg/jCcZWCSq](https://discord.gg/jCcZWCSq)

Table of Contents
-----------------

[](#table-of-contents)

- [Documentations](#documentations)
- [Basic usage example](#basic-usage-example)
- [Known issues](#known-issues)
- [Support](#support)
- [Features &amp; pull requests](#features--pull-requests)
- [Security](#security)
- [Credits](#credits)
- [License](#license)

Documentations
--------------

[](#documentations)

- Legacy (&lt; v2.0.0): [legacy documentation](https://github.com/Webklex/php-imap/tree/1.4.5)
- Core documentation: [php-imap.com](https://www.php-imap.com/)

Basic usage example
-------------------

[](#basic-usage-example)

This is a basic example, which will echo out all Mails within all imap folders and will move every message into INBOX.read. Please be aware that this should not be tested in real life and is only meant to gives an impression on how things work.

```
use Webklex\PHPIMAP\ClientManager;

$cm = new ClientManager('path/to/config/imap.php');

/** @var \Webklex\PHPIMAP\Client $client */
$client = $cm->account('account_identifier');

//Connect to the IMAP Server
$client->connect();

//Get all Mailboxes
/** @var \Webklex\PHPIMAP\Support\FolderCollection $folders */
$folders = $client->getFolders();

//Loop through every Mailbox
/** @var \Webklex\PHPIMAP\Folder $folder */
foreach($folders as $folder){

    //Get all Messages of the current Mailbox $folder
    /** @var \Webklex\PHPIMAP\Support\MessageCollection $messages */
    $messages = $folder->messages()->all()->get();

    /** @var \Webklex\PHPIMAP\Message $message */
    foreach($messages as $message){
        echo $message->getSubject().'';
        echo 'Attachments: '.$message->getAttachments()->count().'';
        echo $message->getHTMLBody();

        //Move the current Message to 'INBOX.read'
        if($message->move('INBOX.read') == true){
            echo 'Message has been moved';
        }else{
            echo 'Message could not be moved';
        }
    }
}
```

### Known issues

[](#known-issues)

ErrorSolutionKerberos error: No credentials cache file found (try running kinit) (...)Uncomment "DISABLE\_AUTHENTICATOR" inside your config and use the `legacy-imap` protocolSupport
-------

[](#support)

If you encounter any problems or if you find a bug, please don't hesitate to create a new [issue](https://github.com/Webklex/php-imap/issues). However please be aware that it might take some time to get an answer. Off topic, rude or abusive issues will be deleted without any notice.

If you need **commercial** support, feel free to send me a mail at .

##### A little notice

[](#a-little-notice)

If you write source code in your issue, please consider to format it correctly. This makes it so much nicer to read
and people are more likely to comment and help :)

```php

echo 'your php code...';

```

will turn into:

```
echo 'your php code...';
```

Features &amp; pull requests
----------------------------

[](#features--pull-requests)

Everyone can contribute to this project. Every pull request will be considered but it can also happen to be declined.
To prevent unnecessary work, please consider to create a [feature issue](https://github.com/Webklex/php-imap/issues/new?template=feature_request.md)
first, if you're planning to do bigger changes. Of course you can also create a new [feature issue](https://github.com/Webklex/php-imap/issues/new?template=feature_request.md)if you're just wishing a feature ;)

Change log
----------

[](#change-log)

Please see [CHANGELOG](https://github.com/Webklex/php-imap/blob/master/CHANGELOG.md) for more information what has changed recently.

Security
--------

[](#security)

If you discover any security related issues, please email  instead of using the issue tracker.

Credits
-------

[](#credits)

- [Webklex](https://github.com/webklex)
- [All Contributors](https://github.com/Webklex/php-imap/graphs/contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](https://github.com/Webklex/php-imap/blob/master/LICENSE) for more information.

###  Health Score

32

—

LowBetter than 72% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity70

Established project with proven stability

 Bus Factor1

Top contributor holds 88.7% of commits — single point of failure

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 ~29 days

Recently: every ~23 days

Total

48

Last Release

1436d ago

Major Versions

0.0.3 → 1.4.22019-07-02

1.4.5 → 2.0.02020-09-20

2.7.2 → 3.0.0-alpha2021-11-04

PHP version history (2 changes)0.0.1PHP &gt;=5.5.9

3.2.1PHP &gt;=7.0.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/c058f50371ed2babfc953f106592bc7fa27b56ae9ef10d996c500ad37310b5a7?d=identicon)[ricard0d](/maintainers/ricard0d)

---

Top Contributors

[![Webklex](https://avatars.githubusercontent.com/u/2884144?v=4)](https://github.com/Webklex "Webklex (283 commits)")[![Max13](https://avatars.githubusercontent.com/u/531249?v=4)](https://github.com/Max13 "Max13 (4 commits)")[![szymekjanaczek](https://avatars.githubusercontent.com/u/74879123?v=4)](https://github.com/szymekjanaczek "szymekjanaczek (4 commits)")[![DasTobbel](https://avatars.githubusercontent.com/u/5870230?v=4)](https://github.com/DasTobbel "DasTobbel (3 commits)")[![laurent-rizer](https://avatars.githubusercontent.com/u/52099563?v=4)](https://github.com/laurent-rizer "laurent-rizer (3 commits)")[![ricard0d](https://avatars.githubusercontent.com/u/6035022?v=4)](https://github.com/ricard0d "ricard0d (3 commits)")[![HelloSebastian](https://avatars.githubusercontent.com/u/76404254?v=4)](https://github.com/HelloSebastian "HelloSebastian (2 commits)")[![dwalck](https://avatars.githubusercontent.com/u/61882865?v=4)](https://github.com/dwalck "dwalck (2 commits)")[![peanut24](https://avatars.githubusercontent.com/u/5346088?v=4)](https://github.com/peanut24 "peanut24 (2 commits)")[![Magiczne](https://avatars.githubusercontent.com/u/8850255?v=4)](https://github.com/Magiczne "Magiczne (2 commits)")[![netpok](https://avatars.githubusercontent.com/u/6945600?v=4)](https://github.com/netpok "netpok (2 commits)")[![mikemiller891](https://avatars.githubusercontent.com/u/66344776?v=4)](https://github.com/mikemiller891 "mikemiller891 (1 commits)")[![freescout-helpdesk](https://avatars.githubusercontent.com/u/40499291?v=4)](https://github.com/freescout-helpdesk "freescout-helpdesk (1 commits)")[![Korko](https://avatars.githubusercontent.com/u/43628?v=4)](https://github.com/Korko "Korko (1 commits)")[![mennovanhout](https://avatars.githubusercontent.com/u/26040589?v=4)](https://github.com/mennovanhout "mennovanhout (1 commits)")[![catabozan](https://avatars.githubusercontent.com/u/43291246?v=4)](https://github.com/catabozan "catabozan (1 commits)")[![Oliver-Holz](https://avatars.githubusercontent.com/u/49278665?v=4)](https://github.com/Oliver-Holz "Oliver-Holz (1 commits)")[![scuba323](https://avatars.githubusercontent.com/u/2747943?v=4)](https://github.com/scuba323 "scuba323 (1 commits)")[![shacky](https://avatars.githubusercontent.com/u/6030720?v=4)](https://github.com/shacky "shacky (1 commits)")[![Slauta](https://avatars.githubusercontent.com/u/1894301?v=4)](https://github.com/Slauta "Slauta (1 commits)")

---

Tags

mailphp-imapimappop3

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/ricard0d-php-imap/health.svg)

```
[![Health](https://phpackages.com/badges/ricard0d-php-imap/health.svg)](https://phpackages.com/packages/ricard0d-php-imap)
```

###  Alternatives

[webklex/php-imap

PHP IMAP client

4365.5M14](/packages/webklex-php-imap)[php-imap/php-imap

Manage mailboxes, filter/get/delete emails in PHP (supports IMAP/POP3/NNTP)

1.7k12.9M42](/packages/php-imap-php-imap)[zbateson/mail-mime-parser

MIME email message parser

53949.2M79](/packages/zbateson-mail-mime-parser)[ddeboer/imap

Object-oriented IMAP for PHP

9153.9M11](/packages/ddeboer-imap)[directorytree/imapengine

A fully-featured IMAP library -- without the PHP extension

531175.4k4](/packages/directorytree-imapengine)[tedivm/fetch

A PHP IMAP Library

5061.2M8](/packages/tedivm-fetch)

PHPackages © 2026

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