PHPackages                             zbateson/mailbox-folder - 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. zbateson/mailbox-folder

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

zbateson/mailbox-folder
=======================

Lists and displays email messages stored on a local folder

1.1(4y ago)681[1 PRs](https://github.com/zbateson/mailbox-folder/pulls)BSD-3-ClausePHP

Since Jan 8Pushed 3y agoCompare

[ Source](https://github.com/zbateson/mailbox-folder)[ Packagist](https://packagist.org/packages/zbateson/mailbox-folder)[ RSS](/packages/zbateson-mailbox-folder/feed)WikiDiscussions master Synced 2mo ago

READMEChangelog (3)Dependencies (6)Versions (5)Used By (0)

zbateson/mailbox-folder
=======================

[](#zbatesonmailbox-folder)

Shows a mailbox of emails stored as MIME messages in a folder.

[![Screenshot 1](https://raw.githubusercontent.com/zbateson/mailbox-folder/assets/1.png)](https://raw.githubusercontent.com/zbateson/mailbox-folder/assets/1.png)

[![Screenshot 2](https://raw.githubusercontent.com/zbateson/mailbox-folder/assets/2.png)](https://raw.githubusercontent.com/zbateson/mailbox-folder/assets/2.png)

Requirements
------------

[](#requirements)

Requires PHP 5.4 or newer.

Configuration
-------------

[](#configuration)

Copy config/Prod.default.php to config/Prod.php, and edit the following values as needed.

```
// change it if mailbox-folder sits under a different path,
// for example: '/mail'
$di->values['basepath'] = '/';
// update this if you want a different name to show up in the
// title bar
$di->values['appname'] = 'mailbox-folder';
// configure the folder to read email messages from
$di->values['maildir'] = '/path/to/mailbox/folder';
```

By default, mailbox-folder creates a simple json database using `jamesmoss/flywheel`, and stores it under `sys_get_temp_dir()`, in a folder called 'mailbox-folder'. This can be changed by adding the following to config/Prod.php, along with the other configuration settings mentioned:

```
$di->values['writedir'] = '/path/to/writable/dir';
```

#### Configuring basepath

[](#configuring-basepath)

If changing the basepath, a small modification to the .htaccess file may be needed:

```

    # turn on rewriting
    RewriteEngine On

    # turn empty requests into requests for "index.php",
    # keeping the query string intact
    RewriteRule ^$ /index.php [QSA]

    # look for cached versions of files in ./web/cache/
    RewriteCond %{DOCUMENT_ROOT}/cache%{REQUEST_URI} -f
    RewriteRule ^(.*)$ cache/$1 [L]

    # for all files not found in the file system,
    # reroute to "index.php" bootstrap script,
    # keeping the query string intact.
    RewriteCond %{REQUEST_FILENAME} !-d
    RewriteCond %{REQUEST_FILENAME} !-f
    RewriteCond %{REQUEST_FILENAME} !favicon.ico$

    # Replace "BASEPATH_HERE" with your basepath as set
    # above in your config
    RewriteRule ^(.*)$ /BASEPATH_HERE/index.php [QSA,L]

```

License
-------

[](#license)

BSD licensed - please see [license agreement](https://github.com/zbateson/mail-mime-parser/blob/master/LICENSE).

###  Health Score

29

—

LowBetter than 59% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity11

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity66

Established project with proven stability

 Bus Factor1

Top contributor holds 100% 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 ~844 days

Total

3

Last Release

1726d ago

Major Versions

0.1.0 → 1.02019-03-10

### Community

Maintainers

![](https://www.gravatar.com/avatar/f2d1f00c58c63c29cc0fcf5972c9add3d468fb126f7191a6a5dfabc1f0af24e4?d=identicon)[zbateson](/maintainers/zbateson)

---

Top Contributors

[![zbateson](https://avatars.githubusercontent.com/u/8356974?v=4)](https://github.com/zbateson "zbateson (34 commits)")

---

Tags

emailfolderinboxmailbox

### Embed Badge

![Health badge](/badges/zbateson-mailbox-folder/health.svg)

```
[![Health](https://phpackages.com/badges/zbateson-mailbox-folder/health.svg)](https://phpackages.com/packages/zbateson-mailbox-folder)
```

###  Alternatives

[egulias/email-validator

A library for validating emails against several RFCs

11.6k691.3M307](/packages/egulias-email-validator)[sendgrid/sendgrid

This library allows you to quickly and easily send emails through Twilio SendGrid using PHP.

1.5k47.5M164](/packages/sendgrid-sendgrid)[pelago/emogrifier

Converts CSS styles into inline style attributes in your HTML code

94944.1M110](/packages/pelago-emogrifier)[zbateson/mail-mime-parser

MIME email message parser

53949.2M79](/packages/zbateson-mail-mime-parser)[soundasleep/html2text

A PHP script to convert HTML into a plain text format

48419.5M75](/packages/soundasleep-html2text)[verifalia/sdk

Verifalia provides a simple HTTPS-based API for validating email addresses and checking whether they are deliverable or not. This library allows to easily integrate with Verifalia and verify email addresses in real-time.

4349.8k](/packages/verifalia-sdk)

PHPackages © 2026

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