Após um bom tempo sem artigos, estou de volta!

A tarefa de criar documentos PDF sempre foi uma “pedra no sapato” de qualquer programador PHP, haja vista que era um processo trabalhoso, que exige testes e mais testes de posicionamento e ainda sim não se chegava a um resultado satisfatório.

Para sanar esse problema, foi criada uma classe chamada fpdf, que por si só já nos era muito útil com seus métodos para estilização de texto e alguns outros recursos. Mas ainda não era o suficiente, pois a formatação e quebra de linhas ainda eram difíceis.

Surgiu então a classe html2fpdf que, na minha opinião, resolveu o problema, pois agora poderíamos estilizar um código html (com algumas limitações, é claro) e gerar o PDF com base nele.

Como atualmente utilizo Zend Framework, resolvi reunir as vantagens das classes acima em um Action Helper:

<?php
/**
 * Action Helper para gerar PDF a partir de HTML usando HTML2PDF
 * 
 * @uses Zend_Controller_Action_Helper_Abstract
 * @uses HTML2FPDF (http://html2fpdf.sourceforge.net)
 * @uses FPDF (www.fpdf.org)
 *
 * @author Rubens Gadelha
 *
 * @param string $html
 * @param 'I'|'D'|'F'|'S' $dest
 *
 * Saidas:
 * I: Envia para a saída padrão
 * D: Download do arquivo
 * F: Salva em um arquivo local
 * S: Retorna como string
 */
 
class Zend_Controller_Action_Helper_Html2Pdf extends Zend_Controller_Action_Helper_Abstract
{
    public function direct($html, $output, $dest = 'D')
    {
		$pdf = new HTML2FPDF();
		$pdf->AddPage();
		$pdf->WriteHTML(utf8_decode($html));
		$pdf->Output($output, $dest);
    }
}
?>

Para utilizá-lo, é muito fácil:

1. Salve o código acima em um arquivo chamado Html2Pdf.php na pasta helpers do seu projeto;

2. Faça o download do html2fpdf aqui;

3. Descompacte-o dentro da pasta library do seu projeto;

4. Inclua essa pasta no include_path que, geralmente está configurado no arquivo de bootstrap:

<?php
set_include_path('.' . PATH_SEPARATOR . '../library/'
                     . PATH_SEPARATOR . '../application/default/models/' 
                     . PATH_SEPARATOR . get_include_path()
                     // inclua a linha abaixo
                     . PATH_SEPARATOR . '../library/html2fpdf/');
?>

5. No Controller, insira a linha abaixo na ação onde você deseja gerar o PDF:

<?php
// Desabilita o layout
$this->_helper->layout->disableLayout();
// Gera o PDF
$this->_helper->html2Pdf($html, $file, 'D'); 
// Evita que o arquivo busque a respectiva view
exit;
?>

Onde:
$html é o código base para geração do arquivo
$file é o nome do arquivo
‘D’ é um parâmetro que força o download do arquivo.

Os parâmetros possíveis são:
I: Envia para a saída padrão
D: Download do arquivo
F: Salva em um arquivo local
S: Retorna como string

Para mais detalhes sobre código html compatível, acesse a página do html2fpdf.

Para enviar mensagens ao usuário em uma nova requisição, você deverá fazer uso de um helper chamado FlashMessenger, que, por sua vez, utiliza a classe Zend_Session para passar a mensagem à diante, removendo-a logo em seguida.

Segue um exemplo de uso desse helper:

class ExemploController extends Zend_Controller_Action
{
    protected $_flashMessenger = null;
 
    public function init()
    {
        // Coloca o helper na variável de instância _flashMessenger
        $this->_flashMessenger = $this->_helper->getHelper('FlashMessenger');
        $this->initView();
    }
 
    public function atualAction()
    {
        // O método addMessage() adiciona uma mensagem
        $this->_flashMessenger->addMessage('Dados salvos com sucesso!');
    }
 
    public function proximaAction()
    {
        // O método getMessages() retorna um Array com as mensagens
        $this->view->mensagens = $this->_flashMessenger->getMessages();
    }
}

Na view, você terá todas as mensagens em $this->mensagens

Para iniciar o uso do Dojo com em sua aplicação com Zend, baixe o pacote do Dojo Toolkit e descompacte-o na sua pasta public, no diretório de javascripts. Se você estiver utilizando a estrutura de diretórios do Zend Studio, ficará assim:

Repare que o pacote é composto por três pastas: dijit, dojo e dojox.

Dojo: É o core do framework, possui todas as funções de Ajax, seleção de elementos por CSS, utilitários de linguagem, JSON entre várias outras.

Dijit: Conjunto de widgets com os quais poderão ser criadas interfaces web 2.0 bastante interessantes. Se você não quiser utilizar os estilos prontos (skins), poderá criar o seu facilmente. Exemplos de widgets: paleta de cores, barras de status, janelas e alertas personalizados, campos de formulários personalizados e muito mais!

Dojox: Pacote de extensões para o Dojo, como gráficos e ferramentas de desenho.

Feito isso, iremos habilitá-lo no header do nosso layout (no meu caso, main.phtml):

<?php
// Checa se o Dojo está ativo no Zend Framework
if ($this->dojo()->isEnabled()) {
  // Configura o caminho para o arquivo do core do dojo
  $this->dojo()->setLocalPath($this->baseUrl().'/scripts/dojo/dojo.js')
  // Configura alguns parâmetros opcionais do Dojo
  // como parse após o carregamento da página
  // e configuração dos idiomas padrão
  ->setDjConfig(array(
    'parseOnLoad' => true,
    'extraLocale' => array('pt-br', 'en-us')
  ))
  // Seleciona o tema 'tundra'
  ->addStyleSheetModule('dijit.themes.tundra');
}
?>
<?php dojo()->javascriptCaptureStart() ?>
  // Se você desejar criar funções javascript extras,
  // deverá colocá-las aqui
<?php dojo()->javascriptCaptureEnd() ?>
 
<?php
// Insere as configurações acima no html
echo $this->dojo();
?>

Agora, na tag header, insira a classe relacionada à skin que você selecionou:

<body class="tundra">

Pronto! Agora você poderá utilizar as funções do Dojo normalmente, mas fique atento: alguns recursos requerem configurações adicionais.