Πίνακας περιεχομένων

  1. Εισαγωγή

  2. Συνήθη συμπτώματα προβλημάτων εμφάνισης PDF

  3. Πώς το Dolibarr δημιουργεί έγγραφα PDF

  4. Βασικές ενότητες που εμπλέκονται στη δημιουργία PDF

  5. Επιβεβαίωση της έκδοσης Dolibarr και της συμβατότητας PHP

  6. Απαιτήσεις διακομιστή και εξαρτήσεις PDF

  7. Συνήθεις αιτίες αποτυχιών απόδοσης PDF

  8. Έλεγχος για προβλήματα στη βιβλιοθήκη PHP (TCPDF/FPDF)

  9. Διάγνωση προβλημάτων δικαιωμάτων αρχείων

  10. Αρχεία προτύπων PDF που έχουν καταστραφεί ή λείπουν

  11. Αρχεία καταγραφής σφαλμάτων: Πώς να τα εντοπίσετε και να τα ερμηνεύσετε

  12. Επίλυση προβλήματος λευκής οθόνης ή κενής εξόδου PDF

  13. Προβλήματα με προσαρμοσμένα πρότυπα PDF ή πρότυπα PDF τρίτων κατασκευαστών

  14. Επίλυση προβλημάτων μετά από ενημέρωση ή μετεγκατάσταση του Dolibarr

  15. Συνιστώμενες ρυθμίσεις PHP για δημιουργία PDF

  16. Ενημέρωση TCPDF χειροκίνητα (εάν χρειάζεται)

  17. Χρήση της λειτουργίας εντοπισμού σφαλμάτων Dolibarr για τον εντοπισμό σφαλμάτων

  18. Επανεγκατάσταση ή επιδιόρθωση της βασικής μονάδας PDF

  19. Χρήση βοηθητικών προγραμμάτων συστήματος για δοκιμή εξόδου PDF εκτός Dolibarr

  20. Συμπέρασμα και μακροπρόθεσμες βέλτιστες πρακτικές

1. Εισαγωγή

Εάν τα PDF σας δεν εμφανίζονται πλέον στο Dolibarr όπως αναμένεται—είτε σε τιμολόγια, προτάσεις, δελτία παράδοσης είτε σε προσφορές—δεν είστε μόνοι. Τα προβλήματα δημιουργίας PDF είναι από τα πιο συνηθισμένα αιτήματα υποστήριξης στα φόρουμ του Dolibarr, ειδικά μετά από ενημερώσεις συστήματος ή μετεγκαταστάσεις.

Αυτός ο οδηγός θα σας καθοδηγήσει στον εντοπισμό και την επίλυση των βαθύτερων αιτιών των προβλημάτων απόδοσης PDF στο Dolibarr ERP, με ιδιαίτερη έμφαση στις αλλαγές που παρατηρήθηκαν το 2025.

2. Συνήθη συμπτώματα προβλημάτων εμφάνισης PDF

  • Κάνοντας κλικ στην επιλογή "Δημιουργία PDF" δεν γίνεται τίποτα

  • Λευκή οθόνη κατά τη δημιουργία PDF

  • Το αρχείο λαμβάνει αλλά είναι κατεστραμμένο ή κενό

  • Μήνυμα σφάλματος όπως "Σφάλμα TCPDF" ή "Δεν είναι δυνατό το άνοιγμα του αρχείου"

  • Μόνο μερικό περιεχόμενο εμφανίζεται στα δημιουργημένα PDF

3. Πώς το Dolibarr δημιουργεί έγγραφα PDF

Το Dolibarr χρησιμοποιεί βιβλιοθήκες που βασίζονται σε PHP (κυρίως TCPDF) για τη δημιουργία δυναμικού περιεχομένου PDF για ενότητες όπως:

  • Τιμολόγια

  • Παραγγελιες

  • Προτάσεις

  • Συμβάσεις

  • Αποστολές

Αυτά τα έγγραφα δημιουργούνται από πρότυπα που βρίσκονται στο /core/modules/.../doc/.

4. Βασικές ενότητες που εμπλέκονται στη δημιουργία PDF

  • Βιβλιοθήκη TCPDF (συνοδεύεται από το Dolibarr)

  • Αρχεία μοντέλου PDF (π.χ. pdf_crabe.modules.php)

  • Σενάρια δημιουργίας εγγράφων (builddoc.php)

  • Φάκελοι μεταφόρτωσης και προσωρινοί (/documents/)

