silny.eu

Nedávno jsem při pátrání po nějakém šikovném generátoru PDF narazil na velmi zajímavou knihovnu – wkhtmltopdf. Zaujala mě svou jednoduchostí a přesností převodu html výstupu do PDF natolik, že jsem se rozhodl použít ji v několika sých projektech.

Abych nechodil daleko, integrace do tolik mnou oblíbeného Kohana frameworku je tak jednoduchá a přímá, že se sní zde pochlubím. Wkhtmltopdf převádí html kód do PDF. Knihovna je spustitelný binár a vlastní převod se volá například takto:

wkhtmltopdf http://www.nejaka-domena/prevadena-stranka.html

případně

wkhtmltopdf /cesta/k/html/souboru.html.

… tedy přinejmenším voláme alespoň s jedním parametrem – převáděným souborem. Seznam všech parametrů lze najít na code.google.com. V adresáři application/vendor vytvoříme adresář například “pdf_export”, do kterého uložíme obslužnou třídu pro volání knihovny. Nebudu uvádět žádný příklad, snad jen doporučení, že tato třída by měla zařídit vlastní převod a měla by manipulovat se soubory. Řekněme, že skript se bude jmenovat “wkhtmltopdf.php” a třída v něm “wkhtmltopdf”. Integrace v controlleru pak vypadá například takto:

require Kohana::find_file('vendor','pdf_export/wkhtmltopdf',$required=TRUE,$ext='php');

$this->pdf = new wkhtmltopdf;

Převáděnou stránku si připravíme tak, že v použitém controlleru necháme View zpracovat, ale nevypíšeme jej na výstup, ale uložíme si jej do proměnné. Tedy pouze

$vygenerovane_html = $view->render();

V proměnné “$vygenerovane_html” tedy máme celý html výstup. V tento okamžik je vhodné předat jej naší obslužné třídě “wkhtmltopdf” a provést vlastní konverzi do PDF. Tato třída nám může pak vygenerované PDF vrátit (fread() apod) a my jej můžeme poslat na výstup s patřičnými hlavičkami jako download:

$file = $this->save_html_to_file($vygenerovane_html);
$pdf_soubor = $this->pdf->file_convert($file,'/tmp/');

header("Cache-Control: must-revalidate, post-check=0, pre-check=0");
header('Content-Description: File Transfer');
header('Content-Type: application/octet-stream');
header('Content-Disposition: attachment; filename='.$filename);

echo $pdf_soubor;

Metoda “save_html_to_file()” v mém případě slouží k uložení html výstupu do lokálního souboru, metoda “file_convert()” třídy “pdf” pak k vlastní konverzi a načtení vygenerovaného PDF do proměnné “$pdf_soubor”. Echo nakonec pak po odeslání hlaviček pošle PDF soubor prohlížeči.