NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
Packagist
Packagist, #1916 most downloaded on Packagist
A fully-featured PHP native IMAP library
Latest stable
v1.25.9
Last release 18 days ago
04 Nov 2026
Release timing varies
gaps range from 9 days to 2 months
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
2 years old
87 releases · first in 2025
Drag across the ruler to compare, or tap a release to open it.
Fix attachment content disposition return type - https://github.com/DirectoryTree/ImapEngine/pull/197
Broaden egulias/email-validator dependency version to include 3.x by @yansongda - https://github.com/DirectoryTree/ImapEngine/pull/194
Prevent authentication over an unencrypted connection when the STARTTLS handshake fails - https://github.com/DirectoryTree/ImapEngine/pull/193
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Optimize IMAP command payloads using sequence ranges - https://github.com/DirectoryTree/ImapEngine/pull/180
Properly parse IMAP responses containing 8-bit bytes - https://github.com/DirectoryTree/ImapEngine/pull/177
Collection::first(...) vs firstWhere(...) to prevent issues with lower versions of illuminate/collections - 43c1f4eSupport for mail-mime-parser v4 - https://github.com/DirectoryTree/ImapEngine/pull/173
Tokenizer infinite loop and OOM on invalid bytes - https://github.com/DirectoryTree/ImapEngine/pull/172
Properly decode RFC 2231 MIME parameters - https://github.com/DirectoryTree/ImapEngine/pull/170
Repeated attachment content reads emptying saved files - https://github.com/DirectoryTree/ImapEngine/pull/167
Message ID query helper - https://github.com/DirectoryTree/ImapEngine/pull/163
UID infinity search range always including last message - https://github.com/DirectoryTree/ImapEngine/pull/159
Support lazy loading headers and header attributes - https://github.com/DirectoryTree/ImapEngine/pull/155
Ability to lazy load message contents (html, text, attachments, and bodyStructure) - https://github.com/DirectoryTree/ImapEngine/pull/154
Implement safe token reads when parsing message body parts - #151
Suppress stream socket warnings and throw proper ImapConnectionFailedException - https://github.com/DirectoryTree/ImapEngine/commit/04e622d94359ae2c0b
ImapConnectionFailedException - https://github.com/DirectoryTree/ImapEngine/commit/04e622d94359ae2c0ba73d73c3537e1ddcf309a7Escape ID command parameters to prevent injection - https://github.com/DirectoryTree/ImapEngine/pull/150 - Credit and thanks to @wanamirulhakim for th
Sent on/since/before query criteria support - https://github.com/DirectoryTree/ImapEngine/pull/149
Unkeyword support in query builder - https://github.com/DirectoryTree/ImapEngine/pull/148
Ability to sort queries server-side via IMAP SORT capability instead of fetch order - https://github.com/DirectoryTree/ImapEngine/pull/147
Ability to perform bulk query operations (flag, mark read/unread, delete, move, copy, etc.) - https://github.com/DirectoryTree/ImapEngine/pull/146
LARGER/SMALLER search criteria - https://github.com/DirectoryTree/ImapEngine/pull/145Make $message->isEmpty() public - https://github.com/DirectoryTree/ImapEngine/commit/daf0c7e4782f7fdc924b02e47dfa51da57bbe3f8
$message->isEmpty() public - https://github.com/DirectoryTree/ImapEngine/commit/daf0c7e4782f7fdc924b02e47dfa51da57bbe3f8Message Bodystructure Support - https://github.com/DirectoryTree/ImapEngine/pull/144
Message serialization of head and body properties on Message - https://github.com/DirectoryTree/ImapEngine/pull/143
Message - https://github.com/DirectoryTree/ImapEngine/pull/143Address from name not being decoded properly into UTF-8 - https://github.com/DirectoryTree/ImapEngine/pull/141
from name not being decoded properly into UTF-8 - https://github.com/DirectoryTree/ImapEngine/pull/141Move Atom::is() and Atom::isNot() to base Token class - https://github.com/DirectoryTree/ImapEngine/pull/137
Atom::is() and Atom::isNot() to base Token class - https://github.com/DirectoryTree/ImapEngine/pull/137$folder->poll(...) - https://github.com/DirectoryTree/ImapEngine/pull/135Properly allow fallback to secondary extension detection by @chrootchad - https://github.com/DirectoryTree/ImapEngine/commit/97bafc41e34b5e51f0ffd02d7
pathinfo(): Passing null to parameter #1 () of type when retrieving attachment extension with no file name … by @chrootchad - https://github.com/Direc
Handle null when retrieving message dates in HasParsedMessage - https://github.com/DirectoryTree/ImapEngine/pull/127
null when retrieving message dates in HasParsedMessage - https://github.com/DirectoryTree/ImapEngine/pull/127Cast $flags to array when appending new message - https://github.com/DirectoryTree/ImapEngine/pull/124
$flags to array when appending new message - https://github.com/DirectoryTree/ImapEngine/pull/124Request BODY[HEADER] first instead of BODY[TEXT] to resolve server incompatibilities - 85d751d
BODY[HEADER] first instead of BODY[TEXT] to resolve server incompatibilities - 85d751dFix issue with multi-line IMAP response parsing - https://github.com/DirectoryTree/ImapEngine/pull/121
In-Reply-To is handled as an address, but should be handled the same as Message-ID - https://github.com/DirectoryTree/ImapEngine/pull/119
In-Reply-To is handled as an address, but should be handled the same as Message-ID - https://github.com/DirectoryTree/ImapEngine/pull/119$message->size() method - https://github.com/DirectoryTree/ImapEngine/pull/120Implement PHPStan up to level 3 by @CReimer - https://github.com/DirectoryTree/ImapEngine/pull/113
Add phpstan config to .gitattributes by @williamdes - https://github.com/DirectoryTree/ImapEngine/pull/111
Only fetch message parts when set on query - https://github.com/DirectoryTree/ImapEngine/pull/110
Optimize message fetching by only sending one request - https://github.com/DirectoryTree/ImapEngine/pull/103
Prevent merging .eml file attachments in $message->attachments() - https://github.com/DirectoryTree/ImapEngine/pull/102
.eml file attachments in $message->attachments() - https://github.com/DirectoryTree/ImapEngine/pull/102Ability to fetch messages by UID sequence range - https://github.com/DirectoryTree/ImapEngine/pull/100
Ability to break out of $folder->idle() using a timeout callback - https://github.com/DirectoryTree/ImapEngine/pull/99
$folder->idle() using a timeout callback - https://github.com/DirectoryTree/ImapEngine/pull/99Number tokens in ImapTokenizer - https://github.com/DirectoryTree/ImapEngine/pull/95Ensure message UID sorting is consistent when setting fetch order - https://github.com/DirectoryTree/ImapEngine/pull/93
flag() method signature now properly typed to BackedEnum|string - https://github.com/DirectoryTree/ImapEngine/pull/91
flag() method signature now properly typed to BackedEnum|string - https://github.com/DirectoryTree/ImapEngine/pull/91Support for breaking out of $query->chunk() or $query->each() by returning false in callback - https://github.com/DirectoryTree/ImapEngine/pull/89
$query->chunk() or $query->each() by returning false in callback - https://github.com/DirectoryTree/ImapEngine/pull/89Fake mailbox queries fail when adding any query clauses - by @sertxudev - https://github.com/DirectoryTree/ImapEngine/pull/87
Properly handle possible exceptions during destruct and disconnect - https://github.com/DirectoryTree/ImapEngine/pull/85
Move flag operations and methods to FlaggableInterface inherited by MessageInterface - https://github.com/DirectoryTree/ImapEngine/pull/84
FlaggableInterface inherited by MessageInterface - https://github.com/DirectoryTree/ImapEngine/pull/84Add oldest() and newest() method aliases for MessageQuery::setFetchOrder - https://github.com/DirectoryTree/ImapEngine/pull/81
oldest() and newest() method aliases for MessageQuery::setFetchOrder - https://github.com/DirectoryTree/ImapEngine/pull/81Fix UID quoting when building search queries - https://github.com/DirectoryTree/ImapEngine/pull/79
IDE intellisense on message queries - https://github.com/DirectoryTree/ImapEngine/pull/78
Use binary content stream for attachments - https://github.com/DirectoryTree/ImapEngine/pull/75
Properly extract attachments from nested forwarded messages - https://github.com/DirectoryTree/ImapEngine/pull/73
Use ImapConnectionException as abstract base class for all ImapConnectionExceptions - https://github.com/DirectoryTree/ImapEngine/pull/72
ImapConnectionException as abstract base class for all ImapConnectionExceptions - https://github.com/DirectoryTree/ImapEngine/pull/72Convert query values to UTF-7 - https://github.com/DirectoryTree/ImapEngine/pull/70
Properly encode UTF-8 back to UTF-7 in folder queries - https://github.com/DirectoryTree/ImapEngine/pull/67
@mixin ImapQueryBuilder to MessageQueryInterface for better IDE support - #64 - 7a2c3c3
@mixin ImapQueryBuilder to MessageQueryInterface for better IDE support - #64 - 7a2c3c3Folder idling can now be tested on folders that have been given FakeMessage instances - #63
FakeMessage instances - #63is method to MessageInterface to be able to determine if a given message is the same as another - #63Appending messages now properly appends it to the FakeFolder messages instead of its own copy - 9265070
FakeFolder messages instead of its own copy - 9265070Testing Fakes to make testing easier without needing an IMAP server - https://github.com/DirectoryTree/ImapEngine/pull/62
Fix starttls transport in match statement - https://github.com/DirectoryTree/ImapEngine/pull/61
starttls transport in match statement - https://github.com/DirectoryTree/ImapEngine/pull/61Output dates as unoquoted strings in compiled IMAP queries - https://github.com/DirectoryTree/ImapEngine/pull/58
Return the new message's UID when moving or copying message - https://github.com/DirectoryTree/ImapEngine/pull/57
One column per month.