विषय - सूची

  1. परिचय

  2. पीडीएफ़ डिस्प्ले समस्याओं के सामान्य लक्षण

  3. डोलिबार पीडीएफ दस्तावेज़ कैसे तैयार करता है

  4. पीडीएफ निर्माण में शामिल प्रमुख मॉड्यूल

  5. आपके Dolibarr संस्करण और PHP संगतता की पुष्टि करना

  6. सर्वर आवश्यकताएँ और PDF निर्भरताएँ

  7. पीडीएफ रेंडरिंग विफलताओं के सामान्य कारण

  8. PHP लाइब्रेरी समस्याओं की जाँच करना (TCPDF/FPDF)

  9. फ़ाइल अनुमति समस्याओं का निदान

  10. दूषित या गुम पीडीएफ टेम्पलेट फ़ाइलें

  11. त्रुटि लॉग: उन्हें कैसे खोजें और व्याख्या करें

  12. सफेद स्क्रीन या खाली पीडीएफ आउटपुट का समाधान

  13. कस्टम या थर्ड-पार्टी पीडीएफ टेम्पलेट्स से जुड़ी समस्याएं

  14. डोलिबार अपडेट या माइग्रेशन के बाद समस्याओं को ठीक करना

  15. पीडीएफ निर्माण के लिए अनुशंसित PHP सेटिंग्स

  16. TCPDF को मैन्युअल रूप से अपडेट करना (यदि आवश्यक हो)

  17. त्रुटियों की पहचान करने के लिए डॉलीबार डिबग मोड का उपयोग करना

  18. पीडीएफ कोर मॉड्यूल को पुनः स्थापित या मरम्मत करना

  19. Dolibarr के बाहर PDF आउटपुट का परीक्षण करने के लिए सिस्टम उपयोगिताओं का उपयोग करना

  20. निष्कर्ष और दीर्घकालिक सर्वोत्तम अभ्यास

1. परिचय

यदि आपकी PDF अब Dolibarr में अपेक्षित रूप से प्रदर्शित नहीं हो रही है—चाहे चालान, प्रस्ताव, डिलीवरी स्लिप या कोटेशन में—तो आप अकेले नहीं हैं। PDF जनरेशन संबंधी समस्याएं Dolibarr फ़ोरम में सबसे आम सहायता अनुरोधों में से हैं, खासकर सिस्टम अपडेट या माइग्रेशन के बाद।

यह मार्गदर्शिका आपको डॉलीबार ईआरपी में पीडीएफ रेंडरिंग समस्याओं के मूल कारणों की पहचान करने और उन्हें हल करने में मदद करेगी, जिसमें 2025 में देखे गए परिवर्तनों पर विशेष ध्यान दिया जाएगा।

2. पीडीएफ डिस्प्ले समस्याओं के सामान्य लक्षण

  • "पीडीएफ जेनरेट करें" पर क्लिक करने से कुछ नहीं होता

  • पीडीएफ़ तैयार करते समय सफ़ेद स्क्रीन

  • फ़ाइल डाउनलोड तो हो जाती है लेकिन दूषित या रिक्त होती है

  • त्रुटि संदेश जैसे "TCPDF त्रुटि" या "फ़ाइल नहीं खोली जा सकती"

  • जेनरेट किए गए PDF में केवल आंशिक सामग्री दिखाई गई

3. डॉलीबार पीडीएफ दस्तावेज़ कैसे तैयार करता है

डोलिबार निम्नलिखित मॉड्यूल के लिए गतिशील पीडीएफ सामग्री उत्पन्न करने के लिए PHP-आधारित लाइब्रेरीज़ (मुख्य रूप से TCPDF) का उपयोग करता है:

  • चालान

  • आदेश

  • प्रस्ताव

  • संविदा

  • शिपिंग

ये दस्तावेज़ निम्न में स्थित टेम्पलेट्स से बनाए गए हैं /core/modules/.../doc/.

