WordPress-sivuston sisällöstä (kuten laskuista, tilausvahvistuksista, lipuista tai raporteista) voidaan muodostaa PDF-tiedostoja usealla eri tavalla. Oikea toteutustapa riippuu siitä, kuinka monimutkaista ulkoasua tarvitaan ja kuinka paljon PDF-tiedostoja luodaan samanaikaisesti:
Selainpuolen tulostus (
@media printja JavaScript): Kevyin ratkaisu, joka ei kuormita palvelinta lainkaan.PHP-pohjaiset PDF-kirjastot ja lisäosat: Suositeltu palvelinpuolen ratkaisu vakiomuotoisille dokumenteille, kuten laskuille ja kuiteille.
Ulkoiset PDF-rajapinnat (API): Paras vaihtoehto monimutkaisille HTML/CSS-asetteluille ja suurille volyymeille, jotta raskas renderöinti ei kuormita sivuston omaa palvelinta.
Node.js-pohjaiset työkalut (varauksin): Käytettävissä komentoriviltä, mutta headless-selainten ajaminen suoraan sivustokontissa ei ole suositeltavaa resurssirajoitteiden vuoksi.
Selainpuolen PDF-tulostus (@media print ja JavaScript)
Jos käyttäjän tarvitsee vain tallentaa tai tulostaa sivu PDF-muotoon omalla laitteellaan, palvelinpuolen renderöintiä ei tarvita. Voit määritellä sivuston tyylitiedostoon omat tulostustyylit (@media print), joilla piilotat navigaation ja muut ylimääräiset elementit:
@media print {
header, nav, footer, .no-print {
display: none !important;
}
body {
font-size: 12pt;
color: #000;
background: #fff;
}
}
Tulostusikkunan voi avata sivulla suoraan JavaScript-kutsulla window.print(). Jos PDF-tiedosto täytyy muodostaa ja ladata tiedostona suoraan selaimessa ilman tulostusikkunaa, voit hyödyntää selainpuolen JavaScript-kirjastoja (kuten jsPDF tai pdfmake).
Headless-selaimet ja Node.js Seravon ympäristössä
Palvelussa ei valitettavasti ole esiasennettuna järjestelmätason Chrome- tai Chromium-selainta.
Vaikka ympäristössä on valmiina Node.js ja npm, emme suosittele raskaita headless-selaimia (kuten Puppeteer tai Playwright) asentavien pakettien ajamista suoraan sivustokontissa seuraavista syistä:
Levytila ja muisti: Mukana ladattavat selainbinäärit vievät satoja megatavuja levytilaa, ja selaimen käynnistäminen kuluttaa runsaasti keskusmuistia (RAM), mikä voi ruuhkauttaa sivuston muut prosessit.
Käyttöjärjestelmäriippuvuudet: Kevyistä konttiympäristöistä voi puuttua graafisia järjestelmäkirjastoja, joita selainbinäärit vaativat toimiakseen, eikä niitä voi asentaa ilman pääkäyttäjän (
sudo) oikeuksia.
Käytä palvelinpuolen PDF-luontiin ensisijaisesti PHP-kirjastoja (Dompdf, mPDF) tai ulkoista Chromium-pohjaista API-palvelua (kuten Gotenberg).
PHP-pohjaiset PDF-kirjastot ja WordPress-lisäosat
Rakenteellisten dokumenttien, kuten verkkokaupan laskujen ja pakkauslistojen, luomiseen kannattaa käyttää suoraan PHP-pohjaisia kirjastoja tai valmiita WordPress-lisäosia (kuten WooCommerce PDF Invoices & Packing Slips).
Nykyaikaiset, Composerilla asennettavat PHP-kirjastot toimivat Seravon ympäristössä suoraan ilman erillisiä palvelinmuutoksia:
dompdf/dompdf: Muuntaa HTML- ja CSS-koodia PDF-muotoon. Tukee hyvin perustason CSS-tyylejä.mpdf/mpdf: Monipuolinen HTML-to-PDF-kirjasto, jossa on vahva tuki eri merkistöille, ylätunnisteille ja sivunumeroinnille.setasign/fpdf: Erittäin kevyt ja nopea kirjasto, kun PDF rakennetaan ohjelmallisesti koordinaattien avulla ilman HTML-jäsennystä.
Esimerkki PDF-tiedoston luomisesta ja lähettämisestä selaimeen Dompdf-kirjastolla:
<?php
use Dompdf\Dompdf;
$dompdf = new Dompdf();
$dompdf->loadHtml( '<h1>Tilausvahvistus</h1><p>Kiitos tilauksestasi!</p>' );
$dompdf->setPaper( 'A4', 'portrait' );
$dompdf->render();
// Lähetä PDF ladattavaksi selaimeen
$dompdf->stream( 'tilausvahvistus.pdf', array( 'Attachment' => true ) );
Ulkoiset PDF-rajapinnat (API)
Jos sivusto luo suuria määriä PDF-tiedostoja tai dokumenttien ulkoasu vaatii nykyaikaista selainrenderöintiä (kuten CSS Grid-, Flexbox- tai JavaScript-kaavioita), raskas renderöinti kannattaa ulkoistaa erilliselle API-palvelulle (esimerkiksi avoimen lähdekoodin Gotenberg tai kaupalliset palvelut kuten Browserless ja PDFShift).
Ulkoinen rajapinta vastaanottaa HTML-sisällön tai sivun osoitteen HTTP-pyyntönä ja palauttaa valmiin PDF-tiedoston kuormittamatta WordPress-palvelimen muistia, levytilaa tai PHP-työntekijöitä.
WordPress-mediakirjaston PDF-esikatselukuvat
Kun lataat PDF-tiedoston WordPressin mediakirjastoon, WordPress muodostaa tiedoston ensimmäisestä sivusta automaattisesti esikatselukuvan.
Toiminto ei käytä HTML-muunnosta, vaan muuntaa PDF-sivun kuvatiedostoksi palvelimen ImageMagick (imagick) - ja Ghostscript-kirjastojen avulla. Seravon ympäristössä nämä kirjastot ovat valmiiksi asennettuna, joten PDF-esikatselukuvat toimivat oletuksena ilman erillistä käyttöönottoa.
Vältettävät ja vanhentuneet työkalut
wkhtmltopdf: Työkalun kehitys on päättynyt ja sen virallinen arkisto on suljettu (2023). Se käyttää vanhentunutta selainmoottoria, joka ei tue nykyaikaista CSS:ää ja voi aiheuttaa vakavia tietoturvariskejä (SSRF), jos sille syötetään käyttäjän muokkaamaa HTML-koodia. Käytä sen sijaan moderneja PHP-kirjastoja tai ulkoista Chromium-pohjaista API-palvelua.
Yleisimmät virhetilanteet
PDF-generointi kaatuu muistivirheeseen (
Allowed memory size exhausted) tai aikakatkaisuun: Suurten HTML-taulukoiden tai korkearesoluutioisten kuvien muuntaminen PDF-muotoon vie paljon muistia. Pienennä PDF-pohjassa käytettävien kuvien tiedostokokoa, yksinkertaista HTML-rakennetta tai siirrä generointi tausta-ajoon.Kuvat tai fontit puuttuvat palvelimella luodusta PDF-tiedostosta: PHP-pohjaiset kirjastot (kuten
Dompdf) estävät oletuksena ulkoisten URL-osoitteiden lataamisen tietoturvasyistä (isRemoteEnabled). Käytä kuvissa palvelimen paikallisia tiedostopolkuja (/data/wordpress/htdocs/...) tai ota etäresurssit hallitusti käyttöön kirjaston asetuksissa.Node.js-pohjainen PDF-generointi (esim. Puppeteer) epäonnistuu puuttuviin kirjastoihin tai muistivirheeseen: Sivustokontti on optimoitu PHP-suoritukseen, eikä siinä ole kaikkia täyden työpöytäselaimen vaatimia järjestelmäkirjastoja tai muistivaraa raskaaseen selainrenderöintiin. Siirrä HTML-to-PDF-renderöinti joko PHP-kirjastolle (
Dompdf/mPDF) tai ulkoiselle API-palvelulle.Mediakirjasto ei luo esikatselukuvaa ladatusta PDF-tiedostosta: Varmista, ettei PDF-tiedosto ole salasanasuojattu tai vioittunut. Tarkista mahdolliset virheilmoitukset lokista
/data/log/php-error.log.
Katso myös
Oikein valittu PDF-toteutus varmistaa laadukkaan lopputuloksen ilman, että sivuston suorituskyky kärsii raskaista taustaprosesseista. Mikäli tarvitset apua PDF-työkalujen käytössä tai muistirajoitusten selvittämisessä, asiakaspalvelumme auttaa osoitteessa [email protected].
