PHPackages                             opcodesio/mail-parser - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Mail & Notifications](/categories/mail)
4. /
5. opcodesio/mail-parser

ActiveLibrary[Mail & Notifications](/categories/mail)

opcodesio/mail-parser
=====================

Parse emails without the mailparse extension

v0.2.4(1mo ago)228.8M↓21.5%3[1 issues](https://github.com/opcodesio/mail-parser/issues)7MITPHPPHP ^8.0

Since Aug 25Pushed 1mo ago3 watchersCompare

[ Source](https://github.com/opcodesio/mail-parser)[ Packagist](https://packagist.org/packages/opcodesio/mail-parser)[ RSS](/packages/opcodesio-mail-parser/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (10)Dependencies (6)Versions (19)Used By (7)

Mail Parser for PHP
Simple, fast, no extensions required
========================================================

[](#mail-parser-for-phpsimple-fast-no-extensions-required)

 [Features](#features) | [Installation](#installation) | [Credits](#credits)

[![Packagist](https://camo.githubusercontent.com/3868ca9784c4c9a5ff6d842504f0e6097d6f5a633265424c2049655da9002081/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6f70636f646573696f2f6d61696c2d7061727365722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/opcodesio/mail-parser)[![Packagist](https://camo.githubusercontent.com/a632fdd5a82206f1e377f52b38a1d09a36c20b3ec2c043086b96f014eb2798b2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f646d2f6f70636f646573696f2f6d61696c2d7061727365722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/opcodesio/mail-parser)[![PHP from Packagist](https://camo.githubusercontent.com/4c282e0e37dd532a21ee796fe6bf6ee089f4fc47eb9dce4c383f35f204ed3e71/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6f70636f646573696f2f6d61696c2d7061727365722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/opcodesio/mail-parser)

Features
--------

[](#features)

[OPcodes's](https://www.opcodes.io/) **Mail Parser** has a very simple API to parse emails and their MIME contents. Unlike many other parsers out there, this package does not require the [mailparse](https://www.php.net/manual/en/book.mailparse.php) PHP extension.

Has not been fully tested against RFC 5322.

Get Started
-----------

[](#get-started)

### Requirements

[](#requirements)

- **PHP 8.0+**

### Installation

[](#installation)

To install the package via composer, Run:

```
composer require opcodesio/mail-parser
```

### Usage

[](#usage)

```
use Opcodes\MailParser\Message;

// Parse a message from a string
$message = Message::fromString('...');
// Or from a file location (accessible with file_get_contents())
$message = Message::fromFile('/path/to/email.eml');

$message->getHeaders();                 // get all headers
$message->getHeader('Content-Type');    // 'multipart/mixed; boundary="----=_Part_1_1234567890"'
$message->getFrom();                    // 'Arunas
$message->getTo();                      // 'John Doe
$message->getSubject();                 // 'Subject line'
$message->getDate();                    // `Date:` header as DateTime object
$message->getSize();                    // Email size in bytes

$message->getParts();       // array of \Opcodes\MailParser\MessagePart, which can be html parts, text parts, attachments, etc.
$message->getHtmlPart();    // \Opcodes\MailParser\MessagePart containing the HTML body
$message->getTextPart();    // \Opcodes\MailParser\MessagePart containing the Text body
$message->getAttachments(); // array of \Opcodes\MailParser\MessagePart that represent attachments

$messagePart = $message->getParts()[0];

$messagePart->getHeaders();                 // array of all headers for this message part
$messagePart->getHeader('Content-Type');    // value of a particular header
$messagePart->getContentType();             // 'text/html; charset="utf-8"'
$messagePart->getContent();                 // '....'
$messagePart->getSize();                    // 312
$messagePart->getFilename();                // name of the file, in case this is an attachment part
```

Contributing
------------

[](#contributing)

A guide for contributing is in progress...

Security Vulnerabilities
------------------------

[](#security-vulnerabilities)

Please review [our security policy](../../security/policy) on how to report security vulnerabilities.

Credits
-------

[](#credits)

- [Arunas Skirius](https://github.com/arukompas)
- [All Contributors](../../contributors)

License
-------

[](#license)

The MIT License (MIT). Please see [License File](LICENSE.md) for more information.

###  Health Score

57

—

FairBetter than 98% of packages

Maintenance90

Actively maintained with recent releases

Popularity56

Moderate usage in the ecosystem

Community22

Small or concentrated contributor base

Maturity47

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 80% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~64 days

Recently: every ~131 days

Total

17

Last Release

43d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/952e4089f2eed5313b942cd03434f2d8ab019f7a41417704c72fc78efe46e0a2?d=identicon)[arukomp](/maintainers/arukomp)

---

Top Contributors

[![arukompas](https://avatars.githubusercontent.com/u/8697942?v=4)](https://github.com/arukompas "arukompas (20 commits)")[![jacekkow](https://avatars.githubusercontent.com/u/4353795?v=4)](https://github.com/jacekkow "jacekkow (3 commits)")[![ThomasLandauer](https://avatars.githubusercontent.com/u/1054469?v=4)](https://github.com/ThomasLandauer "ThomasLandauer (2 commits)")

---

Tags

phpmailemailarukompasopcodesioemail parser

###  Code Quality

TestsPest

### Embed Badge

![Health badge](/badges/opcodesio-mail-parser/health.svg)

```
[![Health](https://phpackages.com/badges/opcodesio-mail-parser/health.svg)](https://phpackages.com/packages/opcodesio-mail-parser)
```

###  Alternatives

[railsware/mailtrap-php

The Mailtrap SDK provides methods for all API functions.

60929.1k](/packages/railsware-mailtrap-php)[henrique-borba/php-sieve-manager

A modern (started in 2022) PHP library for the ManageSieve protocol (RFC5804) to create/edit Sieve scripts (RFC5228). Used by Cypht Webmail.

28142.6k4](/packages/henrique-borba-php-sieve-manager)[benhall14/php-imap-reader

A PHP class that makes working with IMAP in PHP simple.

3519.6k](/packages/benhall14-php-imap-reader)[juanparati/brevosuite

Complete Brevo integration with Laravel

1014.8k](/packages/juanparati-brevosuite)[beebmx/kirby-courier

Courier offers a convenient and painless solution for creating emails tailored for your Kirby website.

403.8k3](/packages/beebmx-kirby-courier)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)