Inhaltsverzeichnis

  1. Einführung

  2. Häufige Symptome von PDF-Anzeigeproblemen

  3. Wie Dolibarr PDF-Dokumente generiert

  4. Wichtige Module für die PDF-Erstellung

  5. Bestätigen Ihrer Dolibarr-Version und PHP-Kompatibilität

  6. Serveranforderungen und PDF-Abhängigkeiten

  7. Häufige Ursachen für Fehler beim PDF-Rendering

  8. Überprüfen auf Probleme mit der PHP-Bibliothek (TCPDF/FPDF)

  9. Diagnostizieren von Dateiberechtigungsproblemen

  10. Beschädigte oder fehlende PDF-Vorlagendateien

  11. Fehlerprotokolle: So finden und interpretieren Sie sie

  12. Beheben des Problems „Weißer Bildschirm“ oder leere PDF-Ausgabe

  13. Probleme mit benutzerdefinierten oder Drittanbieter-PDF-Vorlagen

  14. Beheben von Problemen nach einem Dolibarr-Update oder einer Migration

  15. Empfohlene PHP-Einstellungen für die PDF-Generierung

  16. TCPDF manuell aktualisieren (falls erforderlich)

  17. Verwenden des Dolibarr-Debug-Modus zum Identifizieren von Fehlern

  18. Neuinstallation oder Reparatur des PDF-Kernmoduls

  19. Verwenden von Systemdienstprogrammen zum Testen der PDF-Ausgabe außerhalb von Dolibarr

  20. Fazit und langfristige Best Practices

1. Einleitung

Wenn Ihre PDF-Dateien in Dolibarr nicht mehr wie erwartet angezeigt werden – ob in Rechnungen, Angeboten, Lieferscheinen oder Kostenvoranschlägen – sind Sie nicht allein. Probleme bei der PDF-Generierung gehören zu den häufigsten Supportanfragen in Dolibarr-Foren, insbesondere nach Systemupdates oder Migrationen.

Dieser Leitfaden führt Sie durch die Identifizierung und Lösung der Grundursachen von PDF-Rendering-Problemen in Dolibarr ERP, wobei ein besonderer Schwerpunkt auf den im Jahr 2025 beobachteten Änderungen liegt.

2. Häufige Symptome von PDF-Anzeigeproblemen

  • Klicken auf "PDF generieren" bewirkt nichts

  • Weißer Bildschirm bei der PDF-Generierung

  • Die Datei wird heruntergeladen, ist aber beschädigt oder leer

  • Fehlermeldung wie „TCPDF-Fehler“ oder „Datei kann nicht geöffnet werden“

  • In generierten PDFs wird nur ein Teil des Inhalts angezeigt

3. Wie Dolibarr PDF-Dokumente generiert

Dolibarr verwendet PHP-basierte Bibliotheken (hauptsächlich TCPDF), um dynamische PDF-Inhalte für Module wie die folgenden zu generieren:

  • Rechnungen

  • Bestellungen

  • Vorschläge

  • Verträge

  • Versand

Diese Dokumente werden aus Vorlagen erstellt, die sich in /core/modules/.../doc/.

4. Wichtige Module zur PDF-Erstellung

  • TCPDF-Bibliothek (im Lieferumfang von Dolibarr enthalten)

  • PDF-Modelldateien (z. B. pdf_crabe.modules.php)

  • Skripte zur Dokumentgenerierung (builddoc.php)

  • Upload- und temporäre Ordner (/documents/)

5. Bestätigen Ihrer Dolibarr-Version und PHP-Kompatibilität

Dolibarr unterstützt ab 2025 PHP 8.1. Inkompatibilitäten zwischen Ihrer Dolibarr-Version und der aktiven PHP-Version können PDF-Funktionen beeinträchtigen. Überprüfen Sie daher immer:

  • Dolibarr-Version unter Home > Über

  • PHP-Version über eine phpinfo() Skript oder Hosting-Dashboard

6. Serveranforderungen und PDF-Abhängigkeiten

Stellen Sie sicher, dass Ihr Server die PDF-Generierungsanforderungen von Dolibarr erfüllt:

  • GD-Bibliothek

  • zlib

  • mbstring

  • fileinfo

  • Abgesicherter Modus AUS (für ältere PHP-Setups)

7. Häufige Ursachen für Fehler beim PDF-Rendering

  • Fehlende oder veraltete TCPDF-Bibliothek

  • Beschädigte Vorlagendatei in /doc/

  • PHP-Speicherlimits zu niedrig

  • Konflikte mit Modulen von Drittanbietern

  • Webserverberechtigungen verhindern das Schreiben von Dateien

8. Überprüfen auf Probleme mit der PHP-Bibliothek (TCPDF/FPDF)

