mPDF PHP e PDF

Este Post mudou para: http://diogobesson.com.br/1/mpdf-php-e-pdf/

Mais ou menos por volta do dia 21/12, eu estive conversando sobre a geração de documentos portáteis (PDF) com o sr. Janes Roberto da Costa, analista de sistemas da Secretaria de Estado de Educação de Mato Grosso.

Ele comentou que possuía uma experiência significativa com uma classe em PHP chamada mPDF que poderia ser a solução da maioria dos problemas comuns e avançados na geração de PDF para a web.

Assim fomos discutindo e, com alguns exemplos que ele me forneceu, consegui desvendar o funcionamento da classe. Aproveito para compartilhar com vocês alguns desses assuntos neste weblog.

Primeiramente, faça o download da classe.

Os arquivos para download estão em http://mpdf.bpm1.com/download . Este é o website oficial do mPDF.

Sugiro que faça o download do pacote de Core do mPDF e também das Fontes Extras para um melhor aproveitamento futuro, porém somente o Core é realmente necessário para utilizar a classe.

A versão atual do pacote no momento de elaboração deste artigo é a 4.1.1

Já baixei. E agora?

Descompacte o pacote do Core. Se você baixou também as fontes extras, descomprima-as dentro da pasta /unifont/ da estrutura do Core.

Essa pasta com todos os arquivos do Core, que aqui ficou com o nome de /MPDF411/ possui toda a estrutura utilizada pela classe principal (mpdf.php) e deve ser acessível pelo seu sistema web.

No meu modo de ver, não estando trabalhando com MVC, o ideal é que ela fique localizada na raiz do seu sistema ou em uma pasta de trabalho de classes de terceiros, portanto, se você tem uma intranet e a pasta raiz se chama /intranet/, poderá instalar o Core dentro de /intranet/MPDF411/ ou intranet/classes/MPDF411/, porém isso fica a critério livre, lembrando que é muito importante apenas que os arquivos e a estrutura de pastas de dentro da pasta do Core não sejam de maneira alguma modificados.

O manual diz também que você deve certificar-se de obter permissão de escrita na pasta raiz da classe e na pasta de trabalho /graph_cache/

Para ter certeza de que tudo foi feito conforme os trâmites convencionais, vá no browser até a pasta /examples/ da sua instalação e rode o arquivo index.php. Ele contém uma série de exemplos que também servem de testes de funcionamento. Lá você pode obter informações de debug e consertar algumas particularidades como fontes que estão faltando, outras permissões necessárias e etc.

Alo Mundo com mPDF

Vamos então fazer um alô mundo pra começar a brincar com o mPDF

define('MPDF_PATH', 'classes/mpdf411/');
include(MPDF_PATH.'mpdf.php');
$mpdf=new mPDF();
$mpdf->WriteHTML('Alo Mundo');
$mpdf->Output();
exit();

Bem simples, não?

Na primeira linha você define o caminho da classe e na segunda você inclui.

Na terceira você cria um objeto mPDF

Na quarta você escreve o HTML diretamente no seu arquivo PDF, lembrando que ele só aceita UTF-8, por isso, caso você queira escrever “Alô Mundo”, terá que fazer algo do tipo $mpdf->WriteHTML(utf8_encode(“<p>Alô Mundo</p>’”)); , ok?

As outras duas linhas que seguem são a apresentação do que foi montado via WriteHTML().

Muito fácil.

Vamos avançar um pouco mais

Você pode montar o HTML separadamente e incluir TUDO com WriteHTML() via buffer, usando ob_start().

Vamos testar?

<?php
ob_start();  //inicia o buffer
?>

<b>Um Html Qualquer</b>
<h1>Título</h1>
<p>Funciona!!! </p>

<?php
$html = ob_get_clean();
// pega o conteudo do buffer, insere na variavel e limpa a memória

$html = utf8_encode($html);
// converte o conteudo para uft-8

define('MPDF_PATH', 'classes/mpdf411/');
include(MPDF_PATH.'mpdf.php');
// inclui a classe

$mpdf = new mPDF();
// cria o objeto

$mpdf->allow_charset_conversion=true;
// permite a conversao (opcional)
$mpdf->charset_in='UTF-8';
// converte todo o PDF para utf-8

$mpdf->WriteHTML($html);
// escreve definitivamente o conteudo no PDF

$mpdf->Output();
// imprime

exit();
// finaliza o codigo

?>

Isso é um pouco mais complicado, porém nada tão assustador assim.

E isso dá margem para várias outras coisas

Você pode bufferizar por exemplo, o resultado de uma consulta do banco de dados, assim seu PDF terá um conteúdo dinâmico.

O sr. Janes havia me fornecido um exemplo com uma consulta bem completa e o PDF gerado tinha o valor de relatório formatado para saída de impressora, mas isso não foi o mais impressionante.

Percebi que, além de incluir as imagens que eram linkadas no html gerado, o relatório tinha o poder de interpretar as folhas de estilo CSS.

Ele fez a seguinte mágica:

<?php
session_start();
header("Content-type: text/html; charset=iso-8859-1");
ob_start(); // Inicia o fluxo
?>

<!-- tables, DIVs, consultas no banco de dados, blablabla, imagens e todo o conteudo PHP com HTML -->

<?php
ob_end_clean(); // Finaliza o fluxo
define('_MPDF_PATH', 'classes/mpdf411/');
include(_MPDF_PATH.'mpdf.php');

// cria um novo container PDF no formato A4 com orientação customizada
$mpdf=new mPDF('pt','A4',3,'',8,8,5,14,9,9,'P');

// muda o charset para aceitar caracteres acentuados iso 8859-1 utilizados por mim no banco de dados e na geracao do conteudo PHP com HTML
$mpdf->allow_charset_conversion=true;
$mpdf->charset_in='iso-8859-1';

//Algumas configurações do PDF
$mpdf->SetDisplayMode('fullpage');
// modo de visualização
$mpdf->SetFooter('{DATE j/m/Y&nbsp; H:i}|{PAGENO}/{nb}|SEDUC / SIGETI');
//bacana este rodape, nao eh mesmo?

// carrega uma folha de estilo - MAGICA!!!
$stylesheet = file_get_contents('./stylesheets/estilosPDF.css');

// incorpora a folha de estilo ao PDF
// O parâmetro 1 diz que este é um css/style e deverá ser interpretado como tal
$mpdf->WriteHTML($stylesheet,1);

// incorpora o corpo ao PDF na posição 2 e deverá ser interpretado como footage. Todo footage é posicao 2 ou 0(padrão).
$mpdf->WriteHTML($html,2);

// define um nome para o arquivo PDF
$arquivo = date("ymdhis").'_projeto_li.pdf';

// gera o relatório
$mpdf->Output($arquivo,'D');

exit();

?>

chorei… Muito bom mesmo!

Quem quiser se aprofundar ainda mais, pode dar uma olhada no Manual do mPDF, que é bem completo e cheio de truques.

Agradeço ao Janes pela dica e vamos continuar estudando essa classe para aprender mais novidades.

um abraço e até a próxima.