sincore-digital/sinreports

There is no license information available for the latest version (0.1) of this package.

Biblioteca PHP gerador de relatórios

0.1 2026-07-06 23:42 UTC

Requires

• mikehaertl/phpwkhtmltopdf: 2.*
• phpoffice/phpspreadsheet: 5.*
• smarty/smarty: 4.*

Unknown License

Published on Packagist.org on 2026-08-01 15:39 UTC

README

🔴 ainda estamos em teste, não utilize em produção, pois pode quebrar à qualquer commit

SiNReports

O SiNReports é uma biblioteca gratuita para a geração automatizada de relatórios e documentos sem utilização de APIs remotas, servidores e instalações complexas. Renderize templates Smarty e crie relatórios/documentos em HTML, PDF e XLS

Instalação

composer require sincore/sinreports

Ao baixar a lib, os binários ja está embutidos, mas caso exista problema em executa-los, é possivel utilizar o path para o seu proprio binário

Como usar

Para criar relatórios tabulados

$vars = [
	[
		'id' => 12,
		'nome' => "produto 1",
		'valor' => 45.30
	],
	[
		'id' => 23,
		'nome' => "produto 2",
		'valor' => 101.41
	],
];

$report = new \SiNReports\Report();
$report->setDebugMode(TRUE)
	->setDataset($vars)

	// ->toHtml() // gera o arquivo final em HTML
	// ->toXls() // gera o arquivo final em XLS
	->toPdf() // gera o arquivo final em PDF

	//->save(APPLICATION_PATH . "/files/meupdf.pdf") // salva no arquivo
	// ->show() // exibe na tela
	->download(); // envia o arquivo para download

Para criar documentos complexos

$vars = [
	'nome' => "Nome do comprador",
	'documento' => "xxx.xxx.xxx-xx",
	'produtos' => [
		[
			'id' => 12,
			'nome' => "produto 1",
			'valor' => 45.30
		],
		[
			'id' => 23,
			'nome' => "produto 2",
			'valor' => 101.41
		],
	];
];

$report = new \SiNReports\Report();
$report->setDebugMode(TRUE)
	->setTemplate(APPLICATION_PATH . "/relatorios/teste.tpl")
	->setVars($vars)

	// ->toHtml() // gera o arquivo final em HTML
	// ->toXls() // gera o arquivo final em XLS
	->toPdf() // gera o arquivo final em PDF

	//->save(APPLICATION_PATH . "/files/meupdf.pdf") // salva no arquivo
	// ->show() // exibe na tela
	->download(); // envia o arquivo para download

Dependências

• smarty/smarty: Responsável por ler o template à ser gerado e renderizar em HTML
• wkhtmltopdf (Binário): Binário responsável por renderizar o HTML em PDF
• mikehaertl/phpwkhtmltopdf: Responsável fazer as chamadas ao wkhtmltopdf

Contribua

Pull requests são muito bem-vindos. Para novas ideias, por favor utilize a sessão de issues para discutir novas mudanças e funcionalidades

License

GPLv3