PHPackages                             vinifranco/zip-return-parser - 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. [Parsing & Serialization](/categories/parsing)
4. /
5. vinifranco/zip-return-parser

ActiveLibrary[Parsing & Serialization](/categories/parsing)

vinifranco/zip-return-parser
============================

Interpretador para arquivos de retorno em ZIP

v1.1.0(2y ago)22.4kMITPHPPHP ^7.2.5|^8.0CI failing

Since May 24Pushed 2y ago1 watchersCompare

[ Source](https://github.com/ViniFranco/zip-return-parser)[ Packagist](https://packagist.org/packages/vinifranco/zip-return-parser)[ RSS](/packages/vinifranco-zip-return-parser/feed)WikiDiscussions master Synced 1w ago

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

Interpretador para arquivos de retorno em ZIP
=============================================

[](#interpretador-para-arquivos-de-retorno-em-zip)

Pacote para ler arquivos de retorno de APIs de banking que estejam em formato ZIP.

- [Interpretador para arquivos de retorno em ZIP](#interpretador-para-arquivos-de-retorno-em-zip)
    - [Requerimentos](#requerimentos)
    - [Motivação](#motiva%C3%A7%C3%A3o)
        - [Uso](#uso)
        - [Créditos](#cr%C3%A9ditos)
        - [Licença](#licen%C3%A7a)

Requerimentos
-------------

[](#requerimentos)

- PHP >=7.2.5.
- [PHP extensão ZIP](https://www.php.net/manual/pt_BR/zip.installation.php)
- [PHP extensão Mbstring](https://www.php.net/manual/pt_BR/mbstring.installation.php)

Motivação
---------

[](#motivação)

Algumas APIs de bancos retornam os arquivos - seja de movimentação, remessa ou qualquer outro tipo de retorno - zipados, codificados em formato base64 em respostas de API. Para facilitar o processo, este pacote contém funções de processamento comum para tais arquivos.

### Uso

[](#uso)

Exemplo com o formato da API do banco Sicoob, que tem um campo 'resultado' e um 'arquivo' que está codificado em formato base64. O arquivo que está dentro do ZIP é um JSON:

```
  use Vini\ZipReturnParser\Handler;
  use Vini\ZipReturnParser\Responses\Sicoob;
  use Vini\ZipReturnParser\Factories\FileFormatFactory;

  // ... busca o arquivo na API do banco: $respostaApi

  // Cria uma instância do handler
  $handler = new Handler();

  // Cria o formato de resposta
  $response = (new Sicoob($respostaApi))->format();

  // Passa o arquivo para o handler
  $handler->fromBase64($response->arquivo)->make();

  // Usa o primeiro arquivo e cria uma instância da classe que trata JSON automaticamente
  $file = $handler->first()->toFormat(FileFormatFactory::FORMAT_JSON);

  // Imprime na tela o conteúdo do arquivo (nesse passo qualquer outro processamento pode ser feito)
  var_dump($file->getDecoded());

  // Limpa os arquivos temporários do disco
  $handler->clean();
```

### Créditos

[](#créditos)

Agradeço a colaboração dos amigos nos testes e processo de elaboração da ideia que tornou esse pacote realidade:

- [Murilo Sandiego](https://github.com/murilosandiego)
- Altierres Washington

### Licença

[](#licença)

MIT

###  Health Score

29

—

LowBetter than 57% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity23

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity52

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

Every ~120 days

Total

2

Last Release

1061d ago

PHP version history (2 changes)v1.0.0PHP >=7.0

v1.1.0PHP ^7.2.5|^8.0

### Community

Maintainers

![](https://www.gravatar.com/avatar/206384903607c440c8e6f32ac88a55a82c8b7d7d6976eccad2f95d0b269650d3?d=identicon)[vinifranco](/maintainers/vinifranco)

---

Top Contributors

[![ViniFranco](https://avatars.githubusercontent.com/u/34460218?v=4)](https://github.com/ViniFranco "ViniFranco (31 commits)")

###  Code Quality

TestsPHPUnit

Static AnalysisPsalm

Code StylePHP CS Fixer

Type Coverage Yes

### Embed Badge

![Health badge](/badges/vinifranco-zip-return-parser/health.svg)

```
[![Health](https://phpackages.com/badges/vinifranco-zip-return-parser/health.svg)](https://phpackages.com/packages/vinifranco-zip-return-parser)
```

###  Alternatives

[laravel/framework

The Laravel Framework.

34.9k556.2M21.5k](/packages/laravel-framework)[spatie/laravel-sitemap

Create and generate sitemaps with ease

2.6k17.3M164](/packages/spatie-laravel-sitemap)[statamic/cms

The Statamic CMS Core Package

4.9k3.8M1.2k](/packages/statamic-cms)[bitrix24/b24phpsdk

An official PHP library for the Bitrix24 REST API

10250.3k6](/packages/bitrix24-b24phpsdk)[pimcore/studio-backend-bundle

Pimcore Studio Backend Bundle

20248.6k29](/packages/pimcore-studio-backend-bundle)[lion/bundle

Lion-framework configuration and initialization package

132.4k5](/packages/lion-bundle)

PHPackages © 2026

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