🙁 🧑🏽‍🤝‍🧑🏼 🐩 DOMpdf से HTML को PDF में कन्वर्ट करें 👦 🏇🏾 ⏳

पीडीएफ एक मानक प्रारूप है। यह मूल रूप से एडोब द्वारा एक निश्चित संरचना के साथ एक दस्तावेज़ में पाठ और छवियों का प्रतिनिधित्व करने के लिए बनाया गया था। यह लंबे समय से वेब एप्लिकेशन के लिए असामान्य नहीं है जो डेटा डाउनलोड का समर्थन करते हैं, जैसे कि इनवॉइस या रिपोर्ट, उन्हें पीडीएफ प्रारूप में रेंडर करने के लिए। तो इस लेख में हम PHP का उपयोग करके पीडीएफ दस्तावेजों की सरल पीढ़ी के माध्यम से जाएंगे।

Dompdf एक बेहतरीन लाइब्रेरी है जो HTML मार्कअप और CSS स्टाइल्स से PDF जनरेट कर सकती है (ज्यादातर मामलों में, ये कुछ CSS3 प्रॉपर्टी के सपोर्ट के साथ CSS 2.1 के साथ संगत हैं)। हम यह निर्धारित कर सकते हैं कि हमारी सामग्री को इन परिचित तकनीकों का उपयोग करके कैसे देखना चाहिए, और फिर आसानी से इसे एक निश्चित दस्तावेज़ में बदल दें। इस पुस्तकालय में अन्य उपयोगी और दिलचस्प कार्य भी हैं।

काम पर लगना

Dompdf GitHub पर उपलब्ध है और इसे संगीतकार के उपयोग से स्थापित किया जा सकता है। बिना किसी त्रुटि के कम्पोज़र के माध्यम से स्थापित करने से अक्सर कठिनाइयों का सामना करना पड़ता है, इसलिए मैं सिर्फ डोमपीएफ को स्थापित करने के लिए गिट का उपयोग करने की सलाह देता हूं।

लाइब्रेरी को PHP> = 5.0 की आवश्यकता है जिसमें mbstring और DOM एक्सटेंशन सक्रिय हैं। इसमें कई फोंट की भी आवश्यकता होती है जो आमतौर पर अधिकांश कंप्यूटरों पर उपलब्ध होते हैं।

उस निर्देशिका पर जाएं जहां आप लाइब्रेरी स्थापित करने जा रहे हैं और कमांड लाइन चला रहे हैं:

git clone https://github.com/dompdf/dompdf.git git submodule init git submodule update

एक बार जब हम DOMpdf डाउनलोड कर लेते हैं, तो एक छोटा उदाहरण लिखते हैं, जो एक साधारण PDF डॉक्यूमेंट उत्पन्न करेगा:

 <?php set_include_path(get_include_path() . PATH_SEPARATOR . "/path/to/dompdf"); require_once "dompdf_config.inc.php"; $dompdf = new DOMPDF(); $html = <<<'ENDHTML' <html> <body> <h1>Hello Dompdf</h1> </body> </html> ENDHTML; $dompdf->load_html($html); $dompdf->render(); $dompdf->stream("hello.pdf");

प्रोजेक्ट में लाइब्रेरी का उपयोग करने के लिए, हम सबसे पहले dompdf_config.inc.php फ़ाइल को खींचते हैं, जिसमें अधिकांश डोमपेड कॉन्फ़िगरेशन है। यह ऑटोलोडर और एक उपयोगकर्ता कॉन्फ़िगरेशन फ़ाइल को भी लोड करता है जिसमें हम डिफ़ॉल्ट सेटिंग्स को ओवरराइड कर सकते हैं।

HTML मार्कअप को load_html () विधि के लिए एक स्ट्रिंग के रूप में पारित किया जाता है। वैकल्पिक रूप से, हम load_html_file () पद्धति का उपयोग करके किसी फ़ाइल या URL से मार्कअप को लोड कर सकते हैं। यह एक तर्क के रूप में एक फ़ाइल नाम या वेब पेज URL लेता है।

