ಪರಿಚಯ

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. ಇದರ ಜೊತೆಗೆ, 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. ದಿ 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.

ಸಮಸ್ಯೆಯನ್ನು

Ao que parece, nas novas versões, é preciso do Composer para instalar o mPDF. ಆದ್ದರಿಂದ, 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? ಈ ಸಂದರ್ಭದಲ್ಲಿ, 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.

ಪರಿಹಾರ

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/, ಉದಾಹರಣೆಗೆ), e então rodar o seguinte comando:

$ ಸಂಯೋಜಕ require mpdf/mpdf

Note que na raiz do diretório da sua aplicação será criado uns arquivos, como composer.json ಇ 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

<?ಪಿಎಚ್ಪಿ
require_once __DIR__ . '/vendor/autoload.php';
$mpdf = ಹೊಸ mPDF();
$mpdf->WriteHTML('<h1>Hello world!</h1>');
$mpdf->Output();

ಮಾಡಲಾಗುತ್ತದೆ ಈ, se tudo der certo, irá aparecer um PDF escrito “Hello World!“.

ಪಿಎಚ್ಪಿ ಜೊತೆ PDF ವರದಿಗಳು

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 ಪಿಎಚ್ಪಿ e então passar o código para o mPDF fazer o trabalho duro, assim por exemplo (Ver saída na Figura 1 ಕೆಳಗಿನ):

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

<?ಪಿಎಚ್ಪಿ
require_once __DIR__ . '/vendor/autoload.php';
ob_start();
?>
<ಶೈಲಿ>
    ಟೇಬಲ್, ನೇ, ಟಿಡಿ {
        border: 1px solid black;
        border-collapse: collapse;
        padding: 5px;
    }               
    table tr:ಎನ್ತ್ ಶಿಶು(ಬೆಸ) {
      ಹಿನ್ನೆಲೆ ಬಣ್ಣ: #eee;
    }  
    table tr:ಎನ್ತ್ ಶಿಶು(ಸಹ) {
      ಹಿನ್ನೆಲೆ ಬಣ್ಣ: #fff;
    }   
    table thead th {
      ಹಿನ್ನೆಲೆ ಬಣ್ಣ: #CCC;
    } 
    table tfoot td {
      ಹಿನ್ನೆಲೆ ಬಣ್ಣ: #CCC;
    } 
</ಶೈಲಿ> 
<h1>Meu Relatório</h1>
<table align="center">
    <THEAD>
        <ಅನುವಾದ>
            <ನೇ>ಹೆಸರು</ನೇ>
            <ನೇ>ವಯಸ್ಸಿನ</ನೇ>
            <ನೇ>ಮೇಲ್</ನೇ>
        </ಅನುವಾದ>
    </THEAD>
    <tfoot>
        <ಅನುವಾದ>
            <td colspan="3" align="center">Copyright ® 2017</ಟಿಡಿ>
        </ಅನುವಾದ>
    </tfoot>>    
    <TBODY>
        <ಅನುವಾದ>
            <ಟಿಡಿ>ಟೇಲರ್</ಟಿಡಿ>
            <td align="center">43</ಟಿಡಿ>
            <ಟಿಡಿ >taylor@amail.com</ಟಿಡಿ>
        </ಅನುವಾದ>
        <ಅನುವಾದ>
            <ಟಿಡಿ>Portela</ಟಿಡಿ>
            <td align="center">47</ಟಿಡಿ>
            <ಟಿಡಿ>portela@bmail.com</ಟಿಡಿ>
        </ಅನುವಾದ>        
    </TBODY>
</ಟೇಬಲ್>
<?ಪಿಎಚ್ಪಿ
$ಎಚ್ಟಿಎಮ್ಎಲ್ = ob_get_contents();
$mpdf = ಹೊಸ mPDF;
$mpdf->WriteHTML($ಎಚ್ಟಿಎಮ್ಎಲ್);
$mpdf->Output();

Fig. 1 – Arquivo PDF de saída referente à injeção de código CSS/HTML (acima) 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.

ಅಂತಿಮವಾಗಿ, agora é com você! Dê uma lida no Manual do mPDF e fique por dentro da forma de uso e compatibilidades.