umbrella/retorno-boleto

Biblioteca em PHP para leitura de arquivos de retorno de títulos de cobrança de bancos brasileiros.

Ya Retorno Boleto

, _(*1)

, _(*2)

O que é?

Biblioteca em PHP para leitura de arquivos de retorno de títulos de cobrança de bancos brasileiros., _(*3)

Arquivos suportados:, _(*4)

Instalação

# Install Composer
curl -sS https://getcomposer.org/installer | php

# Adicionando YA Retorno Boleto como dependencia
php composer.phar require umbrella/retorno-boleto:~1.2

Após a instalação, é necessário carregar o autoloader do composer:, _(*5)

require 'vendor/autoload.php';

Uso

Para lermos um arquivo de retorno, utilizamos uma factory que nos dirao tipo correto do arquivo e passaremos ele para um processador que irá lhe retornar o objeto do arquivo de retorno., _(*6)

use Umbrella\Ya\RetornoBoleto\ProcessFactory;
use Umbrella\Ya\RetornoBoleto\ProcessHandler;

// Utilizamos a factory para construir o objeto correto para um determinado arquivo de retorno
$cnab = ProcessFactory::getRetorno('arquivo-retorno.ret');

// Passamos o objeto contruido para o handler
$processor = new ProcessHandler($cnab);

// Processamos o arquivo. Isso retornará um objeto parseado com todas as propriedades do arquvio.
$retorno = $processor->processar();

Eventos

O retorno-boleto tem suporte a eventos utilizando o componente EventDispatcher do symfony., _(*7)

use Umbrella\Ya\RetornoBoleto\Event\OnDetailRegisterEvent;
use Umbrella\Ya\RetornoBoleto\ProcessFactory;
use Umbrella\Ya\RetornoBoleto\ProcessHandler;
use Umbrella\Ya\RetornoBoleto\RetornoEvents;

// Passamos o objeto contruido para o handler
$processor = new ProcessHandler($cnab);

$processor->getDispatcher()->addListener(RetornoEvents::ON_DETAIL_REGISTER,
                                         function(OnDetailRegisterEvent $event) use($self, &$count) {
    echo $event->getLineNumber() . PHP_EOL;
});

Atualmente temos os seguintes eventos:, _(*8)

Demo

A aplicação de demonstração está no repositório Ya Boleto Demo, _(*9)

Documentação

Mais informações podem ser encontradas na documentação on-line em http://ya-retorno-boleto.readthedocs.org/pt_BR/latest/., _(*10)