O TCPDF é uma das bibliotecas mais populares para gerar PDFs em PHP. Ele é totalmente gratuito e possui diversos recursos, como personalização de cabeçalhos, rodapés, tabelas, imagens, entre outros. Neste tutorial, criaremos um relatório simples para entender como utilizar essa poderosa ferramenta.
Instalação do TCPDF
Passo 1: Baixar o TCPDF
Baixe a biblioteca diretamente do repositório oficial no GitHub: TCPDF no GitHub
Passo 2: Adicionar ao Projeto
Após o download, extraia o conteúdo em uma pasta do seu projeto, por exemplo: /tcpdf/.
Se você estiver usando o Composer, pode instalar o TCPDF com o seguinte comando:
composer require tecnickcom/tcpdf
Criando um Relatório Simples
Vamos criar um script PHP para gerar um relatório com um título, uma imagem, e algum texto formatado.
$pdf->SetAuthor('Seu Nome');
$pdf->SetTitle('Relatório Simples');
$pdf->SetSubject('Exemplo de PDF com TCPDF');
$pdf->SetKeywords('TCPDF, PDF, relatório, PHP');
// Remove as linhas automáticas de cabeçalho e rodapé
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);
// Define o layout e as margens
$pdf->SetMargins(15, 15, 15);
$pdf->SetAutoPageBreak(true, 15);
// Adiciona uma página ao PDF
$pdf->AddPage();
// ** TÍTULO **
// Define a fonte do título
$pdf->SetFont(‘helvetica’, ‘B’, 16);
// Escreve o título no PDF
$pdf->Cell(0, 10, ‘Relatório Simples’, 0, 1, ‘C’);
// ** IMAGEM **
// Adiciona uma imagem (certifique-se de ter uma imagem chamada “logo.png” no mesmo diretório)
$pdf->Image(‘logo.png’, 15, 25, 40, ”, ‘PNG’, ”, ‘T’, false, 300, ”, false, false, 1, false, false, false);
// ** SALVANDO OU EXIBINDO O PDF **
// Fecha e exibe o PDF no navegador
$pdf->Output(‘relatorio_simples.pdf’, ‘I’); // Para salvar localmente, use ‘F’ e forneça o caminho do arquivo.
?>
Dicas:
É possível assinar digitalmente os PDFs, isso pode ser feito utilizando certificado A1 ICP Brasil ou um certificado auto assinado, trataremos disso em um outro tutorial.
Também é possível colocar conteúdos em HTML ou até montar o PDF inteiro usando HTML, na parte 2 deste tutorial mostrarei como fazer isso e exemplos.
Cabeçalhos e Rodapés: Se quiser adicionar cabeçalhos e rodapés personalizados, você pode estender a classe TCPDF e sobrescrever os métodos Header e Footer.
Tabelas e Gráficos: Para tabelas, use o método Cell em conjunto com loops. Para gráficos, você pode usar bibliotecas como GD ou imagens externas.
Então, esperamos que tenha gostado deste tutorial! Conte com a Saldaris Consultoria para suporte e serviços de tecnologia na sua empresa!
