leonardo-max/openboleto

银行支票生成库。

v1.1 2022-05-17 18:56 UTC

This package is auto-updated.

Last update: 2024-09-18 00:05:45 UTC


README

O OpenBoleto 是一个用于生成银行支票的开源代码库,是巴西非常常见的一种支付方式。其重点在于简单易用,并且能够与 PHP 的最新功能兼容。

帮助项目继续发展,请进行捐赠!

Pague com PagSeguro - é rápido, grátis e seguro!

安装

Composer

如果您已经熟悉 Composer(强烈推荐),只需将以下依赖项添加到您的 composer.json 文件中的 "require" 指令即可。

"leonardo-max/openboleto": "dev-master"

PSR-0 自动加载器

如今,几乎所有框架都使用此标准,因此您需要 下载 OpenBoleto,将其放入特定文件夹(通常为 libvendor),然后查阅您框架的文档,以便使自动加载器将命名空间 OpenBoleto 指向 OpenBoleto 的 src 文件夹。

独立库

如果您只想下载并包含,这也非常简单。首先 下载(或克隆)并放入特定文件夹。然后,包含 autoloader.php 文件即可。

生成支票

这是最好的部分。它再简单不过了,看看以下基本示例

use OpenBoleto\Banco\BancoDoBrasil;
use OpenBoleto\Agente;

$sacado = new Agente('Fernando Maia', '023.434.234-34', 'ABC 302 Bloco N', '72000-000', 'Brasília', 'DF');
$cedente = new Agente('Empresa de cosméticos LTDA', '02.123.123/0001-11', 'CLS 403 Lj 23', '71000-000', 'Brasília', 'DF');

$boleto = new BancoDoBrasil(array(
    // Parâmetros obrigatórios
    'dataVencimento' => new DateTime('2013-01-24'),
    'valor' => 23.00,
    'sequencial' => 1234567, // Para gerar o nosso número
    'sacado' => $sacado,
    'cedente' => $cedente,
    'agencia' => 1724, // Até 4 dígitos
    'carteira' => 18,
    'conta' => 10403005, // Até 8 dígitos
    'convenio' => 1234, // 4, 6 ou 7 dígitos
));

echo $boleto->getOutput();

是的,就这么多!请记住,每个银行都有一些特殊性,但通常这些参数是必需的。在 samples 文件夹中,每个银行的示例功能都已提供,您可以检查哪些参数是每个银行必需的。

支持的银行

目前 OpenBoleto 与以下银行兼容

API Banco Inter

Inter 银行正在提供用于生成支票的 API。项目 ctodobom/APInter-PHP 实现了访问该 API 的功能。

与 QuilhaSoft/JasperPHP 集成

QuilhaSoft/JasperPHP 是一个纯 PHP 库,可以在不进行 HTML 转换的情况下以 PDF 格式生成支票,支票的布局可以使用 JasperSoft Studio 进行编辑。

要查看示例,请打开 https://github.com/QuilhaSoft/JasperPHP-OpenBoleto

所有贡献都受欢迎。如果您想将 OpenBoleto 适配到其他银行,请随意探索代码,看看如何将任何银行集成到库中都是非常简单的。

发送和接收

https://github.com/QuilhaSoft/OpenCnabPHP

许可协议

  • MIT 许可协议