PHPackages                             leroy-merlin-br/metamorphosis - 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. [HTTP &amp; Networking](/categories/http)
4. /
5. leroy-merlin-br/metamorphosis

ActiveLibrary[HTTP &amp; Networking](/categories/http)

leroy-merlin-br/metamorphosis
=============================

Kafka package for laravel applications

v5.1.0(3mo ago)4228.8k↓41.7%11[3 PRs](https://github.com/leroy-merlin-br/metamorphosis/pulls)MITPHPPHP ^8.0CI passing

Since Aug 29Pushed 3mo ago37 watchersCompare

[ Source](https://github.com/leroy-merlin-br/metamorphosis)[ Packagist](https://packagist.org/packages/leroy-merlin-br/metamorphosis)[ RSS](/packages/leroy-merlin-br-metamorphosis/feed)WikiDiscussions master Synced 1mo ago

READMEChangelog (10)Dependencies (15)Versions (54)Used By (0)

Metamorphosis
=============

[](#metamorphosis)

> Easy and flexible Kafka Library for Laravel and PHP 7.

[![Metamorphosis](./docs/logo.png)](./docs/logo.png)

[![Latest Version on Packagist](https://camo.githubusercontent.com/67167df9948f56b4f99dd47cb57ae96fd2ea84aab7dd313308758dae7347d510/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f6c65726f792d6d65726c696e2d62722f6d6574616d6f7270686f7369732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/leroy-merlin-br/metamorphosis)[![Software License](https://camo.githubusercontent.com/55c0218c8f8009f06ad4ddae837ddd05301481fcf0dff8e0ed9dadda8780713e/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f6c6963656e73652d4d49542d627269676874677265656e2e7376673f7374796c653d666c61742d737175617265)](#license)[![Total Downloads](https://camo.githubusercontent.com/3f460c1925a7390c85d56688af5ebf1633861a0d276b83f7c76c1f58f2435d3a/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f6c65726f792d6d65726c696e2d62722f6d6574616d6f7270686f7369732e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/leroy-merlin-br/metamorphosis)[![Build Status](https://github.com/leroy-merlin-br/metamorphosis/workflows/Tests/badge.svg)](https://github.com/leroy-merlin-br/metamorphosis/actions?query=workflow%3ATests)[![Coverage Status](https://camo.githubusercontent.com/da64dfd405c29e141a2e5436f798a3e06393b1f7ac4f060100243d4842383448/68747470733a2f2f6170702e636f646163792e636f6d2f70726f6a6563742f62616467652f436f7665726167652f3638623038366665373532393464336538633231613732616464636362316263)](https://www.codacy.com/gh/leroy-merlin-br/metamorphosis/dashboard?utm_source=github.com&utm_medium=referral&utm_content=leroy-merlin-br/metamorphosis&utm_campaign=Badge_Coverage)

- [Introduction](#introduction)
- [Requirements](#requirements)
- [Installation](#installation)
- [Quick Usage Guide](docs/quick-usage.md)
- [Advanced Usage Guide](docs/advanced.md)
- [Upgrade Guide](docs/upgrade.md)
- [Contributing](docs/CONTRIBUTING.md)
- [License](#license)

Introduction
------------

[](#introduction)

Metamorphosis provides a simple, straight-forward implementation for working with Kafka inside Laravel applications.

Prefer to read in other language?

- [Português](readme.pt.md)

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

[](#requirements)

- PHP &gt;= 7.1
- [Kafka Driver](https://github.com/edenhill/librdkafka)
- [Kafka PHP Extension](https://github.com/arnaud-lb/php-rdkafka)

Installation
------------

[](#installation)

### 1. Install the Kafka driver

[](#1-install-the-kafka-driver)

On Mac OSX, install librdkafka with homebrew:

```
brew install librdkafka
```

On Debian and Ubuntu, install librdkafka from the Confluent APT repositories, see instructions [here](https://docs.confluent.io/current/installation/installing_cp/deb-ubuntu.html#get-the-software) and then install librdkafka:

```
apt install librdkafka-dev
```

On RedHat, CentOS, Fedora, install librdkafka from the Confluent YUM repositories, instructions [here](https://docs.confluent.io/current/installation/installing_cp/rhel-centos.html#get-the-software) and then install librdkafka:

```
yum install librdkafka-devel
```

On Windows, reference [librdkafka.redist](https://www.nuget.org/packages/librdkafka.redist/) NuGet package in your Visual Studio project.

### 2. Install the PHP Kafka extension

[](#2-install-the-php-kafka-extension)

On Linux, Unix and OS X, you can install extensions using the PHP Extension Community Library ([PECL](https://www.php.net/manual/en/install.pecl.intro.php)):

```
pecl install rdkafka
```

then add the following to your .ini file:

```
extension=rdkafka.so

```

> **Important:** When using multiple PHP versions, PECL will install the package for the latest PHP version only. To set a PHP version, download the source code and compile it specifying the target PHP version.

PHP 7.4 example:

```
pecl download rdkafka
tar -xvf rdkafka-X.x.x.tgz
cd rdkafka-X.x.x
phpize
./configure --with-php-config=/usr/bin/php-config7.4
make
sudo make install
```

then add the extension to your .ini file:

```
extension=rdkafka.so

```

More about [compiling shared PECL extensions](https://www.php.net/manual/en/install.pecl.phpize.php)

On Windows, download the [rdkafka DLL](https://pecl.php.net/package/rdkafka/), put the file in your PHP/ext folder and add the extension to your php.ini file:

```
extension=rdkafka.dll

```

More about [PECL on Windows](https://www.php.net/manual/en/install.pecl.windows.php)

### 3. Install Metamorphosis

[](#3-install-metamorphosis)

Install the library via Composer:

```
composer require leroy-merlin-br/metamorphosis
```

And publish the config file with:

```
php artisan vendor:publish --provider="Metamorphosis\MetamorphosisServiceProvider"
```

For usage instructions, please refer to our [Quick Usage Guide](docs/quick-usage.md).

License
-------

[](#license)

Metamorphosis is free software distributed under the terms of the [MIT license](http://opensource.org/licenses/MIT)

Additional information
----------------------

[](#additional-information)

Metamorphosis was proudly built by the [Leroy Merlin Brazil](https://github.com/leroy-merlin-br) team. [See all the contributors](https://github.com/leroy-merlin-br/metamorphosis/graphs/contributors).

###  Health Score

60

—

FairBetter than 99% of packages

Maintenance78

Regular maintenance activity

Popularity40

Moderate usage in the ecosystem

Community30

Small or concentrated contributor base

Maturity81

Battle-tested with a long release history

 Bus Factor3

3 contributors hold 50%+ of commits

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

Recently: every ~282 days

Total

41

Last Release

115d ago

Major Versions

v0.2.2 → v1.0.02018-10-22

v1.2.0 → v2.0.02019-12-12

v2.2.0 → v3.0.02020-01-13

v3.3.0 → v4.0.02021-11-19

v4.4.0 → v5.0.02024-07-23

PHP version history (3 changes)v0.1.0PHP &gt;=7.1

v4.2.0PHP &gt;=7.4

v4.3.0PHP ^8.0

### Community

Maintainers

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

![](https://www.gravatar.com/avatar/f848446124bcd080151222405e6b1146f1c580fbbd70a9ec29fa2574a9da7cab?d=identicon)[svc-lmbr-boitata](/maintainers/svc-lmbr-boitata)

![](https://avatars.githubusercontent.com/u/1079090?v=4)[David Jonas Marques França](/maintainers/djonasm)[@djonasm](https://github.com/djonasm)

---

Top Contributors

[![djonasm](https://avatars.githubusercontent.com/u/1079090?v=4)](https://github.com/djonasm "djonasm (224 commits)")[![brnbp](https://avatars.githubusercontent.com/u/8925112?v=4)](https://github.com/brnbp "brnbp (168 commits)")[![hcdias](https://avatars.githubusercontent.com/u/4405802?v=4)](https://github.com/hcdias "hcdias (151 commits)")[![diegofelix](https://avatars.githubusercontent.com/u/238054?v=4)](https://github.com/diegofelix "diegofelix (96 commits)")[![vitorbari](https://avatars.githubusercontent.com/u/1184252?v=4)](https://github.com/vitorbari "vitorbari (59 commits)")[![fnsc](https://avatars.githubusercontent.com/u/23709089?v=4)](https://github.com/fnsc "fnsc (27 commits)")[![orlandocavassani](https://avatars.githubusercontent.com/u/17056201?v=4)](https://github.com/orlandocavassani "orlandocavassani (25 commits)")[![GetulioMR](https://avatars.githubusercontent.com/u/10175963?v=4)](https://github.com/GetulioMR "GetulioMR (12 commits)")[![gemidio](https://avatars.githubusercontent.com/u/7032180?v=4)](https://github.com/gemidio "gemidio (11 commits)")[![rpopuc](https://avatars.githubusercontent.com/u/17992630?v=4)](https://github.com/rpopuc "rpopuc (6 commits)")[![williancs](https://avatars.githubusercontent.com/u/5855678?v=4)](https://github.com/williancs "williancs (5 commits)")[![JoaoFerrazfs](https://avatars.githubusercontent.com/u/50000291?v=4)](https://github.com/JoaoFerrazfs "JoaoFerrazfs (4 commits)")[![jhonatanveras](https://avatars.githubusercontent.com/u/83521609?v=4)](https://github.com/jhonatanveras "jhonatanveras (3 commits)")[![ravanscafi](https://avatars.githubusercontent.com/u/6104262?v=4)](https://github.com/ravanscafi "ravanscafi (3 commits)")[![hfisaquiel](https://avatars.githubusercontent.com/u/225463518?v=4)](https://github.com/hfisaquiel "hfisaquiel (2 commits)")[![carusogabriel](https://avatars.githubusercontent.com/u/16328050?v=4)](https://github.com/carusogabriel "carusogabriel (2 commits)")[![GetulioMeirelles](https://avatars.githubusercontent.com/u/75232974?v=4)](https://github.com/GetulioMeirelles "GetulioMeirelles (2 commits)")[![mithunra](https://avatars.githubusercontent.com/u/18493171?v=4)](https://github.com/mithunra "mithunra (2 commits)")[![flaviozantut](https://avatars.githubusercontent.com/u/460185?v=4)](https://github.com/flaviozantut "flaviozantut (1 commits)")

---

Tags

hacktoberfestkafkalaravelphpphp-librarypubsubkafka

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm, Rector

Type Coverage Yes

### Embed Badge

![Health badge](/badges/leroy-merlin-br-metamorphosis/health.svg)

```
[![Health](https://phpackages.com/badges/leroy-merlin-br-metamorphosis/health.svg)](https://phpackages.com/packages/leroy-merlin-br-metamorphosis)
```

###  Alternatives

[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9682.1M97](/packages/roots-acorn)[laravel-zero/framework

The Laravel Zero Framework.

3371.4M369](/packages/laravel-zero-framework)[illuminate/http

The Illuminate Http package.

11936.0M5.1k](/packages/illuminate-http)[omniphx/forrest

A Laravel library for Salesforce

2724.4M8](/packages/omniphx-forrest)[aedart/athenaeum

Athenaeum is a mono repository; a collection of various PHP packages

245.2k](/packages/aedart-athenaeum)[flarum/core

Delightfully simple forum software.

211.3M1.9k](/packages/flarum-core)

PHPackages © 2026

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