Pb\Imap is a library for downloading and parsing IMAP email messages. For performance reasons, the PHP IMAP extension is specifically not used, in favor of the Laminas Mail library.
Separate forks of the Laminas Mail and Laminas Mime libraries are used and kept as up to date as possible. These forks are needed to make minor but necessary updates that wouldn't be approved in time or at all by the Laminas maintainers.
Memory performance is the goal of this library and it's been stabilized and reduced as much as possible. Depending on file attachment downloads, this application uses on average 10-20 MB of memory, with a peak of up to 75-100 MB during large attachment downloads.
- Connect to mailbox via IMAP
- Get a listing of all folders
- Download email messages and save attachments to disk
- Search emails by custom criteria
- Get status information on each folder
{
"require": {
"particlebits/imap": "^2.1"
}
}
or
$> composer require particlebits/imap ^2.1
$mailbox = new \Pb\Imap\Mailbox(
'imap.gmail.com',
'[email protected]',
'**********',
'INBOX',
__DIR__ .'/attachments',
[
\Pb\Imap\Mailbox::OPT_DEBUG_MODE => true
]);
$messageIds = $mailbox->searchMailBox('ALL');
foreach ($messageIds as $messageId) {
$message = $mailbox->getMessage($messageId);
print_r($message);
print_r($message->getAttachments());
}You can use the following options in the final argument of the Mailbox constructor:
OPT_DEBUG_MODEThis will write memory info to the screenOPT_SKIP_ATTACHMENTSSkips downloading message attachments. Useful for saving disk space.
This project originally used the PHP IMAP extension for fetching and parsing email messages. The extension is not very memory efficient for long-running processes, which is my intended use. Instead, this library uses the Laminas Mail package. Laminas Mail retrieves messages through a socket connection and parses the headers. \Pb\Imap takes this raw message object and converts into something more user-friendly.
For more examples see the scripts inside the tests/ folder.