php-imap / php-imap
Manage mailboxes, filter/get/delete emails in PHP (supports IMAP/POP3/NNTP)
Installs: 10 389 277
Dependents: 53
Suggesters: 3
Security: 0
Stars: 1 665
Watchers: 69
Forks: 459
Open Issues: 75
Requires
- php: ^7.4 || ^8.0
- ext-fileinfo: *
- ext-iconv: *
- ext-imap: *
- ext-json: *
- ext-mbstring: *
Requires (Dev)
- friendsofphp/php-cs-fixer: ^3.4
- maglnet/composer-require-checker: ^2.0|^3.2
- nikic/php-parser: ^4.3,<4.7|^4.10
- paragonie/hidden-string: ^1.0
- php-parallel-lint/php-parallel-lint: ^1.3
- phpunit/phpunit: ^8.5|^9.5
- povils/phpmnd: ^2.2
- psalm/plugin-phpunit: ^0.10.0|^0.15.1
- roave/security-advisories: dev-master
- sebastian/phpcpd: ^4.1|^6.0
Suggests
- ext-fileinfo: To facilitate IncomingMailAttachment::getFileInfo() auto-detection
- dev-master
- 5.x-dev
- 5.0.1
- 5.0.0
- 4.x-dev
- 4.5.3
- 4.5.2
- 4.5.1
- 4.5.0
- 4.4.0
- 4.3.0
- 4.2.1
- 4.2.0
- 4.1.0
- 4.0.0
- 3.1.0
- 3.0.33
- 3.0.32
- 3.0.31
- 3.0.30
- 3.0.29
- 3.0.28
- 3.0.27
- 3.0.26
- 3.0.25
- 3.0.24
- 3.0.23
- 3.0.22
- 3.0.21
- 3.0.20
- 3.0.19
- 3.0.18
- 3.0.17
- 3.0.16
- 3.0.15
- 3.0.14
- 3.0.13
- 3.0.12
- 3.0.11
- 3.0.10
- 3.0.9
- 3.0.8
- 3.0.7
- 3.0.6
- 3.0.5
- 3.0.4
- 3.0.3
- 3.0.2
- 3.0.1
- 3.0.0
- 2.2.5
- 2.2.4
- 2.2.3
- 2.1.2
- 2.1.1
- 2.1.0
- 2.0.9
- 2.0.8
- 2.0.7
- 2.0.6
- 2.0.5
- 2.0.4
- 2.0.3
- 2.0.2
- 2.0.1
- 2.0
- 1.1
- 1.0
- dev-411-OAuth-Support
- dev-Improve-php-cs-fixer-config
This package is auto-updated.
Last update: 2024-11-15 03:51:46 UTC
README
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.
Features
- 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
Requirements
- 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
- PHP
json
extension must be present; so make sure this line is active in your php.ini:extension=json.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
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
- Symfony - https://github.com/secit-pl/imap-bundle
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.
By default, this library uses random filenames for attachments as identical file names from other emails would overwrite other attachments. If you want to keep the original file name, you can set the attachment filename mode to true
, but then you also need to ensure, that those files don't get overwritten by other emails for example.
// Create PhpImap\Mailbox instance for all further actions $mailbox = new PhpImap\Mailbox( '{imap.gmail.com:993/imap/ssl}INBOX', // IMAP server and mailbox folder 'some@gmail.com', // 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) true, // Trim leading/ending whitespaces of IMAP path (optional) false // Attachment filename mode (optional; false = random filename; true = original filename) ); // set some connection arguments (if appropriate) $mailbox->setConnectionArgs( 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: " . implode(",", $ex->getErrors('all')); die(); } // 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_r($mail); // Print all attachements of $mail echo "\n\nAttachments:\n"; print_r($mail->getAttachments());
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 $mailbox->setAttachmentsIgnore(true); // get the list of folders/mailboxes $folders = $mailbox->getMailboxes('*'); // loop through mailboxs foreach($folders as $folder) { // switch to particular mailbox $mailbox->switchMailbox($folder['fullpath']); // search in particular mailbox $mails_ids[$folder['fullpath']] = $mailbox->searchMailbox('SINCE "1 Jan 2018" BEFORE "28 Jan 2018"'); } print_r($mails_ids);
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:
Before:
public function checkMailbox() { return $this->imap('check'); }
After:
public function checkMailbox(): object { return Imap::check($this->getImapStream()); }
Recommended
- Google Chrome extension PHP Console
- Google Chrome extension JavaScript Errors Notifier