Převod souboru PHP do PDF

Kopie s pevným rozvržením je potřebná, když je stránku vygenerovanou pomocí PHP nutné vytisknout, odeslat, sdílet nebo archivovat. Samotný zdrojový kód PHP je nutné buď spustit, aby se stránka vygenerovala, nebo jej naformátovat jako kód; běžný file converter jej přímo nevykreslí do hotového PDF.

Co je formát PHP

PHP je skriptovací jazyk na straně serveru, který weboví vývojáři a administrátoři používají k vytváření dynamických stránek, formulářů, faktur, sestav a odpovědí API. Soubor .php obsahuje zdrojový kód, obvykle smíšený s HTML, CSS, SQL nebo template markup; PHP je programovací jazyk, nikoli formát dokumentu.

Webový server s podporou PHP soubor interpretuje a do prohlížeče vrací vygenerovaný výstup, obvykle HTML. Otevření souboru .php ze správce souborů nespustí jeho kód na straně serveru: v závislosti na operačním systému a aplikaci se může zobrazit zdrojový text nebo se soubor nemusí načíst.

Co je formát PDF

PDF je formát dokumentu s pevným rozvržením, který zachovává rozměry stránek, písma, obrázky, mezery a stránkování napříč operačními systémy a zařízeními. Příjemci jej mohou vytisknout nebo zobrazit bez PHP, webového serveru či aplikace, ve které byla původní stránka vytvořena.

PDF se hodí pro faktury, oficiální podání, e-mailové přílohy a archivní kopie. Obvykle není určeno k úpravám jako soubor textového procesoru a převod nezaručuje menší velikost souboru; vložená písma a obrázky mohou jeho velikost zvětšit.

Převod vygenerované stránky PHP

Tuto metodu použijte, když požadované PDF představuje sestavu, účtenku, formulář nebo jinou stránku vytvořenou skriptem.

1. Nainstalujte PHP a v případě potřeby místní serverový balíček, například XAMPP, Laragon nebo MAMP. Vestavěný server PHP je pro mnoho samostatných projektů dostačující.
2. Umístěte projekt do jeho adresáře dokumentů a nakonfigurujte požadované databáze, proměnné prostředí, rozšíření, vložené soubory a složky s povoleným zápisem.
3. Z příslušného adresáře projektu nebo document-root spusťte php -S localhost:8000. Příkaz spustí vývojový server; nejde o nasazení do produkčního prostředí.
4. Otevřete příslušnou adresu, například http://localhost:8000/report.php, v prohlížeči Chrome, Edge nebo Firefox a ověřte, že stránka obsahuje očekávaná data.
5. V prohlížeči použijte Print → Save as PDF. Vyberte požadovanou velikost papíru a okraje, pokud je návrh používá, povolte grafiku na pozadí a v náhledu tisku zkontrolujte zalomení stránek, obrázky, záhlaví a zápatí.

Pro opakovaně generovaný výstup na straně serveru použijte workflow s headless Chromium prostřednictvím Playwright nebo Puppeteer a jejich funkcí PDF. Použijte stejný tiskový CSS, viewport, formát papíru, okraje a podmínky načítání stránky jako v produkčním prostředí; před vytvořením PDF počkejte na síťové požadavky a obsah vykreslený pomocí JavaScriptu.

Pokud je stránka již dostupná jako HTML, mohou služby jako PDFCrowd nebo CloudConvert poskytovat převod HTML-to-PDF. Nahrajte vygenerované HTML, nikoli původní soubor .php: tyto služby obecně nespouštějí libovolné PHP a nemusí mít přístup k externím stylům, písmům, obrázkům, relacím ani autentizovaným datům.

Převod zdrojového kódu PHP

Tuto metodu použijte, když je dokumentem samotný zdrojový kód, například pro kontrolu kódu, výukové materiály nebo tištěný záznam.

1. Otevřete soubor v editoru kódu, například PhpStorm, Notepad++ nebo Visual Studio Code, a zapněte zvýrazňování syntaxe PHP.
2. Nastavte čitelné neproporcionální písmo, vhodné okraje, zalamování řádků a případně čísla řádků. Pokud je důležitější zachovat přesné řádky zdrojového kódu než vměstnat kód na stránku, zalamování zakažte.
3. Vytiskněte soubor z editoru, který podporuje tisk, například Notepad++ nebo PhpStorm, a zvolte systémovou PDF tiskárnu: Microsoft Print to PDF v systému Windows nebo Save as PDF v tiskovém dialogu macOS. Visual Studio Code může vyžadovat rozšíření pro tisk nebo mezikrok v podobě exportu HTML.

Pro automatizované PDF zdrojového kódu použijte Pygments nebo podobný formatter ke zvýraznění syntaxe, výsledek exportujte jako HTML a toto HTML vytiskněte prostřednictvím Chromium. Tím zdokumentujete zdrojový text; PHP se nespustí a nezachytí se stránka vygenerovaná skriptem.

Generování PDF v aplikaci PHP

Pro opakované faktury, sestavy nebo formuláře může aplikace PHP vytvářet PDF z templates pomocí knihoven, jako jsou Dompdf, mPDF nebo TCPDF. Jde o generování PDF, nikoli převod souboru, a vyžaduje kód, instalaci závislostí, přípravu šablony a testování podpory CSS.

Omezení kvality a zabezpečení

Autentizace, výsledky databáze, chybějící rozšíření PHP, oprávnění, relativní cesty, externí CSS, webová písma, JavaScript a tiskový CSS prohlížeče mohou změnit vykreslený výsledek. Testujte s reprezentativními daty, ověřte obrázky a zalomení stránek a porovnejte PDF se stránkou na zamýšlené URL.

Nenahrávejte důvěrný zdrojový kód PHP, přihlašovací údaje, zákaznická data ani soukromé vygenerované stránky do online converteru. Místní prohlížeč, proces headless Chromium nebo PDF knihovna pro PHP zabrání odhalení těchto souborů a umožní přístup k místním závislostem. Ze zdrojových PDF odstraňte tajné údaje a zkontrolujte, zda vygenerovaná PDF neobsahují nezamýšlená metadata nebo skrytá data formulářů.