Skip to content


Switch branches/tags

Name already in use

A tag already exists with the provided branch name. Many Git commands accept both tag and branch names, so creating this branch may cause unexpected behavior. Are you sure you want to create this branch?

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time
August 23, 2023 22:20
August 23, 2023 15:29
January 17, 2023 19:08
August 12, 2016 14:44
November 23, 2017 15:20
June 23, 2016 11:45
August 23, 2023 22:20
March 15, 2019 06:44
November 6, 2022 17:06


A fully tested email parser for PHP 8.0+ (mailparse extension wrapper).

It's the most effective PHP email parser around in terms of performance, foreign character encoding, attachment handling, and ease of use. Internet Message Format RFC 822, 2822, 5322.

Latest Version Total Downloads Software License


This extension can be used to...

  • Parse and read email from Postfix
  • Read messages (Filename extension: .eml)
  • Create webmail
  • Store email information such a subject, HTML body, attachments, etc. into a database

Is it reliable?

Yes. All known issues have been reproduced, fixed and tested.

We use GitHub Actions, Codecov, Codacy to help ensure code quality. You can see real-time statistics below:

CI Coverage Code Quality

How do I install it?

The easiest way is via Composer.

To install the latest version of PHP MIME Mail Parser, run the command below:

composer require php-mime-mail-parser/php-mime-mail-parser


The following versions of PHP are supported:

  • PHP 8.0
  • PHP 8.1
  • PHP 8.2
  • PHP 8.3

Previous Versions:

PHP Compatibility Version
HHVM php-mime-mail-parser 2.11.1
PHP 5.4 php-mime-mail-parser 2.11.1
PHP 5.5 php-mime-mail-parser 2.11.1
PHP 5.6 php-mime-mail-parser 3.0.4
PHP 7.0 php-mime-mail-parser 3.0.4
PHP 7.1 php-mime-mail-parser 5.0.5
PHP 7.2 php-mime-mail-parser 7.1.2
PHP 7.3 php-mime-mail-parser 7.1.2
PHP 7.4 php-mime-mail-parser 7.1.2

Make sure you have the mailparse extension ( properly installed. The command line php -m | grep mailparse needs to return "mailparse".

Install mailparse extension

Debian, Ubuntu & derivatives

sudo apt install php-cli php-mailparse

Other platforms

sudo apt install php-cli php-pear php-dev php-mbstring
pecl install mailparse

From source

AAAAMMDD should be php-config --extension-dir

git clone
cd pecl-mail-mailparse
sed -i 's/#if\s!HAVE_MBSTRING/#ifndef MBFL_MBFILTER_H/' ./mailparse.c
sudo mv modules/ /usr/lib/php/AAAAMMDD/
echo "" | sudo tee /etc/php/7.1/mods-available/mailparse.ini
sudo phpenmod mailparse


You need to download mailparse DLL from and add the line extension=php_mailparse.dll to php.ini accordingly.

How do I use it?

Loading an email

You can load an email in 4 differents ways:

require_once __DIR__.'/vendor/autoload.php';

$path = 'path/to/email.eml';
$parser = new PhpMimeMailParser\Parser();

// 1. Either specify a file path (string)

// 2. or specify the raw mime mail text (string)

// 3. or specify a php file resource (stream)
$parser->setStream(fopen($path, "r"));

// 4. or specify a stream to work with a mail server (stream)
$parser->setStream(fopen("php://stdin", "r"));

Get the metadata of the message

Get the sender and the receiver:

$rawHeaderTo = $parser->getHeader('to');
// return "test" <>, "test2" <>

$arrayHeaderTo = $parser->getAddresses('to');
// return [["display"=>"test", "address"=>"", false]]

$rawHeaderFrom = $parser->getHeader('from');
// return "test" <>

$arrayHeaderFrom = $parser->getAddresses('from');
// return [["display"=>"test", "address"=>"", "is_group"=>false]]

Get the subject:

$subject = $parser->getHeader('subject');

Get other headers:

$stringHeaders = $parser->getHeadersRaw();
// return all headers as a string, no charset conversion

$arrayHeaders = $parser->getHeaders();
// return all headers as an array, with charset conversion

Get the body of the message

$text = $parser->getMessageBody('text');
// return the text version

$html = $parser->getMessageBody('html');
// return the html version

$htmlEmbedded = $parser->getMessageBody('htmlEmbedded');
// return the html version with the embedded contents like images

Get attachments

Save all attachments in a directory

// return all attachments saved in the directory (include inline attachments)

$parser->saveAttachments('/path/to/save/attachments/', false);
// return all attachments saved in the directory (exclude inline attachments)

// Save all attachments with the strategy ATTACHMENT_DUPLICATE_SUFFIX (default)
$parser->saveAttachments('/path/to/save/attachments/', false, Parser::ATTACHMENT_DUPLICATE_SUFFIX);
// return all attachments saved in the directory: logo.jpg, logo_1.jpg, ..., logo_100.jpg, YY34UFHBJ.jpg

// Save all attachments with the strategy ATTACHMENT_RANDOM_FILENAME
$parser->saveAttachments('/path/to/save/attachments/', false, Parser::ATTACHMENT_RANDOM_FILENAME);
// return all attachments saved in the directory: YY34UFHBJ.jpg and F98DBZ9FZF.jpg

// Save all attachments with the strategy ATTACHMENT_DUPLICATE_THROW
$parser->saveAttachments('/path/to/save/attachments/', false, Parser::ATTACHMENT_DUPLICATE_THROW);
// return an exception when there is attachments duplicate.

Get all attachments

$attachments = $parser->getAttachments();
// return an array of all attachments (include inline attachments)

$attachments = $parser->getAttachments(false);
// return an array of all attachments (exclude inline attachments)

Loop through all attachments

foreach ($attachments as $attachment) {
    echo 'Filename : '.$attachment->getFilename().'<br>';
    // return logo.jpg
    echo 'Filesize : '.filesize($attach_dir.$attachment->getFilename()).'<br>';
    // return 1000
    echo 'Filetype : '.$attachment->getContentType().'<br>';
    // return image/jpeg
    echo 'MIME part string : '.$attachment->getMimePartStr().'<br>';
    // return the whole MIME part of the attachment
    $stream = $attachment->getStream();
    // get the stream of the attachment file

    $attachment->save('/path/to/save/myattachment/', Parser::ATTACHMENT_DUPLICATE_SUFFIX);
    // return the path and the filename saved (same strategy available than saveAttachments)

Postfix configuration to manage email from a mail server

To forward mails from Postfix to the PHP script above, add this line at the end of your /etc/postfix/ (to specify myhook to send all emails to the script test.php):

myhook unix - n n - - pipe
  				flags=F user=www-data argv=php -c /etc/php5/apache2/php.ini -f /var/www/test.php ${sender} ${size} ${recipient}

Edit this line (register myhook)

smtp      inet  n       -       -       -       -       smtpd
        			-o content_filter=myhook:dummy

The PHP script must use the fourth method (see above) to work with this configuration.

And finally the easiest way is to use my SaaS

Can I contribute?

Feel free to contribute!

git clone
cd php-mime-mail-parser
composer install

If you report an issue, please provide the raw email that triggered it. This helps us reproduce the issue and fix it more quickly.


The php-mime-mail-parser/php-mime-mail-parser is open-sourced software licensed under the MIT license