README

O OpenBoleto 是一个用于生成银行汇票的开源代码库，是巴西非常常见的支付方式。其重点是简单易用，并具有与 PHP 最新资源兼容的架构。

安装

Composer

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

"kriansa/openboleto": "dev-master"

或者，如果您想使用 v1.0 版本（2013年12月8日）

"kriansa/openboleto": "v1.0"

###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 支持以下银行

• 巴西利亚银行 (BRB)
• 巴西银行
• 布拉德斯科
• 巴西联邦储蓄银行 (SIGCB)
• 伊塔乌
• 桑坦德
• 优尼克里德

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

许可证

• MIT 许可证