Wprowadzenie

Hoje em dia já não me vejo programando sem usar o Composer. Ele te permite gerenciar de forma consistente inúmeros módulos/scripts criados por terceiros e que estão disponíveis em https://packagist.org/.

Com o Composer você pode não apenas instalar e atualizar pacotes facilmente, mas também manter sincronizado automaticamente quaisquer dependências com outros pacotes utilizados na aplicação. Além disto, já tem prontinho o autoload, permitindo carregar suas classes PHP sem necessidade de fazer include/require.

Mas este não é um Post sobre Composer :P Vamos ver como instalar e executar o mPDF, uma biblioteca PHP para gerar PDF utilizando-se de código HTML. The mPDF tem lá seus contras, mas o interessante é que você basicamente precisa apenas montar seu HTML e com mínimo esforço já terá condições de convertê-lo para PDF.

Problem

Ao que parece, nas novas versões, é preciso do Composer para instalar o mPDF. Tak, o recomendado é que você de fato passe a usar o Composer em sua atividade de desenvolvimento.

Daí vem a pergunta: e se eu não tiver como instalar o Composer no servidor? W takim przypadku, vamos utilizar de uma artifício: instalar o Composer localmente e então subir (upload) para o Servidor a pasta “Vendor“. Nestas condições seu Composer vai ficar parcialmente inoperante, mas ainda assim vai tornar possível o uso do mPDF.

Rozwiązanie

A instalação do mPDF pelo Composer é muito simples. Vá ao site https://getcomposer.org/download/, baixe e instale o Composer.

Uma vez que tenha o Composer instalado, basta abrir o Terminal (command) e acessar o diretório da sua aplicação (dentro de www/ ou htdocs/, na przykład), e então rodar o seguinte comando:

$ kompozytor require MPDF/MPDF

Note que na raiz do diretório da sua aplicação será criado uns arquivos, como composer.json i composer.lock, bem como o diretório “Vendor/“. Agora ficou fácil! Você já tem tudo que precisa para seu mPDF funcionar.

Pegue a pasta Vendor e envie para o seu Servidor. De preferência, coloque-a na raiz e crie um arquivo index.php (também na raiz) para testarmos o mPDF contendo o seguinte código:

1
2
3
4
5

<?PHP
require_once __DIR__ . '/vendor/autoload.php';
$MPDF = Nowy mPDF();
$MPDF->WriteHTML('<h1>Hello world!</h1>');
$MPDF->Output();

To zrobione, se tudo der certo, irá aparecer um PDF escrito “Hello World!“.

Raporty w formacie PDF z PHP

Relatório não é a finalidade deste Post, mas aproveito para registrar algo mais. Se você precisa gerar relatórios, uma opção é embutir seu CSS/HTML no arquivo PHP e então passar o código para o mPDF fazer o trabalho duro, assim por exemplo (Ver saída na Figura 1 poniżej):

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

<?PHP
require_once __DIR__ . '/vendor/autoload.php';
ob_start();
?>
<styl>
    stół, th, TD {
        granica: 1px solid black;
        border-collapse: collapse;
        dopełnienie: 5PX;
    }               
    table tr:n dziecko(Odd) {
      kolor tła: #eee;
    }  
    table tr:n dziecko(nawet) {
      kolor tła: #FFF;
    }   
    table thead th {
      kolor tła: #CCC;
    } 
    table tfoot td {
      kolor tła: #CCC;
    } 
</styl> 
<h1>Meu Relatório</h1>
<table align="center">
    <THEAD>
        <TR>
            <th>Nazwa</th>
            <th>Wiek</th>
            <th>Adres e-mail</th>
        </TR>
    </THEAD>
    <tfoot>
        <TR>
            <td colspan="3" align="center">Copyright ® 2017</TD>
        </TR>
    </tfoot>>    
    <TBODY>
        <TR>
            <TD>Taylor</TD>
            <td align="center">43</TD>
            <TD >taylor@amail.com</TD>
        </TR>
        <TR>
            <TD>Portela</TD>
            <td align="center">47</TD>
            <TD>portela@bmail.com</TD>
        </TR>        
    </TBODY>
</stół>
<?PHP
$HTML = ob_get_contents();
$MPDF = Nowy mPDF;
$MPDF->WriteHTML($HTML);
$MPDF->Output();

Fig. 1 – Arquivo PDF de saída referente à injeção de código CSS/HTML (powyżej) processado pelo mPDF

Obviamente você pode estruturar melhor o código colocando o CSS/HTML em um arquivo de template separado e carregá-lo para dentro da chamada do mPDF.

W każdym razie, agora é com você! Dê uma lida no Manual do mPDF e fique por dentro da forma de uso e compatibilidades.