PHPackages                             mouf/utils.mailer.db-mail-service - 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. [Database & ORM](/categories/database)
4. /
5. mouf/utils.mailer.db-mail-service

ActiveMouf-library[Database & ORM](/categories/database)

mouf/utils.mailer.db-mail-service
=================================

This package contains a mailer that does not send any mail! Instead, it stores the mail to be sent in a database 'mails' table. The DB mailer can later forward the mail to a real mailer that will indeed send the mail.

v1.0.0(10y ago)016.9k[1 issues](https://github.com/thecodingmachine/utils.mailer.db-mail-service/issues)MITPHPPHP >=5.3.0

Since Nov 12Pushed 8y ago12 watchersCompare

[ Source](https://github.com/thecodingmachine/utils.mailer.db-mail-service)[ Packagist](https://packagist.org/packages/mouf/utils.mailer.db-mail-service)[ Docs](http://mouf-php.com/packages/mouf/utils.mailer.db-mail-service/README.md)[ RSS](/packages/mouf-utilsmailerdb-mail-service/feed)WikiDiscussions 1.0 Synced 3w ago

READMEChangelog (1)Dependencies (3)Versions (2)Used By (0)

Mouf's DBMailService
====================

[](#moufs-dbmailservice)

Storing outgoing mails
----------------------

[](#storing-outgoing-mails)

In Mouf, *emails* are sent using *MailServices*.
This package contains a mailer that does not send any mail! Instead, it stores the mail to be sent in a database table. The DB mailer can also forward the mail to a real mailer that will indeed send the mail (usually a [**SmtpMailService**](http://mouf-php.com/packages/mouf/utils.mailer.smtp-mail-service/README.md))

Mails are stored in the `outgoing_mails` table while "from", "to", "cc" and "bcc" fields are stored in the `outgoing_mail_addresses` table. The stored mails can later be viewed using Mouf's user interface and can also be accessed through methods of this class.

[![Mouf's DBMailService Outgoing Mails screenshot](doc/images/screenshot_outgoing_mails.png)](doc/images/screenshot_outgoing_mails.png)

This UI is great in a development process, when you want to actually see what your application is sending without actually sending the mail, but is also very useful in production, in order to be able to verify what mails your application is sending.

Installing DBMailService
------------------------

[](#installing-dbmailservice)

There is an install process for this package. It will create a database patch. Once you have run the install process, you will need to install the patch.

The patch will create 2 tables if they are not alreay there: **outgoing\_mails** and **outgoing\_mail\_addresses**.

The install process will also create a *dbMailService* instance that will be connected to the current *dbConnection* (if it exists) and will use the *mailService* instance to actually send the mail.

Usage sample
------------

[](#usage-sample)

You use this service as you would use any MailService.

For instance, to send a mail, you just need to write:

```
$mailService = Mouf::getDBMailService();

$mail = new Mail();
$mail->setBodyText("This is my mail!");
$mail->setBodyHtml("This is my <b>mail</b>!");
$mail->setFrom(new MailAddress("my@server.com", "Server"));
$mail->addToRecipient(new MailAddress("david@email.com", "David"));
$mail->setTitle("My mail");

$mailService->send($mail);
```

Additional features
-------------------

[](#additional-features)

If you pass an instance of `DBMail` (or any class implementing `DBMailInterface`) to the `send` method of the service, you can add an additionnal category and a type to your mail. That could be used to sort sent mails later.

Here is a modified sample using `DBMail`.

```
$mailService = Mouf::getDBMailService();

$mail = new DBMail();
$mail->setBodyText("This is my mail!");
$mail->setBodyHtml("This is my <b>mail</b>!");
$mail->setFrom(new MailAddress("my@server.com", "Server"));
$mail->addToRecipient(new MailAddress("david@email.com", "David"));
$mail->setTitle("My mail");

// Let's set the category
$mail->setCategory("My category");

// Let's set the type
$mail->setType("My type");

$mailService->send($mail);
```

Accessing the sent mails database
---------------------------------

[](#accessing-the-sent-mails-database)

You can access the sent mails database directly from the Mouf administration interface. You just need to click on the **Utils** menu and click the **View outgoing mails** submenu.

[![Mouf's DBMailService Outgoing Mails screenshot](doc/images/screenshot_outgoing_mails.png)](doc/images/screenshot_outgoing_mails.png)

As you can see in the screenshot, you can view the list of sent mails. A full-text search box will search the whole outgoing mails.

Forwarding mails
----------------

[](#forwarding-mails)

The `DBMailService` is very useful because it stores the mails in database. Obviously, you can use it for debugging purposes. However, most of the time, you will want to store the mail in database AND send it. For this, the `DBMailService` can **forward** the mail to another mail service. You just need to edit the Mouf's instance of the service and set the forward service:

[![Mouf's DBMailService instance](doc/images/screenshot_forward.png)](doc/images/screenshot_forward.png)

###  Health Score

31

—

LowBetter than 66% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity22

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 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 ~0 days

Total

2

Last Release

3877d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/1104771?v=4)[mouf](/maintainers/mouf)[@Mouf](https://github.com/Mouf)

---

Top Contributors

[![moufmouf](https://avatars.githubusercontent.com/u/1290952?v=4)](https://github.com/moufmouf "moufmouf (11 commits)")

---

Tags

databasemailservicemailermouf

### Embed Badge

![Health badge](/badges/mouf-utilsmailerdb-mail-service/health.svg)

```
[![Health](https://phpackages.com/badges/mouf-utilsmailerdb-mail-service/health.svg)](https://phpackages.com/packages/mouf-utilsmailerdb-mail-service)
```

###  Alternatives

[mouf/magic-query

A very clever library to help you with SQL: generate prepared statements with a variable number of parameters, automatically writes joins... and much more!

20264.5k3](/packages/mouf-magic-query)

PHPackages © 2026

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