PHPackages                             easyx/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. [API Development](/categories/api)
4. /
5. easyx/metamorphosis

ActiveLibrary[API Development](/categories/api)

easyx/metamorphosis
===================

Kafka package for laravel applications

1.1.1(7mo ago)09MITPHPPHP ^8.0

Since May 2Pushed 7mo agoCompare

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

READMEChangelog (2)Dependencies (15)Versions (4)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)
- [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 easyx/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

34

—

LowBetter than 77% of packages

Maintenance62

Regular maintenance activity

Popularity4

Limited adoption so far

Community17

Small or concentrated contributor base

Maturity48

Maturing project, gaining track record

 Bus Factor2

2 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 ~255 days

Total

3

Last Release

236d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/80e86aebdddbdbda4c9967b8c157eea71f13cc1437d551d42d8338e68a352df3?d=identicon)[DontFollow](/maintainers/DontFollow)

---

Top Contributors

[![djonasm](https://avatars.githubusercontent.com/u/1079090?v=4)](https://github.com/djonasm "djonasm (214 commits)")[![brnbp](https://avatars.githubusercontent.com/u/8925112?v=4)](https://github.com/brnbp "brnbp (168 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)")[![hcdias](https://avatars.githubusercontent.com/u/4405802?v=4)](https://github.com/hcdias "hcdias (14 commits)")[![gemidio](https://avatars.githubusercontent.com/u/7032180?v=4)](https://github.com/gemidio "gemidio (7 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)")[![DontFollow](https://avatars.githubusercontent.com/u/27821679?v=4)](https://github.com/DontFollow "DontFollow (3 commits)")[![mithunra](https://avatars.githubusercontent.com/u/18493171?v=4)](https://github.com/mithunra "mithunra (2 commits)")[![GetulioMR](https://avatars.githubusercontent.com/u/10175963?v=4)](https://github.com/GetulioMR "GetulioMR (2 commits)")[![hfisaquiel](https://avatars.githubusercontent.com/u/225463518?v=4)](https://github.com/hfisaquiel "hfisaquiel (2 commits)")[![GetulioMeirelles](https://avatars.githubusercontent.com/u/75232974?v=4)](https://github.com/GetulioMeirelles "GetulioMeirelles (2 commits)")[![carusogabriel](https://avatars.githubusercontent.com/u/16328050?v=4)](https://github.com/carusogabriel "carusogabriel (2 commits)")

---

Tags

kafka

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm, Rector

Type Coverage Yes

### Embed Badge

![Health badge](/badges/easyx-metamorphosis/health.svg)

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

###  Alternatives

[andreaselia/laravel-api-to-postman

Generate a Postman collection automatically from your Laravel API

1.0k586.2k3](/packages/andreaselia-laravel-api-to-postman)[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)[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)[grantholle/powerschool-api

A Laravel package to make interacting with PowerSchool less painful.

1715.6k1](/packages/grantholle-powerschool-api)

PHPackages © 2026

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