PHPackages                             davsonsantos/evolution-api-php - 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. davsonsantos/evolution-api-php

ActiveLibrary[API Development](/categories/api)

davsonsantos/evolution-api-php
==============================

SDK Profissional para Evolution API v1

V1.0(6mo ago)00MITPHPPHP ^8.2

Since Dec 24Pushed 6mo agoCompare

[ Source](https://github.com/davsonsantos/evolution-api-sdk)[ Packagist](https://packagist.org/packages/davsonsantos/evolution-api-php)[ RSS](/packages/davsonsantos-evolution-api-php/feed)WikiDiscussions master Synced 1mo ago

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

Evolution API PHP SDK
=====================

[](#evolution-api-php-sdk)

Uma implementação elegante, robusta e de alta performance para integração com a Evolution API v1. Construído sobre os pilares da arquitetura moderna de software, este SDK é agnóstico a frameworks, respeita as normas PSR-17/18 e tira proveito total das funcionalidades do PHP 8.2+.

---

🏗 Estrutura do Projeto
======================

[](#-estrutura-do-projeto)

O pacote segue uma organização rigorosa para garantir manutenibilidade:

Diretorios
----------

[](#diretorios)

```
src/

├── Contracts/           # Interfaces e Contratos (Desacoplamento)

├── DTOs/                # EvolutionInstance (Objeto de dados unificado)

├── Exceptions/         # Hierarquia de erros (Auth, NotFound, etc)

├── Providers/          # Integração nativa com Laravel

└── EvolutionClient.php # O coração do SDK

```

🚀 Instalação
------------

[](#-instalação)

composer require davsonsantos/evolution-api-php

💻 Uso em PHP Puro (Agnóstico)
-----------------------------

[](#-uso-em-php-puro-agnóstico)

Este SDK não te prende a frameworks. Você pode usá-lo com qualquer implementação de cliente HTTP que respeite a PSR-18 (como Guzzle ou Symfony HTTP Client).

```
use EvolutionPHP\EvolutionClient;
use GuzzleHttp\Client as GuzzleClient;
use GuzzleHttp\Psr7\HttpFactory;

$evolution = new EvolutionClient(
    baseUrl: 'https://sua-api.com',
    apiKey: 'sua_global_api_key',
    httpClient: new GuzzleClient(),
    requestFactory: new HttpFactory()
);

try {
    $instance = $evolution->connect('minha_loja');
    echo "QR Code: " . $instance->qrCodeBase64;
} catch (\EvolutionPHP\Exceptions\InstanceNotFoundException $e) {
    // Trate instâncias não existentes
}

```

🍃 Uso com Laravel
-----------------

[](#-uso-com-laravel)

O SDK possui Auto-discovery. Basta configurar suas variáveis de ambiente:

1. Adicione ao seu .env:asdasdasd

    ```
     EVOLUTION_BASE_URL=https://api.suadominio.com
     EVOLUTION_API_KEY=seu_token_aqui

    ```

2. (Opcional) Publique o arquivo de configuração:

    ```
     php artisan vendor:publish --tag="evolution-config"

    ```
3. Injeção de Dependência em seus Controllers:

    ```
     use EvolutionPHP\EvolutionClient;

     public function connect(EvolutionClient $evolution)
     {
         $instance = $evolution->connect('vendas_01');
         return view('qrcode', ['code' => $instance->qrCodeBase64]);
     }

    ```

🛡 Tratamento de Exceções
------------------------

[](#-tratamento-de-exceções)

Não trabalhamos com arrays de erro ambíguos. O SDK lança exceções de domínio específicas:

```
Exceção	                    Causa
AuthException	            API Key inválida ou expirada (401/403).
InstanceNotFoundException	A instância solicitada não existe (404).
EvolutionException	        Erro genérico da API ou falha de comunicação.

```

Funcionalidades
---------------

[](#funcionalidades)

🛠 Funcionalidades Implementadas \[x\] Conexão e Geração de QR Code (Base64)

\[x\] Consulta de status de instância

\[x\] DTO Unificado para respostas de API

\[x\] Tratamento de erros via Exceções de Domínio

\[x\] Suporte total a PSR-17 e PSR-18

⚖ Licença
---------

[](#-licença)

The MIT License (MIT). Por favor, veja o [MIT](https://choosealicense.com/licenses/mit/) para mais informações.

###  Health Score

32

—

LowBetter than 69% of packages

Maintenance67

Regular maintenance activity

Popularity0

Limited adoption so far

Community6

Small or concentrated contributor base

Maturity47

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

Unknown

Total

1

Last Release

190d ago

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2894632?v=4)[Davson Santos](/maintainers/davsonsantos)[@davsonsantos](https://github.com/davsonsantos)

---

Top Contributors

[![davsonsantos](https://avatars.githubusercontent.com/u/2894632?v=4)](https://github.com/davsonsantos "davsonsantos (10 commits)")

### Embed Badge

![Health badge](/badges/davsonsantos-evolution-api-php/health.svg)

```
[![Health](https://phpackages.com/badges/davsonsantos-evolution-api-php/health.svg)](https://phpackages.com/packages/davsonsantos-evolution-api-php)
```

###  Alternatives

[tempest/framework

The PHP framework that gets out of your way.

2.2k34.4k15](/packages/tempest-framework)[drupal/core-recommended

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

6942.5M419](/packages/drupal-core-recommended)[craftcms/cms

Craft CMS

3.6k3.6M3.1k](/packages/craftcms-cms)[chargebee/chargebee-php

ChargeBee API client implementation for PHP

758.5M9](/packages/chargebee-chargebee-php)[typo3/cms

TYPO3 CMS is a free open source Content Management Framework initially created by Kasper Skaarhoj and licensed under GNU/GPL.

1.2k1.9M122](/packages/typo3-cms)[flow-php/flow

PHP ETL - Extract Transform Load - Data processing framework

85036.3k](/packages/flow-php-flow)

PHPackages © 2026

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