रेंडर () विधि पीडीएफ में HTML प्रदर्शित करता है, और हम फ़ाइल को रेंडर करने के लिए तैयार हैं। स्ट्रीम () विधि परिणामी पीडीएफ को ब्राउज़र के लिए अनुलग्नक के रूप में भेजती है। इस विधि में वैकल्पिक दूसरा पैरामीटर है, विकल्पों की एक सरणी:

Accept-Ranges - बूलियन , हेडर "Accept-Ranges" (डिफ़ॉल्ट रूप से गलत ) भेजता है।
अटैचमेंट - बूलियन , हेडर को "कंटेंट-डिस्पोजल: अटैचमेंट" भेजता है, जिससे ब्राउजर एक सेव रिक्वेस्ट प्रदर्शित करता है (डिफ़ॉल्ट रूप से सही )।
सेक - बूलियन , सामग्री संपीड़न (डिफ़ॉल्ट रूप से सही ) को सक्षम करता है।

हमने सिर्फ एक बहुत ही सरल पीडीएफ उत्पन्न किया है, लेकिन यह पूरी तरह से व्यावहारिक नहीं है। वास्तव में, हमारे पास अक्सर शीट आकार, पृष्ठ अभिविन्यास, चरित्र एन्कोडिंग, आदि के लिए आवश्यकताएं होती हैं। ऐसे कई विकल्प हैं जिन्हें हम अपनी वास्तविक जरूरतों के लिए डोमपेड को और अधिक उपयुक्त बनाने के लिए निर्धारित कर सकते हैं। उन सभी को dompdf_config.inc.php फ़ाइल में सूचीबद्ध और समझाया गया है, जो उन्हें उनके डिफ़ॉल्ट मूल्यों पर सेट करता है। आप उपयोगकर्ता कॉन्फ़िगरेशन फ़ाइल dompdf_config.custom.inc.php को अपडेट करके इन मानों को बदल सकते हैं। यहाँ कुछ महत्वपूर्ण सेटिंग्स हैं:

DOMPDF_DEFAULT_PAPER_SIZE - एक पीडीएफ दस्तावेज़ के लिए डिफ़ॉल्ट शीट आकार सेट करता है। समर्थित शीट का आकार शामिल / cpdf_adcape.cls.php फ़ाइल में पाया जा सकता है (डिफ़ॉल्ट मान "अक्षर" है )।
DOMPDF_TEMP_DIR - DOMpdf द्वारा उपयोग किए जाने वाले अस्थायी फ़ोल्डर को इंगित करता है। सुनिश्चित करें कि यह निर्देशिका आपकी वेब सर्वर सेटिंग्स के अनुसार लिखने योग्य है।
DOMPDF_UNICODE_ENABLED - यह निर्धारित करता है कि क्या पीडीएफ यूनिकोड फोंट (डिफ़ॉल्ट रूप से सही ) का उपयोग करेगा।
DOMPDF_ENABLE_REMOTE - दूरस्थ साइटों (डिफ़ॉल्ट रूप से गलत ) से छवियों या CSS शैलियों के समावेश को सक्रिय करता है।
DEBUG_LAYOUT - एक पीडीएफ फाइल में प्रत्येक HTML ब्लॉक के चारों ओर एक बॉर्डर प्रदर्शित करने के लिए सेट करता है। यह लेआउट डिबगिंग (डिफ़ॉल्ट रूप से गलत ) के लिए बहुत सुविधाजनक है।

उन्नत उपयोग

अब आइए Dompdf के उन्नत उपयोग के बारे में थोड़ा बात करते हैं। शायद हम उत्पन्न पीडीएफ दस्तावेज़ को डिस्क पर सहेजना चाहते हैं, बजाय इसे ब्राउज़र में भेजने के। यह कैसे करना है:

 <?php $dompdf = new DOMPDF(); $dompdf->load_html($html); $dompdf->render(); $output = $dompdf->output(); file_put_contents("/path/to/file.pdf", $output);

