vinifranco / zip-return-parser
ZIP返回文件解释器
v1.1.0
2023-09-22 00:00 UTC
Requires
- php: ^7.2.5|^8.0
- ext-mbstring: *
- ext-zip: *
- nesbot/carbon: ^2.0
Requires (Dev)
This package is auto-updated.
Last update: 2024-09-22 02:01:41 UTC
README
这是一个用于读取银行API返回的ZIP格式文件的包。
要求
- PHP >=7.2.5.
- PHP ZIP扩展
- PHP Mbstring扩展
动机
一些银行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();
致谢
感谢朋友们在测试和构思这个包的过程中给予的合作。
- Murilo Sandiego
- Altierres Washington
许可协议
MIT