5. Επιβεβαίωση της έκδοσης Dolibarr και της συμβατότητας PHP

Το 2025, το Dolibarr υποστηρίζει PHP 8.1 και νεότερες εκδόσεις. Η ασυμβατότητα μεταξύ της έκδοσης Dolibarr που διαθέτετε και της ενεργής έκδοσης PHP ενδέχεται να προκαλέσει προβλήματα στις λειτουργίες του PDF. Να επαληθεύετε πάντα:

  • Έκδοση Dolibarr στην ενότητα Αρχική > Σχετικά

  • Έκδοση PHP μέσω ενός phpinfo() script ή πίνακας ελέγχου φιλοξενίας

6. Απαιτήσεις διακομιστή και εξαρτήσεις PDF

Βεβαιωθείτε ότι ο διακομιστής σας πληροί τις απαιτήσεις δημιουργίας PDF της Dolibarr:

  • Βιβλιοθήκη GD

  • zlib

  • mbstring

  • fileinfo

  • Ασφαλής λειτουργία ΑΠΕΝΕΡΓΟΠΟΙΗΜΕΝΗ (για παλαιότερες ρυθμίσεις PHP)

7. Συνήθεις αιτίες αποτυχιών απόδοσης PDF

  • Λείπει ή είναι παλιά η βιβλιοθήκη TCPDF

  • Κατεστραμμένο αρχείο προτύπου στο /doc/

  • Τα όρια μνήμης PHP είναι πολύ χαμηλά

  • Μονάδες τρίτων κατασκευαστών που βρίσκονται σε διένεξη

  • Δικαιώματα διακομιστή ιστού που εμποδίζουν την εγγραφή αρχείων

8. Έλεγχος για προβλήματα βιβλιοθήκης PHP (TCPDF/FPDF)

Τα προβλήματα TCPDF εμφανίζονται συχνά μετά από ενημερώσεις. Ελέγξτε:

  • /includes/tcpdf/tcpdf.php είναι παρόν και δεν έχει τροποποιηθεί

  • Δεν υπάρχουν θανατηφόρα σφάλματα στο dolibarr.log

  • Δεν υπάρχουν ειδοποιήσεις PHP για παρωχημένες μεθόδους TCPDF

9. Διάγνωση προβλημάτων δικαιωμάτων αρχείων

Βεβαιωθείτε ότι το Dolibarr documents κατάλογος και οι υποφάκελοί του:

  • Υπάρχει

  • Είναι εγγράψιμα από τον χρήστη του διακομιστή ιστού (π.χ., www-data)

Χρήση:

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

10. Κατεστραμμένα ή ελλείποντα αρχεία προτύπων PDF

  • Μεταβείτε στις Ρύθμιση > Ενότητες > Τιμολόγια > Διαμόρφωση

  • Μετάβαση σε άλλο πρότυπο (π.χ., από Azur σε Crabe)

  • Ελέγξτε αν το πρόβλημα επιμένει

Λείπει ή τροποποιήθηκε pdf_* Τα αρχεία μπορούν να διακόψουν την παραγωγή.

11. Αρχεία καταγραφής σφαλμάτων: Πώς να τα εντοπίσετε και να τα ερμηνεύσετε

Ενεργοποίηση λειτουργίας εντοπισμού σφαλμάτων:

  • Επεξεργασία conf.php

  • σετ $dolibarr_main_prod = 0;

  • Βαθμολογία Κριτικής /dolibarr/documents/dolibarr.log ή αρχεία καταγραφής διακομιστή ιστού

Αναζητήστε ανεπανόρθωτα σφάλματα PHP ή ελλείποντα μηνύματα συνάρτησης.

12. Επίλυση προβλήματος λευκής οθόνης ή κενής εξόδου PDF

  • Αύξηση memory_limit σε php.ini

  • Ελέγξτε ότι όλα τα υποχρεωτικά πεδία είναι συμπληρωμένα (π.χ. επωνυμία εταιρείας, διεύθυνση)

  • Αλλάξτε πρότυπα για να αποκλείσετε προσαρμοσμένα σφάλματα