4. पीडीएफ निर्माण में शामिल प्रमुख मॉड्यूल

  • TCPDF लाइब्रेरी (डोलिबार के साथ बंडल)

  • पीडीएफ मॉडल फ़ाइलें (जैसे, pdf_crabe.modules.php)

  • दस्तावेज़ निर्माण स्क्रिप्ट (builddoc.php)

  • अपलोड और अस्थायी फ़ोल्डर (/documents/)

5. अपने Dolibarr संस्करण और PHP संगतता की पुष्टि करना

2025 में, Dolibarr PHP 8.1 और उससे ऊपर के संस्करणों का समर्थन करता है। आपके Dolibarr संस्करण और सक्रिय PHP संस्करण के बीच असंगतता PDF सुविधाओं को बाधित कर सकती है। हमेशा सत्यापित करें:

  • Dolibarr संस्करण होम > के अंतर्गत

  • PHP संस्करण के माध्यम से phpinfo() स्क्रिप्ट या होस्टिंग डैशबोर्ड

6. सर्वर आवश्यकताएँ और पीडीएफ निर्भरताएँ

सुनिश्चित करें कि आपका सर्वर Dolibarr की PDF निर्माण आवश्यकताओं को पूरा करता है:

  • जीडी लाइब्रेरी

  • ज़ेडलिब

  • mbstring

  • फ़ाइल जानकारी

  • सुरक्षित मोड बंद (पुराने PHP सेटअप के लिए)

7. पीडीएफ रेंडरिंग विफलताओं के सामान्य कारण

  • अनुपलब्ध या पुरानी TCPDF लाइब्रेरी

  • दूषित टेम्पलेट फ़ाइल /doc/

  • PHP मेमोरी सीमा बहुत कम है

  • परस्पर विरोधी तृतीय-पक्ष मॉड्यूल

  • वेब सर्वर अनुमतियाँ फ़ाइल लेखन को रोक रही हैं

8. PHP लाइब्रेरी समस्याओं की जाँच करना (TCPDF/FPDF)

TCPDF में अक्सर अपडेट के बाद समस्याएँ आती हैं। जाँच करें:

  • /includes/tcpdf/tcpdf.php मौजूद है और अपरिवर्तित है

  • इसमें कोई घातक त्रुटि नहीं है dolibarr.log

  • अप्रचलित TCPDF विधियों पर कोई PHP नोटिस नहीं

9. फ़ाइल अनुमति समस्याओं का निदान

डोलिबार सुनिश्चित करें documents निर्देशिका और उसके उपफ़ोल्डर्स:

  • मौजूद

  • वेब सर्वर उपयोगकर्ता द्वारा लिखे जा सकने योग्य हैं (उदाहरण के लिए, www-data)

का प्रयोग करें:

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

10. दूषित या गुम पीडीएफ टेम्पलेट फ़ाइलें

  • सेटअप > मॉड्यूल > इनवॉइस > कॉन्फ़िगर पर जाएं

  • किसी अन्य टेम्पलेट पर स्विच करें (जैसे, Azur से Crabe तक)

  • जाँच करें कि क्या समस्या बनी हुई है

गायब या संशोधित pdf_* फ़ाइलें पीढ़ी को तोड़ सकती हैं.

11. त्रुटि लॉग: उन्हें कैसे खोजें और व्याख्या करें

डिबग मोड सक्षम करें:

  • संपादित करें conf.php

  • सेट $dolibarr_main_prod = 0;

  • समीक्षा /dolibarr/documents/dolibarr.log या वेब सर्वर लॉग

PHP घातक त्रुटियों या अनुपलब्ध फ़ंक्शन संदेशों की तलाश करें।

12. सफेद स्क्रीन या खाली पीडीएफ आउटपुट का समाधान

  • मेमोरी_सीमा बढ़ाएँ php.ini

  • जाँच करें कि सभी अनिवार्य फ़ील्ड भरी गई हैं (जैसे, कंपनी का नाम, पता)

  • कस्टम बग को दूर करने के लिए टेम्पलेट्स बदलें

