vinifranco/zip-return-parser

ZIP返回文件解释器

v1.1.0 2023-09-22 00:00 UTC

This package is auto-updated.

Last update: 2024-09-22 02:01:41 UTC


README

这是一个用于读取银行API返回的ZIP格式文件的包。

要求

动机

一些银行API返回的文件(无论是交易、汇款或其他类型的返回)都是ZIP格式,并使用base64编码。为了简化流程,此包包含对这些文件进行处理的常用函数。

使用方法

以下是以Sicoob银行API的格式为例,该API有一个'结果'字段和一个编码为base64的'文件'字段。ZIP内的文件是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();

致谢

感谢朋友们在测试和构思这个包的过程中给予的合作。

许可协议

MIT