PHPackages                             openjournalteam/laravel-bangau-mail - 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. openjournalteam/laravel-bangau-mail

ActiveLibrary

openjournalteam/laravel-bangau-mail
===================================

Laravel 10 mail transport for an external HTTP delivery API.

0.2.0(1mo ago)035↓75%1MITPHPPHP ^8.1

Since Jul 16Pushed 1mo agoCompare

[ Source](https://github.com/openjournalteam/laravel-bangau-mail)[ Packagist](https://packagist.org/packages/openjournalteam/laravel-bangau-mail)[ RSS](/packages/openjournalteam-laravel-bangau-mail/feed)WikiDiscussions main Synced 1w ago

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

Laravel Bangau Mail
===================

[](#laravel-bangau-mail)

Bangau is a Laravel 10 mail transport that sends Laravel mail through an external HTTP API. It uses Laravel's normal `Mail` and queued mail flow, and can fall back to a named SMTP mailer if the API cannot accept a message.

Install
-------

[](#install)

```
composer require openjournalteam/laravel-bangau-mail
php artisan vendor:publish --tag=bangau-config
```

Add the API secrets to `.env`:

```
BANGAU_ENDPOINT=https://mail-api.example.com
BANGAU_API_KEY=replace-with-a-secret
BANGAU_SENDER=no-reply@example.com
BANGAU_FALLBACK_MAILER=smtp
```

Then add a mailer in `config/mail.php` and make it the default when appropriate:

```
'default' => env('MAIL_MAILER', 'bangau'),

'mailers' => [
    'bangau' => [
        'transport' => 'bangau',
        'endpoint' => env('BANGAU_ENDPOINT'),
        'api_key' => env('BANGAU_API_KEY'),
        'sender' => env('BANGAU_SENDER'),
        'fallback_mailer' => env('BANGAU_FALLBACK_MAILER', 'smtp'),
    ],
],
```

The API receives `from`, `to`, `cc`, `bcc`, `subject`, `text`, `html`, `attachments`, and `meta`. Attachments are base64 encoded. A response is considered accepted only on HTTP `202`; Bangau uses the first `results[*].message_id` as Laravel's transport-level message ID.

Set `BANGAU_FALLBACK_ON_FAILURE=false` or `fallback_mailer` to `null` if an API failure must fail the Laravel mail job instead of using SMTP.

API contract
------------

[](#api-contract)

`POST {BANGAU_ENDPOINT}/sendmail` with headers `Accept: application/json`, `Content-Type: application/json`, and `X-API-Key`. The response must return HTTP `202`; a compatible response can include:

```
{"results":[{"email":"user@example.com","status":"queued","message_id":"provider-id"}]}
```

Use HTTPS and keep the API key in environment variables or a secret manager. Do not commit it to package configuration.

Bangau rejects non-HTTPS endpoints by default. Only for a trusted local/internal development endpoint, set `BANGAU_ALLOW_INSECURE_ENDPOINT=true` explicitly.

###  Health Score

38

—

LowBetter than 83% of packages

Maintenance92

Actively maintained with recent releases

Popularity12

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity33

Early-stage or recently created project

 Bus Factor1

Top contributor holds 66.7% 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 ~6 days

Total

2

Last Release

39d ago

### Community

Maintainers

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

---

Top Contributors

[![rahmanramsi](https://avatars.githubusercontent.com/u/48276043?v=4)](https://github.com/rahmanramsi "rahmanramsi (2 commits)")[![nescryo](https://avatars.githubusercontent.com/u/136678086?v=4)](https://github.com/nescryo "nescryo (1 commits)")

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/openjournalteam-laravel-bangau-mail/health.svg)

```
[![Health](https://phpackages.com/badges/openjournalteam-laravel-bangau-mail/health.svg)](https://phpackages.com/packages/openjournalteam-laravel-bangau-mail)
```

###  Alternatives

[laravel/framework

The Laravel Framework.

35.4k569.8M21.9k](/packages/laravel-framework)[drupal/core

Drupal is an open source content management platform powering millions of websites and applications.

21668.5M2.0k](/packages/drupal-core)[illuminate/validation

The Illuminate Validation package.

20139.4M2.1k](/packages/illuminate-validation)[illuminate/http

The Illuminate Http package.

13239.1M8.7k](/packages/illuminate-http)[drupal/core-recommended

Locked core dependencies; require this project INSTEAD OF drupal/core.

7544.4M461](/packages/drupal-core-recommended)[kimai/kimai

Kimai - Time Tracking

5.0k9.7k1](/packages/kimai-kimai)

PHPackages © 2026

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