uoston / openboleto
银行汇票生成库。
Requires
- php: >=5.6
- dompdf/dompdf: ^2.0
README
OpenBoleto是一个用于生成银行汇票的开源库,这是巴西非常常见的一种支付方式。其重点是简单易用,并具有与PHP最新功能兼容的架构。
帮助项目继续发展,请进行捐赠!
安装
Composer
如果您已经熟悉Composer(强烈推荐),只需将以下依赖项添加到您的composer.json文件中的“require”指令即可。
"openboleto/openboleto": "dev-master"
PSR-0自动加载器
现在几乎所有框架都使用这个标准,因此您应该下载OpenBoleto,将其放入特定文件夹(通常是lib或vendor),然后查阅您框架的文档,以便使自动加载器将命名空间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与以下银行兼容:
Inter银行API
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许可证