rjmangini/openboleto

从openboleto/openboleto分叉

v1.0 2013-08-04 20:53 UTC

This package is not auto-updated.

Last update: 2024-09-21 15:00:16 UTC


README

从OpenBoleto项目分叉(调整以配置PDF导出)

OpenBoleto Build Status

OpenBoleto是一个开源库,用于生成巴西银行汇票,这是一种常见的支付方式。其重点在于简单性和与PHP最新功能的兼容性。

安装

Composer

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

"openboleto/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与以下银行兼容:

## 与QuilhaSoft/JasperPHP集成

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

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

所有贡献都受到欢迎。如果您想将OpenBoleto适配到其他银行,请自由探索代码,并查看如何轻松地将任何银行集成到库中。

汇票和回执

https://github.com/QuilhaSoft/OpenCnabPHP

许可证

  • MIT许可证