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.2kMITPHPPHP ^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 1mo 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

28

—

LowBetter than 54% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity22

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity51

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

970d 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

[spatie/laravel-sitemap

Create and generate sitemaps with ease

2.6k14.6M107](/packages/spatie-laravel-sitemap)[sauladam/shipment-tracker

Parses tracking information for several carriers, like UPS, USPS, DHL and GLS by simply scraping the data. No need for any kind of API access.

9738.8k](/packages/sauladam-shipment-tracker)[professional-wiki/edtf

PHP library to parse, represent and work with dates that follow the Extended Date/Time Format specification.

10432.1k4](/packages/professional-wiki-edtf)

PHPackages © 2026

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