Download the PHP package cosmira/outlook-msg without Composer

Outlook MSG for PHP

Read and write Microsoft Outlook .msg files with a clean, fluent PHP API.

It gives you a clean API for subjects, bodies, recipients, attachments, embedded messages, and raw MAPI properties, while still leaving the low-level pieces available when you need them.

Installation

Why You'll Like It

• Read Outlook .msg files into a friendly Message object
• Work with recipients and attachments through fluent collections
• Access subject, sender, headers, plain text, HTML, and RTF through expressive methods
• Create new .msg files with a clean builder API
• Attach regular files, inline files, and embedded .msg messages
• Preserve unmapped MAPI properties for round-trip scenarios
• Drop down to low-level compound file and RTF helpers when needed

Quick Start

Read a message

Create a message

Reading Messages

Message::from() and Message::parse() are equivalent. If you prefer, the original public properties are still available too.

Working With Recipients

Working With Attachments

Inline attachments

Embedded .msg attachments

Bodies: HTML, Plain Text, and RTF

If you just want the best available body, use:

If you want explicit access:

• $message->body() for plain text
• $message->bodyHtml() for HTML
• $message->bodyRtf() for decompressed RTF text

To work with raw compressed RTF payloads directly:

Creating Messages

The smoothest writing experience is the fluent builder API:

You can still use MessageBuilder::make() and MessageWriter::make() directly if you prefer the lower-level writer entry points.

Named Payload Constructors

If you want more control, you can build payload objects directly:

Embedded Message Attachments

You can attach one .msg inside another:

Raw MAPI Properties

Known message fields are mapped onto friendly methods. Everything else can still be preserved and inspected through raw properties:

This is useful when:

• you need round-trip fidelity
• you care about Outlook-specific metadata not mapped by the library
• you want to inspect or write custom MAPI values

Low-Level APIs

The package also includes lower-level APIs for advanced scenarios:

• Cosmira\OutlookMessage\CompoundFile\CompoundFile for CFBF/OLE storage access
• Cosmira\OutlookMessage\Support\BinaryBuffer for binary reads
• Cosmira\OutlookMessage\Rtf\RtfDecompressor for compressed RTF payloads

Testing