BoletosPHP Orientado Ă Objetos
, (*1)
Esse pacote foi criado a partir do pacote BoletosPHP original (link) e fornece a mesma lógica, porém orientado a objeto, para uma melhor aplicação em frameworks e uso através do composer., (*2)
Pacote em desenvolvimento
Este pacote ainda encontra-se em fase de adaptação e nĂŁo tem suporte a todos os bancos disponĂveis no pacote original. Aos poucos estes vĂŁo sendo adicionados. DĂȘ um fork e contribua e ajude com correçÔes de bugs e novas features. Atualmente o pacote possui suporte aos seguintes bancos:
* ItaĂș
* Sicredi, (*3)
Install
Instalação através do composer:, (*4)
composer require giordanolima/boletosphp-oo
Uso
use GiordanoLima\BoletosPHP\Boletos;
$boleto = new Boletos(Boletos::BOLETOSPHP_ITAU);
$boleto->setData([...]);
$boleto->setImageBasePath("path/to/images/");
echo $boleto->render();
Constantes
Ao instanciar a classe, o banco que serĂĄ gerado o boleto deverĂĄ ser passado como parĂąmetro. Segue abaixo a tabela dos bancos e suas respectivas constantes:, (*5)
| Banco |
Constante |
| ItaĂș |
BOLETOSPHP_ITAU |
| Sicredi |
BOLETOSPHP_SICREDI |
Dados
Os dados dos boletos deverão ser passados através do método setDatano formato de array, no estilo campo => valor.
Ex.:, (*6)
$boleto->setData([
"valor_boleto" => "99,00",
"data_vencimento" => "01/04/2016",
"nosso_numero" => 00000001,
(...)
]);
Os dados padrĂŁo a todos os bancos sĂŁo:, (*7)
| Campo | Descrição | Obrigatório |
|:------------------:|-----------------------------------------------------------|:-----------:|
| valor_boleto | Valor do boleto no formato de moeda brasileira. | SIM |
| data_vencimento | Data de vencimento do boleto no formato d/m/Y | SIM |
| nosso_numero | NĂșmero que serĂĄ usado como base para gerar o nosso nĂșmero | SIM |
| agencia | AgĂȘncia do cedente | SIM |
| conta | Conta do cedente | SIM |
| conta_dv | DĂgito verificador da conta do cedente | SIM |
| carteira | Carteira do cedente | SIM |
| identificacao | Nome do cedente | SIM |
| cpf_cnpj | CPF ou CNPJ do cedente | SIM |
| numero_documento | Campo "NĂșmero do Documento" do boleto | NĂO |
| data_documento | Data do documento. Formato: d/m/Y | NĂO |
| data_processamento | Data do processamento. Formato: d/m/Y | NĂO |
| sacado | Nome do sacado | NĂO |
| endereco | Endereço completo do sacado a ser mostrado no Recibo | NĂO |
| endereco1 | Linha 1 do endereço no corpo do boleto | NĂO |
| endereco2 | Linha 2 do endereço no corpo do boleto | NĂO |
| demonstrativo1 | Linha 1 do demonstrativo | NĂO |
| demonstrativo2 | Linha 2 do demonstrativo | NĂO |
| demonstrativo3 | Linha 3 do demonstrativo | NĂO |
| instrucoes1 | Linha 1 das instruçÔes | NĂO |
| instrucoes2 | Linha 2 das instruçÔes | NĂO |
| instrucoes3 | Linha 3 das instruçÔes | NĂO |
| instrucoes4 | Linha 4 das instruçÔes | NĂO |
| quantidade | Campo quantidade do boleto | NĂO |
| valor_unitario | Campo valor unitĂĄrio do boleto | NĂO |
| aceite | Campo aceito do boleto | NĂO |
| especie | Campo espĂ©cie do boleto | NĂO |
| especie_doc | Campo especie_doc do boleto | NĂO |
| cidade_uf | Cidade/UF do cedente | NĂO |
| cedente | RazĂŁo Social ou Nome Completo do cedente | NĂO |
Cada banco possui seus campos especĂficos, sĂŁo eles, respectivamente:, (*8)
ItaĂș
NĂŁo existem campos especĂficos para esse banco., (*9)
Sicredi
| Campo |
Descrição |
ObrigatĂłrio |
| posto |
Código do posto da cooperativa de crédito |
SIM |
| byte_idt |
Byte de identificação do cedente do bloqueto utilizado para compor o nosso nĂșmero. |
SIM |
Imagens
As imagens utilizadas no pacote estĂŁo na pasta imagens do pacote. Essas imagens deverĂŁo ser colocadas em uma pasta pĂșblica do projeto e o caminho deverĂĄ ser setada pelo mĂ©todo setImageBasePath. Ex.:, (*10)
$boleto->setImageBasePath("http://meusite.com.br/img/boletosphp/"); // Com "/" no final
Render
O método render irå retornar um código HTML com o respectivo boleto gerado., (*11)
echo $boleto->render();
/* IrĂĄ imprimir um cĂłdigo HTML
* <html>
* ...
* </html>
*/
Wallogit.com