13. कस्टम या थर्ड-पार्टी पीडीएफ टेम्पलेट्स से जुड़ी समस्याएं

Dolibarr संस्करण अपग्रेड के बाद कस्टम टेम्पलेट अक्सर टूट जाते हैं।

  • आधिकारिक टेम्पलेट्स के साथ तुलना करें

  • अप्रचलित TCPDF विधियों को बदलें

  • यदि अनिश्चित हों तो आधार टेम्पलेट पुनः स्थापित करें

14. डॉलीबार अपडेट या माइग्रेशन के बाद समस्याओं को ठीक करना

  • गुम या अधिलेखित फ़ाइलों की पुनः प्रतिलिपि बनाएँ

  • ब्राउज़र और डॉलीबार कैश साफ़ करें

  • PHP संस्करण संगतता की जाँच करें

15. पीडीएफ निर्माण के लिए अनुशंसित PHP सेटिंग्स

सुनिश्चित करें:

  • memory_limit = 256M

  • max_execution_time = 60

  • file_uploads = On

  • upload_max_filesize = 20M

16. TCPDF को मैन्युअल रूप से अपडेट करना (यदि आवश्यक हो)

  1. GitHub से नवीनतम TCPDF डाउनलोड करें

  2. सामग्री बदलें /includes/tcpdf

  3. पीडीएफ आउटपुट का पुनः परीक्षण करें

सावधानी: कस्टम टेम्पलेट्स को अद्यतन TCPDF संस्करणों से मेल खाने के लिए अनुकूलित करने की आवश्यकता हो सकती है।

17. त्रुटियों की पहचान करने के लिए डॉलीबार डिबग मोड का उपयोग करना

  • एडमिन > मॉड्यूल > डीबग टूल पर जाएँ

  • स्क्रीन पर त्रुटि लॉगिंग सक्षम करें

  • पीडीएफ जनरेशन का पुनः प्रयास करें और त्रुटि विवरण कैप्चर करें

18. पीडीएफ कोर मॉड्यूल को पुनः स्थापित करना या मरम्मत करना

डिफ़ॉल्ट PDF मॉड्यूल रीसेट करने के लिए:

  • मॉड्यूल निष्क्रिय करें (उदाहरणार्थ, चालान)

  • मूल पुनः अपलोड करें /doc/ फ़ोल्डर टेम्पलेट्स

  • मॉड्यूल को पुनः सक्रिय करें

19. डॉलीबार के बाहर पीडीएफ आउटपुट का परीक्षण करने के लिए सिस्टम यूटिलिटीज का उपयोग करना

बाहरी कारणों को ख़ारिज करने के लिए:

  • PDF बनाने के लिए एक स्टैंडअलोन TCPDF PHP फ़ाइल बनाएँ

  • Dolibarr से स्वतंत्र रूप से PDF रेंडरिंग का परीक्षण करें

  • जैसे उपकरण का उपयोग करें wkhtmltopdf यदि आवश्यक हो तो फ़ॉलबैक के रूप में

20. निष्कर्ष और दीर्घकालिक सर्वोत्तम अभ्यास

डोलिबार में बार-बार आने वाली पीडीएफ समस्याओं से बचने के लिए:

  • अपना संस्करण अद्यतन रखें

  • अपने कस्टम टेम्पलेट्स का बैकअप लें

  • हर अपग्रेड के बाद संगतता की निगरानी करें

  • समस्या निवारण करते समय मानक टेम्पलेट का उपयोग करें

इस 2025-केंद्रित समस्या निवारण मार्गदर्शिका का पालन करके, आप आत्मविश्वास से Dolibarr में PDF समस्याओं का निदान और समाधान कर सकते हैं और अपने व्यावसायिक वर्कफ़्लो के लिए सुचारू दस्तावेज़ निर्माण बनाए रख सकते हैं।