कॉलिंग स्ट्रीम () के बजाय, पिछले उदाहरण में, हम आउटपुट () का उपयोग करते हैं, जो पीडीएफ को एक स्ट्रिंग के रूप में लौटाता है। यह विधि विकल्पों की एक सरणी को भी स्वीकार करती है, लेकिन केवल एक ही उपलब्ध है - सेक ( सत्य के लिए चूक)।

DOMpdf हमें HTML में सीधे PHP स्क्रिप्ट को एम्बेड करके उत्पन्न पीडीएफ में एक हेडर और पाद लेख जोड़ने की अनुमति देता है जो इसे प्रदर्शित करता है। लेकिन इस तथ्य के कारण कि मनमाने ढंग से कोड प्रसंस्करण एक सुरक्षा जोखिम पैदा कर सकता है, इस कार्यक्षमता के लिए जिम्मेदार कॉन्फ़िगरेशन मान डिफ़ॉल्ट रूप से बंद है। सबसे पहले हमें DOMPDF_ENABLE_PHP विकल्प को सही पर सेट करना होगा ।

जैसे ही हम एम्बेडेड PHP को सक्षम करते हैं, पीडीएफ ऑब्जेक्ट स्क्रिप्ट के अंदर उपलब्ध होगा और हम इसका उपयोग पेज को हेरफेर करने के लिए कर सकते हैं। हम टेक्स्ट, लाइनें, चित्र, आयत आदि जोड़ सकते हैं।

 $html = <<<'ENDHTML' <html> <body> <script type="text/php"> if (isset($pdf)) { // open the PDF object - all drawing commands will // now go to the object instead of the current page $footer = $pdf->open_object(); // get height and width of page $w = $pdf->get_width(); $h = $pdf->get_height(); // get font $font = Font_Metrics::get_font("helvetica", "normal"); $txtHeight = Font_Metrics::get_font_height($font, 8); // draw a line along the bottom $y = $h - 2 * $txtHeight - 24; $color = array(0, 0, 0); $pdf->line(16, $y, $w - 16, $y, $color, 1); // set page number on the left side $pdf->page_text(16, $y, "Page: {PAGE_NUM} of {PAGE_COUNT}", $font, 8, $color); // set additional text $text = "Dompdf is awesome"; $width = Font_Metrics::get_text_width($text, $font, 8); $pdf->text($w - $width - 16, $y, $text, $font, 8); // close the object (stop capture) $pdf->close_object(); // add the object to every page (can also specify // "odd" or "even") $pdf->add_object($footer, "all"); } </script> <h1>Hello Dompdf</h1> </body> </html> ENDHTML;

स्क्रिप्ट सीधे HTML मार्कअप में एम्बेडेड होती है और पहले ऑब्जेक्ट को खोलती है ताकि हम डिस्प्ले को प्रभावित कर सकें। सभी रेंडरिंग को इस ऑब्जेक्ट पर लिखा जाएगा और हम इसे सभी चयनित पृष्ठों में जोड़ सकते हैं (हालांकि सीमाएं हैं)।

फिर हमें उस पाद लेख के निर्देशांक की गणना करने के लिए पृष्ठ की वास्तविक चौड़ाई और ऊंचाई मिलती है जिसे हम जोड़ने जा रहे हैं। जैसे ही हम टेक्स्ट कंटेंट जोड़ते हैं, हमें एक फॉन्ट ऑब्जेक्ट भी देना होगा। Font_Metrics :: get_font () आपको वह ऑब्जेक्ट बनाने की अनुमति देता है जिसकी हमें आवश्यकता है। हम पाद के सामग्री की स्थिति की गणना करने के लिए get_font_height () का उपयोग करके इसके आकार से दिए गए फ़ॉन्ट की ऊंचाई भी लेते हैं। Get_font_width () विधि किसी दिए गए फ़ॉन्ट और आकार के लिए हमारे पाठ की चौड़ाई लौटाती है, जिसका उपयोग हम अपनी गणना में भी करते हैं।

रेखा () विधि बिंदु (X1, Y1) से बिंदु (X2, Y2) तक एक रेखा खींचती है। कृपया ध्यान दें कि आरजीबी में रंग का मूल्य पूरी तरह से प्रतिस्थापित नहीं है। मुख्य पीडीएफ वर्ग को 0 और 1 के बीच मानों की आवश्यकता होती है, इसलिए हम RGB मानों को इन नए मूल्यों में परिवर्तित करते हैं। एक बेहतर अनुमान प्राप्त करने के लिए, आप उन्हें 255 से विभाजित कर सकते हैं।

हम पेज_टेक्स्ट () पद्धति का उपयोग करके प्रत्येक पृष्ठ के लिए एक संख्या जोड़ते हैं, जो X और Y निर्देशांक लेता है, साथ ही पाठ को जोड़ा जाता है, फ़ॉन्ट ऑब्जेक्ट, फ़ॉन्ट आकार और रंग। DOMpdf स्वचालित रूप से प्रत्येक पृष्ठ पर {PAGE_NUM} और {PAGE_COUNT} के मानों को बदल देता है और $ pdf को हमें उपलब्ध कराता है।

इसके अलावा, हम अंतर्निहित PHP का उपयोग नहीं कर सकते हैं और PHP से सीधे एक समान प्रभाव प्राप्त कर सकते हैं, कुछ इस प्रकार है:

 <?php $dompdf = new DOMPDF(); $dompdf->set_paper("A4"); // load the html content $dompdf->load_html($html); $dompdf->render(); $canvas = $dompdf->get_canvas(); $font = Font_Metrics::get_font("helvetica", "bold"); $canvas->page_text(16, 800, "Page: {PAGE_NUM} of {PAGE_COUNT}", $font, 8, array(0,0,0)); $dompdf->stream("sample.pdf",array("Attachment"=>0));

कृपया ध्यान दें कि हम $ dompdf-> रेंडर () कॉल करने के बाद कोड रखते हैं क्योंकि हम अनिवार्य रूप से पहले से बनाए गए पीडीएफ को संपादित करते हैं।

संक्षेप में कहना

इस लेख में, हमने DOMpdf का उपयोग करके HTML को पीडीएफ में बदलने का एक आसान तरीका पर चर्चा की। इस तथ्य के बावजूद कि DOMpdf एक उत्कृष्ट पुस्तकालय है, यह PDF दस्तावेज़ों को बनाने के लिए पूरी तरह से सार्वभौमिक समाधान नहीं है; इसकी अभी भी कुछ सीमाएँ और समस्याएं हैं। Dompdf खराब डिज़ाइन किए गए HTML के प्रति बहुत सहिष्णु नहीं है और बड़ी तालिकाओं को आसानी से मेमोरी अतिप्रवाह हो सकता है। कुछ बेसिक CSS फीचर्स जैसे कि फ्लोट पूरी तरह से सपोर्ट नहीं है। सामान्य तौर पर, CSS3 का समर्थन बहुत सीमित है। यदि आपको ऐसे कार्यों की आवश्यकता है जो डोमपीड में समर्थित नहीं हैं, उदाहरण के लिए wkhtmltopdf आपकी मदद कर सकता है। फिर भी, PDF निर्यात करने के अधिकांश कार्यों को हल करने के लिए DOMpdf एक बहुत ही सरल और सुविधाजनक उपकरण है।

इस तरह से एक लेख में पुस्तकालय के सभी कार्यों की व्याख्या करना वास्तव में काफी कठिन है, इसलिए दस्तावेज़ीकरण और स्रोत कोड को देखना न भूलें, और कॉलबैक जोड़ने, अपने स्वयं के फोंट का उपयोग करने जैसे उपयोगी कार्य भी सीखें।

मूल - phpmaster.com/convert-html-to-pdf-with-dompdf

DOMpdf से HTML को PDF में कन्वर्ट करें

काम पर लगना

उन्नत उपयोग

संक्षेप में कहना

More articles: