1. TCPDF क्या है और इसकी ज़रूरत क्यों है?

TCPDF (Transparent Communication PDF) PHP के लिए एक शक्तिशाली और व्यापक रूप से उपयोग की जाने वाली लाइब्रेरी है, जो प्रोग्रामेटिक रूप से PDF डॉक्यूमेंट बनाने के लिए डिज़ाइन की गई है। यह अपनी श्रेणी की सबसे पुरानी और सबसे फीचर-समृद्ध लाइब्रेरी में से एक है, जो डेवलपर्स को बिना किसी बाहरी टूल या एक्सटेंशन (इमेज के लिए स्टैंडर्ड GD एक्सटेंशन को छोड़कर) के PDF जनरेशन पर पूर्ण नियंत्रण देती है।

TCPDF की ज़रूरत क्यों है? आधुनिक वेब डेवलपमेंट में अक्सर चलते-फिरते PDF डॉक्यूमेंट जनरेट करने की ज़रूरत होती है: इनवॉइस, रसीद, रिपोर्ट, सर्टिफिकेट, कॉन्ट्रैक्ट, ई-बुक्स और भी बहुत कुछ। TCPDF सर्वर-साइड पर काम करके इस समस्या को हल करता है। यह PDF की सभी प्रमुख क्षमताओं को सपोर्ट करता है, जिसमें फॉन्ट (TrueType, Type1, Unicode), इमेज (JPEG, PNG, GIF, SVG), HTML कंटेंट, टेबल, एनोटेशन, फॉर्म, बुकमार्क, एन्क्रिप्शन और डिजिटल सिग्नेचर शामिल हैं। Unicode सपोर्ट के कारण, यह हिंदी, अरबी, चीनी और अन्य भाषाओं के साथ सही ढंग से काम करता है।

TCPDF का FPDF या Dompdf जैसे विकल्पों की तुलना में मुख्य लाभ इसकी "आउट-ऑफ-द-बॉक्स" समृद्ध कार्यक्षमता और जटिल लेआउट के लिए बेहतरीन सपोर्ट है। यह HTML को उच्च सटीकता के साथ PDF में बदल सकता है, जो इसे तैयार टेम्पलेट्स के आधार पर डॉक्यूमेंट जनरेट करने के लिए आदर्श बनाता है। यह लाइब्रेरी कम्युनिटी द्वारा सक्रिय रूप से मेंटेन की जाती है, इसमें विस्तृत डॉक्यूमेंटेशन और ढेरों उदाहरण हैं, जो सीखने और सामान्य कार्यों को हल करने की प्रक्रिया को बहुत आसान बनाते हैं।

2. इंस्टॉलेशन (Installation)

TCPDF को इंस्टॉल करने का सबसे आसान तरीका डिपेंडेंसी मैनेजर Composer के माध्यम से है। यह अनुशंसित तरीका है, क्योंकि यह स्वचालित रूप से लाइब्रेरी को लोड करता है और इसके वर्जन को मैनेज करता है।

अपने प्रोजेक्ट की रूट डायरेक्टरी में निम्नलिखित कमांड चलाएँ:

composer require tecnickcom/tcpdf

इस कमांड को चलाने के बाद, आपके प्रोजेक्ट में एक vendor फ़ोल्डर बनेगा, और composer.json फ़ाइल में डिपेंडेंसी की एंट्री जुड़ जाएगी। PHP स्क्रिप्ट में लाइब्रेरी का उपयोग करने के लिए, Composer ऑटोलोडर को शामिल करना होगा:

require_once __DIR__ . '/vendor/autoload.php';

अगर आप Composer का उपयोग नहीं कर रहे हैं, तो आप GitHub से आर्काइव डाउनलोड कर सकते हैं और मुख्य लाइब्रेरी फ़ाइल को मैन्युअल रूप से शामिल कर सकते हैं:

require_once('/path/to/tcpdf/tcpdf.php');

हालांकि, मैन्युअल तरीका अनुशंसित नहीं है, क्योंकि इससे लाइब्रेरी को अपडेट करना मुश्किल हो जाता है।

3. त्वरित शुरुआत — एक न्यूनतम कार्यशील उदाहरण

आइए एक बहुत ही सरल PDF डॉक्यूमेंट बनाएं जो "Hello, World!" टेक्स्ट प्रिंट करता है। यह उदाहरण TCPDF के साथ काम करने के बुनियादी जीवनचक्र को दर्शाता है: ऑब्जेक्ट बनाना, पेज जोड़ना, टेक्स्ट प्रिंट करना और फ़ाइल सेव करना।

<?php
// Composer ऑटोलोडर शामिल करें
require_once __DIR__ . '/vendor/autoload.php';

// 1. एक नया PDF डॉक्यूमेंट बनाएं
// पैरामीटर: ओरिएंटेशन (P - पोर्ट्रेट, L - लैंडस्केप), यूनिट (mm), पेज साइज़ (A4)
$pdf = new TCPDF('P', 'mm', 'A4', true, 'UTF-8', false);

// 2. डिफ़ॉल्ट हेडर और फुटर हटाएं (सरलता के लिए)
$pdf->setPrintHeader(false);
$pdf->setPrintFooter(false);

// 3. एक पेज जोड़ें
$pdf->AddPage();

// 4. फॉन्ट सेट करें
$pdf->SetFont('helvetica', 'B', 20);

// 5. टेक्स्ट प्रिंट करें (x, y, टेक्स्ट)
$pdf->Text(10, 10, 'Hello, World!');

// 6. फ़ाइल को सेव करें और ब्राउज़र में डाउनलोड करें
$pdf->Output('hello_world.pdf', 'D');
?>

इस कोड को चलाने पर, आपको hello_world.pdf नाम की एक फ़ाइल डाउनलोड होगी, जिसमें "Hello, World!" लिखा होगा। यह TCPDF के साथ शुरुआत करने का सबसे आसान तरीका है।