readme.pt.md

Metamorphosis

Uma biblioteca Kafka simples e flexível para Laravel e PHP 7.

• Introdução
• Requisitos
• Instalação
• Guia rápido
• Guia avançado
• Como contribuir
• Licença

Introdução

Metamorphosis fornece uma implementação simples e prática para trabalhar com Kafka, em aplicações Laravel.

Prefere ler em outro idioma?

• English

Requisitos

• PHP >= 7.1
• Driver Kafka
• Extensão do Kafka PHP

Instalação

1. Instale o driver Kafka

No Mac OSX, instale a librdkafka com homebrew:

brew install librdkafka

No Debian e Ubuntu, adicione o repositório APT da Confluent e então instale a librdkafka:

apt install librdkafka-dev

No RedHat, CentOS e Fedora, adicione o repositório YUM da Confluent e então instale a librdkafka:

yum install librdkafka-devel

No Windows, referencie o pacote NuGet librdkafka.redist no seu projeto do Visual Studio.

2. Instale a extensão PHP Kafka

No Linux, Unix e OS X, você pode instalar extensões usando a PHP Extension Community Library (PECL):

pecl install rdkafka

Após a instalação, adicione a extensão ao arquivo .ini:

extension=rdkafka.so

Importante: Quando existem múltiplas versões do PHP instaladas, a PECL instala os pacotes apenas para a última versão do PHP. Para especificar uma versão do PHP durante a instalação dos pacotes, baixe o código-fonte e compile o pacote especificando a versão do PHP desejada.

Exemplo para o PHP 7.4:

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

Após compilar e instalar, adicione a extensão ao arquivo .ini:

extension=rdkafka.so

Saiba mais sobre como compilar extensões PECL.

No Windows, baixe a DLL rdkafka, coloque o arquivo no diretório de extensões do PHP e adicione a extensão ao seu php.ini:

extension=rdkafka.dll

Saiba mais sobre pacotes PECL no Windows

3. Instale o Metamorphosis

Instale a biblioteca via Composer:

composer require leroy-merlin-br/metamorphosis

Publique o arquivo de configuração:

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

Para instruções de uso, dê uma olhada no nosso guia rápido.

Licença

Metamorphosis é um software livre distribuído pelos termos MIT license

Informações adicionais

Metamorphosis foi orgulhosamente desenvolvido pelo time Leroy Merlin Brasil. Veja todos os colaboradores.