Tutorial: Gerando um Relatório em PDF com TCPDF no PHP

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);

// Move o cursor para baixo
$pdf->Ln(40);

// ** TEXTO FORMATADO **
$pdf->SetFont(‘helvetica’, ”, 12);
// Adiciona um parágrafo de texto
$texto = <<MultiCell(0, 10, $texto, 0, ‘L’, 0, 1, ”, ”, true);

// ** 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!