13. Προβλήματα με προσαρμοσμένα πρότυπα PDF ή πρότυπα PDF τρίτων κατασκευαστών

Τα προσαρμοσμένα πρότυπα συχνά παρουσιάζουν σφάλματα μετά από αναβαθμίσεις της έκδοσης Dolibarr. Διόρθωση:

  • Συγκρίνετε με επίσημα πρότυπα

  • Αντικατάσταση παρωχημένων μεθόδων TCPDF

  • Επανεγκαταστήστε τα βασικά πρότυπα εάν δεν είστε σίγουροι

14. Επίλυση προβλημάτων μετά από ενημέρωση ή μετεγκατάσταση του Dolibarr

  • Επαναντιγραφή αρχείων που λείπουν ή αντικαταστάθηκαν

  • Εκκαθάριση προσωρινής μνήμης προγράμματος περιήγησης και Dolibarr

  • Ελέγξτε τη συμβατότητα της έκδοσης PHP

15. Συνιστώμενες ρυθμίσεις PHP για τη δημιουργία PDF

Εξασφαλίζω:

  • memory_limit = 256M

  • max_execution_time = 60

  • file_uploads = On

  • upload_max_filesize = 20M

16. Ενημέρωση του TCPDF χειροκίνητα (εάν χρειάζεται)

  1. Λήψη του τελευταίου TCPDF από το GitHub

  2. Αντικατάσταση περιεχομένου σε /includes/tcpdf

  3. Δοκιμάστε ξανά την έξοδο PDF

Προσοχή: Τα προσαρμοσμένα πρότυπα ενδέχεται να χρειαστεί να προσαρμοστούν ώστε να ταιριάζουν με τις ενημερωμένες εκδόσεις TCPDF.

17. Χρήση της λειτουργίας εντοπισμού σφαλμάτων Dolibarr για τον εντοπισμό σφαλμάτων

  • Μεταβείτε στην ενότητα Διαχείριση > Ενότητες > Εργαλεία εντοπισμού σφαλμάτων

  • Ενεργοποίηση καταγραφής σφαλμάτων στην οθόνη

  • Επανάληψη δημιουργίας PDF και καταγραφή των λεπτομερειών σφάλματος

18. Επανεγκατάσταση ή επιδιόρθωση της βασικής μονάδας PDF

Για να επαναφέρετε τις προεπιλεγμένες ενότητες PDF:

  • Απενεργοποίηση ενότητας (π.χ., Τιμολόγια)

  • Επαναφόρτωση αρχικού αρχείου /doc/ πρότυπα φακέλων

  • Επανενεργοποίηση της ενότητας

19. Χρήση βοηθητικών προγραμμάτων συστήματος για δοκιμή εξόδου PDF εκτός Dolibarr

Για να αποκλειστούν εξωτερικές αιτίες:

  • Δημιουργήστε ένα αυτόνομο αρχείο TCPDF PHP για να δημιουργήσετε ένα PDF

  • Δοκιμή απόδοσης PDF ανεξάρτητα από το Dolibarr

  • Χρησιμοποιήστε εργαλεία όπως wkhtmltopdf ως εφεδρικό εάν χρειαστεί

20. Συμπέρασμα και μακροπρόθεσμες βέλτιστες πρακτικές

Για να αποφύγετε επαναλαμβανόμενα προβλήματα PDF στο Dolibarr:

  • Διατηρήστε την έκδοσή σας ενημερωμένη

  • Δημιουργήστε αντίγραφα ασφαλείας των προσαρμοσμένων προτύπων σας και δημιουργήστε αντίγραφα ασφαλείας των προσαρμοσμένων προτύπων σας.

  • Παρακολούθηση συμβατότητας μετά από κάθε αναβάθμιση

  • Χρησιμοποιήστε τυπικά πρότυπα κατά την αντιμετώπιση προβλημάτων. Χρησιμοποιήστε τυπικά πρότυπα κατά την αντιμετώπιση προβλημάτων.

Ακολουθώντας αυτόν τον οδηγό αντιμετώπισης προβλημάτων που εστιάζει στο 2025, μπορείτε να διαγνώσετε και να επιλύσετε με σιγουριά προβλήματα PDF στο Dolibarr και να διατηρήσετε την ομαλή δημιουργία εγγράφων για τις ροές εργασίας της επιχείρησής σας.