TCPDF-Probleme treten häufig nach Updates auf. Überprüfen Sie:

  • /includes/tcpdf/tcpdf.php ist vorhanden und unverändert

  • Keine schwerwiegenden Fehler in dolibarr.log

  • Keine PHP-Hinweise zu veralteten TCPDF-Methoden

9. Diagnose von Dateiberechtigungsproblemen

Sorgen Sie für die Dolibarr documents Verzeichnis und seine Unterordner:

  • Existieren

  • Sind vom Webserver-Benutzer beschreibbar (z. B. www-data)

Anwendung:

chmod -R 755 htdocs/documents
chown -R www-data:www-data htdocs/documents

10. Beschädigte oder fehlende PDF-Vorlagendateien

  • Gehen Sie zu Setup > Module > Rechnungen > Konfigurieren

  • Wechseln Sie zu einer anderen Vorlage (z. B. von Azur zu Crabe)

  • Überprüfen Sie, ob das Problem weiterhin besteht

Fehlend oder geändert pdf_* Dateien können die Generierung unterbrechen.

11. Fehlerprotokolle: So finden und interpretieren Sie sie

Debug-Modus aktivieren:

  • Bearbeiten conf.php

  • Stelle den $dolibarr_main_prod = 0;

  • Bewertung /dolibarr/documents/dolibarr.log oder Webserver-Protokolle

Suchen Sie nach schwerwiegenden PHP-Fehlern oder Meldungen zu fehlenden Funktionen.

12. Beheben von Problemen mit weißem Bildschirm oder leerer PDF-Ausgabe

  • Erhöhen Sie memory_limit in php.ini

  • Prüfen Sie, ob alle Pflichtfelder ausgefüllt sind (z. B. Firmenname, Adresse)

  • Wechseln Sie die Vorlage, um benutzerdefinierte Fehler auszuschließen

13. Probleme mit benutzerdefinierten oder Drittanbieter-PDF-Vorlagen

Benutzerdefinierte Vorlagen funktionieren nach einem Dolibarr-Versionsupgrade häufig nicht mehr. Lösung:

  • Vergleichen Sie mit offiziellen Vorlagen

  • Ersetzen veralteter TCPDF-Methoden

  • Installieren Sie die Basisvorlagen im Zweifelsfall neu

14. Beheben von Problemen nach einem Dolibarr-Update oder einer Migration

  • Fehlende oder überschriebene Dateien erneut kopieren

  • Browser- und Dolibarr-Caches leeren

  • Überprüfen Sie die Kompatibilität der PHP-Version

15. Empfohlene PHP-Einstellungen für die PDF-Generierung

Dafür sorgen:

  • memory_limit = 256M

  • max_execution_time = 60

  • file_uploads = On

  • upload_max_filesize = 20M

16. TCPDF manuell aktualisieren (falls erforderlich)

  1. Laden Sie die neueste TCPDF von GitHub herunter

  2. Ersetzen Sie den Inhalt in /includes/tcpdf

  3. PDF-Ausgabe erneut testen

Achtung: Benutzerdefinierte Vorlagen müssen möglicherweise angepasst werden, um mit aktualisierten TCPDF-Versionen übereinzustimmen.

17. Verwenden des Dolibarr-Debug-Modus zum Identifizieren von Fehlern

  • Navigieren Sie zu Admin > Module > Debug-Tools

  • Fehlerprotokollierung auf dem Bildschirm aktivieren

  • Versuchen Sie die PDF-Generierung erneut und erfassen Sie die Fehlerdetails

18. Neuinstallation oder Reparatur des PDF-Kernmoduls

So setzen Sie die Standard-PDF-Module zurück:

  • Modul deaktivieren (zB Rechnungen)

  • Original erneut hochladen /doc/ Ordnervorlagen

  • Reaktivieren Sie das Modul

19. Verwenden von Systemdienstprogrammen zum Testen der PDF-Ausgabe außerhalb von Dolibarr

So schließen Sie externe Ursachen aus:

  • Erstellen Sie eine eigenständige TCPDF-PHP-Datei, um ein PDF zu generieren

  • Testen Sie das PDF-Rendering unabhängig von Dolibarr

  • Verwenden Sie Werkzeuge wie wkhtmltopdf als Fallback bei Bedarf

20. Fazit und langfristige Best Practices

So vermeiden Sie wiederkehrende PDF-Probleme in Dolibarr:

  • Halten Sie Ihre Version auf dem neuesten Stand

  • Sichern Sie Ihre benutzerdefinierten Vorlagen

  • Überwachen Sie die Kompatibilität nach jedem Upgrade

  • Verwenden Sie bei der Fehlerbehebung Standardvorlagen

Wenn Sie diesem auf das Jahr 2025 ausgerichteten Leitfaden zur Fehlerbehebung folgen, können Sie PDF-Probleme in Dolibarr sicher diagnostizieren und beheben und eine reibungslose Dokumenterstellung für Ihre Geschäftsabläufe gewährleisten.