Ab sofort gibt es bei Servivum Gotenberg, einen dedizierten PDF-Konvertierungsservice, der direkt neben eurer App läuft.

Wer in seiner Anwendung Rechnungen, Berichte oder Belege als PDF erzeugt, kennt den Aufwand: wkhtmltopdf oder Puppeteer installieren, Schriften einrichten und das Ganze bei jedem Update am Laufen halten. Das übernehmen wir jetzt für euch, und eure PDFs entstehen ohne externe Dienste.

Was ist Gotenberg?

Gotenberg ist ein quelloffener API-Server, der verschiedene Dateiformate in PDFs umwandelt. Ihr schickt per HTTP-Anfrage HTML, Markdown oder Office-Dokumente an die API und bekommt ein fertiges PDF zurück.

Der Service läuft im Hintergrund neben eurer App und ist ausschließlich intern erreichbar, nicht über das Internet.

Einrichten

Beim Erstellen oder Bearbeiten einer App findet ihr die Option Gotenberg (PDF-Konvertierung). Aktiviert sie, und der Service wird automatisch neben eurer App bereitgestellt.

Innerhalb eurer App ist die API danach unter dieser Adresse erreichbar:

http://gotenberg

Der Port ist 80, eine Authentifizierung ist nicht nötig. Weitere Informationen findet ihr auf der Gotenberg-Seite im App-Dashboard.

Beispiel: HTML zu PDF

Eine einfache Anfrage aus einer PHP-Anwendung mit Guzzle:

$response = $client->post('http://gotenberg/forms/chromium/convert/html', [
    'multipart' => [
        [
            'name'     => 'files',
            'contents' => '<html><body><h1>Rechnung #1234</h1></body></html>',
            'filename' => 'index.html',
        ],
    ],
]);

file_put_contents('rechnung.pdf', $response->getBody());

Beispiel: Office-Dokument zu PDF

$response = $client->post('http://gotenberg/forms/libreoffice/convert', [
    'multipart' => [
        [
            'name'     => 'files',
            'contents' => fopen('vorlage.docx', 'r'),
            'filename' => 'vorlage.docx',
        ],
    ],
]);

Über LibreOffice werden .docx, .xlsx, .pptx, .odt und viele weitere Formate unterstützt. Die vollständige API-Dokumentation findet ihr unter gotenberg.dev/docs.

Kosten

Gotenberg kostet 6,00 € netto pro Monat zusätzlich zum gewählten App-Tarif.

Probiert es gern bei euren Projekten aus. Bei Fragen oder Feedback schreibt uns an support@servivum.com.

Viel Spaß beim PDF-Erzeugen ✨

Bild von Valeria Reverdo