PHP MIME Mail Parser

Overview

PHP MIME Mail Parser is a PHP library for turning MIME email into headers, message bodies, and attachments. It is best suited to developers building mail workflows in PHP; its main trade-off is the need to manage PHP and the mailparse extension in your own environment.

For projects that need to process messages rather than buy a hosted inbox-to-data service, it offers useful input flexibility and attachment controls at no license cost. It is less suitable if you need OCR, webhook delivery, or a hosted API.

Key features

Messages can be loaded from a file path, raw MIME text, a PHP file resource, or a stream such as stdin. That makes the library adaptable to saved-message processing as well as stream-based intake. The documented Postfix setup can forward mail to a PHP script, which is a practical fit for server-side workflows; the project also identifies reading .eml files, building webmail, and storing email information in a database as use cases.

For message inspection, it can return headers as raw text or as an array with character-set conversion, and extract addresses and subject. It retrieves text and HTML bodies, including HTML with embedded content such as images. Attachment support covers listing and saving files, including or excluding inline attachments, and selecting how duplicate filenames are handled. These controls help when applications need to distinguish ordinary files from embedded content or avoid collisions during extraction.

The parser handles Internet Message Format RFC 822, RFC 2822, and RFC 5322. Composer installation uses php-mime-mail-parser/php-mime-mail-parser. The project says it uses GitHub Actions, Codecov, and Codacy for quality assurance, and that known issues are reproduced, fixed, and tested. For issue reports, maintainers ask for the raw email that caused the problem, so users should be prepared to share a representative message when seeking help.

Pricing

The MIT-licensed open-source library costs free, with billing not applicable. There is no paid tier or free trial. That makes it a straightforward choice for developers who can integrate and operate the parser themselves; there are no paid-plan quotas or seat limits to weigh. The cost advantage does not remove the engineering work of configuring the runtime and building any surrounding delivery or extraction workflow.

The library provides attachment parsing, but not OCR extraction, webhook delivery, API access, or custom extraction fields. Choose it for programmatic MIME parsing inside a PHP application, not as a turnkey service that accepts email and sends structured results elsewhere.

Platforms

It is available for Linux, macOS, Windows, and self-hosted environments. The current package requires PHP 8.2 or later and the mailparse extension; supported PHP versions are 8.2, 8.3, 8.4, and 8.5. Installation guidance covers Debian and Ubuntu, macOS, Windows, and other platforms. Those requirements are manageable for a maintained PHP stack, but may rule it out where upgrading PHP or enabling mailparse is not practical.

Who it's for

PHP developers who need to parse incoming or archived MIME messages, inspect headers and bodies, and save attachments will get the most from this library. It suits teams able to own deployment and connect parsing to their own storage or application logic. Readers who want hosted integrations, webhook delivery, or OCR should consider a service built around those needs instead.

Pros and cons

Pros

• Flexible message input: file paths, raw MIME, PHP resources, and streams can support different ingestion patterns.
• Useful attachment controls: inline inclusion and duplicate-filename handling can be configured alongside listing and saving.
• No license charge: the MIT-licensed library is free to use, without a trial period or paid tier.
• Documented platform setup: guidance for common operating systems and Postfix can help developers fit it into an existing PHP mail workflow.

Cons

• Runtime prerequisites: PHP 8.2 or later and mailparse are required, adding setup work and limiting use on older PHP deployments.
• No hosted delivery layer: it does not provide webhook delivery or API access, so applications must supply their own integration path.
• No OCR or custom extraction fields: it parses MIME content but is not a document-recognition or configurable data-extraction service.

Alternatives

Email Parsing Software is the broader category directory for comparing other options.

• CloudMailin is a hosted API and web option with a free plan of 10,000 emails per month and a 512KB per-message limit; choose it if managed email intake matters more than parsing within your PHP code.
• MailFrame offers API and web access, with a free tier of 100 parse operations per month, one active schema, and webhook delivery; it may suit a workflow centered on schema-based parsing and webhooks.
• noima is an API and web alternative with a free allowance of 10 documents once and 30 days of retention; consider it when document processing and retention terms are a better fit than a self-hosted PHP library.
• Parserr provides API and web access, with a free plan covering 15 emails per month, 10 documents per month, and one inbox; choose it if inbox-based parsing rules and integrations are the priority.
• Parsio Receipt OCR has API and web access and a free allowance of 30 credits per month, 30-day retention, and one user; it is the alternative to consider for receipt OCR rather than general PHP MIME parsing.
• Parsli offers API and web access, with 10 free pages on signup, unlimited parsers, and API access plus integrations; consider it if those parser and integration provisions suit your workflow.
• DigiParser is an API and web alternative with a free plan described as covering 100 documents; it may fit readers looking for document parsing rather than a library embedded in PHP.
• MailParse offers API and web access; its free plan includes 100 emails per month, webhook delivery, REST polling, and one inbound address, making it worth considering for hosted inbound-email processing.

Verdict

Choose PHP MIME Mail Parser if you are building a PHP application that needs direct access to MIME headers, bodies, and attachments without a software license fee. Its strongest case is the combination of flexible inputs and attachment handling in a library you can run in your own stack. Look elsewhere if you need hosted intake, webhook or API delivery, OCR, or cannot meet the PHP 8.2+ and mailparse requirements.