michaelesmith/email-parser

Parse an email into an object representation

, _(*1)

README

What is msEmailParser?

A utility to parse incoming emails into an object representation. This uses some of the tests from https://github.com/plancake/official-library-php-email-parser and is heavily inspired by https://github.com/juji/EmailParserPHP, _(*2)

Installation

Use Composer (recommended)

The recommended way to install msDateTime is through composer., _(*3)

If you don't have Composer yet, download it following the instructions on http://getcomposer.org/ or just run the following command:, _(*4)

curl -s http://getcomposer.org/installer | php

Just create a composer.json file for your project:, _(*5)

json { "require": { "michaelesmith/email-parser": "*" } }, _(*6)

For more info on composer see https://github.com/composer/composer, _(*7)

Examples

Basic

$parser = new \MS\Email\Parser\Parser();
$message = $parser->parse($email);

// address object
$message->getFrom();

// email address
$message->getFrom()->getAddress();

// name if given
$message->getFrom()->getName();

// date sent
$message->getDate()

// date sent as DateTime object (PHP 5.3+)
$message->getDateAsDateTime()

// string
$message->getSubject();

// decoded plain text part
$message->getTextBody();

// decoded html body part
$message->getHtmlBody();

// attachments
$attachments = $message->getAttachments();
// attachment object
$attachments[0]
// methods
$attachments[0]->getFilename();
$attachments[0]->getMimeType();
// decoded attachment content
$attachments[0]->getContent();

Encodings supported

* base64
* quoted-printable
* 7bit
* 8bit

More usage can be found in the tests, _(*8)