rsaccani/mail-mime-parser

MIME email message parser

1.0.1 2019-12-30 16:31 UTC

Requires

• php: >=5.4
• guzzlehttp/psr7: ^1.0
• zbateson/mb-wrapper: ^1.0
• zbateson/stream-decorators: ^1.0.2

Requires (Dev)

• jms/serializer: ^1.1
• mikey179/vfsstream: ^1.6.0
• phing/phing: ^2.15.0
• phpdocumentor/phpdocumentor: ^2.9.0
• phpunit/phpunit: ^4.8 || ^5.7 || ^6.5 || ^7.5

Suggests

• ext-iconv: For best support/performance
• ext-mbstring: For best support/performance

BSD-2-Clause

• Zaahid Bateson
• Contributors

• mail
• parser
• email
• mime
• mailparse
• MimeMailParser
• php-imap
• mimeparse

README

Testable and PSR-compliant mail mime parser alternative to PHP's imap* functions and Pear libraries for reading messages in Internet Message Format RFC 822 (and later revisions RFC 2822, RFC 5322).

The goals of this project are to be:

• Well written
• Standards-compliant but forgiving
• Tested where possible

To include it for use in your project, please install via composer:

composer require zbateson/mail-mime-parser

Requirements

MailMimeParser requires PHP 5.4 or newer. Tested on PHP 5.4, 5.5, 5.6, 7, 7.1, 7.2 and 7.3 on travis.

Please note: hhvm support has been dropped as it no longer supports 'php' as of version 4. Previous versions of hhvm may still work, but are no longer supported.

Usage

// use an instance of MailMimeParser as a class dependency
$mailParser = new \ZBateson\MailMimeParser\MailMimeParser();

$handle = fopen('file.mime', 'r');
// parse() accepts a string, resource or Psr7 StreamInterface
$message = $mailParser->parse($handle);         // returns a \ZBateson\MailMimeParser\Message
fclose($handle);

// OR: use this procedurally (Message::from also accepts a string,
// resource or Psr7 StreamInterface
$message = \ZBateson\MailMimeParser\Message::from($string);

echo $message->getHeaderValue('from');          // [e-mail]
echo $message
    ->getHeader('from')                         // AddressHeader
    ->getPersonName();                          // Person Name
echo $message->getHeaderValue('subject');       // The email's subject
echo $message
    ->getHeader('to')                           // also AddressHeader
    ->getAddresses()[0]                         // AddressPart
    ->getName();                                // Person Name
echo $message
    ->getHeader('cc')                           // also AddressHeader
    ->getAddress()[0]                           // AddressPart
    ->getEmail();                               // [e-mail]

echo $message->getTextContent();                // or getHtmlContent()

$att = $message->getAttachmentPart(0);          // first attachment
echo $att->getHeaderValue('Content-Type');      // e.g. "text/plain"
echo $att->getHeaderParameter(                  // value of "charset" part
    'content-type',
    'charset'
);
echo $att->getContent();                        // get the attached file's contents
$stream = $att->getContentStream();             // the file is decoded automatically
$dest = \GuzzleHttp\Psr7\stream_for(
    fopen('my-file.ext')
);
\GuzzleHttp\Psr7\copy_to_stream(
    $stream, $dest
);
// OR: more simply if saving or copying to another stream
$att->saveContent('my-file.ext');               // writes to my-file.ext
$att->saveContent($stream);                     // copies to the stream

Documentation

• About
• Usage Guide
• API Reference

Upgrading to 1.x

• Upgrade Guide

License

BSD licensed - please see license agreement.