elzobrito/olivia-pdf

PDF library based on FPDF with Olivia extensions

Maintainers

Package info

github.com/elzobrito/OliviaPdf

pkg:composer/elzobrito/olivia-pdf

Statistics

Installs: 19

Dependents: 1

Suggesters: 0

Stars: 0

Open Issues: 0

Security

Advisories: 0

Aikido package health analysis

1.1 2026-04-16 23:26 UTC

Requires

MIT 0dca18e4345c3c867e76dc0bb9d0458da54e66c8

  • Elzo Brito dos Santos Filho <elzo.filho.woop@etec.sp.gov.br>

This package is auto-updated.

Last update: 2026-04-16 23:28:03 UTC

README

Fork do FPDF com extensões voltadas para geração de PDFs em PHP, incluindo cabeçalho customizado, rodapé com autenticação, tabelas simples, HTML básico e texto rotacionado.

Requisitos

  • PHP ^7.1 || ^8.0
  • Composer

Instalação

Se o pacote estiver publicado no Composer:

composer require elzobrito/olivia-pdf

Se o projeto estiver sendo usado localmente, basta manter o autoload do Composer ativo:

require __DIR__ . '/vendor/autoload.php';

Namespace

use Oliviapdf\Pdf;

O que este fork adiciona

Além dos recursos originais do FPDF, a classe Oliviapdf\Pdf inclui:

  • Circle() e Ellipse() para desenho de formas
  • SetWidths(), SetAligns() e Row() para tabelas simples com quebra automática
  • WriteHTML() com suporte básico a tags HTML
  • TextWithDirection() e TextWithRotation() para texto orientado ou rotacionado
  • Header() com logo, título e subtítulo
  • Footer() com paginação e código de autenticação lateral

Exemplo rápido

<?php

require __DIR__ . '/vendor/autoload.php';

use Oliviapdf\Pdf;

$pdf = new Pdf();
$pdf->AliasNbPages();

$pdf->image_logo = __DIR__ . '/logo.png';
$pdf->title = 'Relatório de Atendimento';
$pdf->subtitle = 'Período de abril de 2026';
$pdf->autentication = 'ABC123456';

$pdf->AddPage();
$pdf->SetFont('Arial', '', 12);

$pdf->WriteHTML('<p align="center"><b>Olivia PDF</b><br>Fork do FPDF com recursos extras.</p>');
$pdf->Ln(8);

$pdf->SetWidths([50, 80, 50]);
$pdf->SetAligns(['L', 'L', 'C']);
$pdf->Row(['Nome', 'Descrição', 'Status']);
$pdf->Row(['Olivia', 'Documento gerado com tabela automática', 'OK']);
$pdf->Row(['Sistema', 'Linha com quebra automática para textos maiores dentro da célula', 'ATIVO']);

$pdf->Ln(10);
$pdf->Circle(20, 90, 5);
$pdf->TextWithRotation(30, 100, 'Texto rotacionado', 45);

$pdf->Output('I', 'exemplo.pdf');

Cabeçalho e rodapé

O cabeçalho e o rodapé são acionados automaticamente ao usar AddPage().

Propriedades disponíveis

  • $image_logo: caminho da imagem exibida no topo
  • $title: título centralizado no cabeçalho
  • $title_config_array: configuração da fonte do título no formato ['Arial', 'B', 10]
  • $subtitle: subtítulo abaixo do título
  • $subtitle_config_array: configuração da fonte do subtítulo no formato ['Arial', '', 9]
  • $autentication: texto exibido lateralmente no rodapé
  • $end_page: sufixo da paginação, por padrão /{nb}

Exemplo

$pdf->AliasNbPages();
$pdf->image_logo = __DIR__ . '/logo.png';
$pdf->title = 'Meu Documento';
$pdf->title_config_array = ['Arial', 'B', 12];
$pdf->subtitle = 'Subtítulo do relatório';
$pdf->subtitle_config_array = ['Arial', '', 10];
$pdf->autentication = 'TOKEN-001';

Tabelas com Row()

Antes de chamar Row(), defina a largura das colunas com SetWidths() e, se quiser, o alinhamento com SetAligns().

$pdf->SetFont('Arial', '', 10);
$pdf->SetWidths([40, 100, 40]);
$pdf->SetAligns(['L', 'L', 'C']);

$pdf->Row(['Código', 'Descrição', 'Valor']);
$pdf->Row(['001', 'Item com descrição longa e quebra automática dentro da célula', 'R$ 10,00']);

Observações

  • Row() usa MultiCell() internamente
  • a altura da linha é calculada automaticamente
  • se faltar espaço na página, ocorre quebra automática
  • se nenhuma fonte tiver sido definida com SetFont(), a classe lança erro

HTML suportado em WriteHTML()

O parser é propositalmente simples. Ele atende textos rápidos, mas não substitui um renderizador HTML completo.

Tags suportadas

  • <b>, <i>, <u>
  • <a href="...">
  • <br>
  • <p align="center">
  • <hr>

Exemplo

$pdf->SetFont('Arial', '', 12);
$pdf->WriteHTML('<b>Negrito</b> <i>itálico</i> <u>sublinhado</u><br>');
$pdf->WriteHTML('<a href="https://example.com">Abrir link</a>');

Métodos extras

Circle(float $x, float $y, float $r, string $style = 'D')

Desenha um círculo.

Ellipse(float $x, float $y, float $rx, float $ry, string $style = 'D')

Desenha uma elipse.

TextWithDirection(float $x, float $y, string $txt, string $direction = 'R')

Escreve texto nas direções:

  • R: esquerda para direita
  • L: direita para esquerda
  • U: de baixo para cima
  • D: de cima para baixo

TextWithRotation(float $x, float $y, string $txt, float $txt_angle, float $font_angle = 0)

Escreve texto rotacionado em qualquer ângulo.

Compatibilidade e observações

  • A classe continua herdando de Fpdf\Fpdf
  • O texto é convertido para windows-1252 internamente para manter compatibilidade com o fluxo tradicional do FPDF
  • Para recursos avançados de Unicode, layout complexo ou HTML/CSS completo, pode ser necessário adotar uma biblioteca com suporte mais amplo

Desenvolvimento

Validações úteis durante manutenção:

composer validate --no-check-publish
php -l src/Pdf.php

Licença

Este projeto é distribuído sob a licença MIT. O FPDF mantém sua licença própria no pacote original.