1. यह क्या है और इसकी आवश्यकता क्यों है

PhpSpreadsheet PHP भाषा के लिए एक शक्तिशाली लाइब्रेरी है, जो Excel (XLSX, XLS), LibreOffice Calc (ODS), CSV, HTML और अन्य फ़ॉर्मेट में स्प्रेडशीट को पढ़ने, लिखने और प्रबंधित करने के लिए डिज़ाइन की गई है। यह लोकप्रिय लेकिन पुरानी PHPExcel लाइब्रेरी की उत्तराधिकारी है, जिसका विकास 2017 में बंद हो गया था। PhpSpreadsheet को आधुनिक PHP मानकों (PSR-4, PSR-7, PSR-12) को ध्यान में रखते हुए पूरी तरह से फिर से लिखा गया है और यह बड़े डेटा, जटिल फ़ॉर्मूले, स्टाइल, चार्ट और कंडीशनल फ़ॉर्मेटिंग के साथ काम करता है।

इसकी आवश्यकता क्यों है? वेब डेवलपमेंट में अक्सर डेटाबेस से डेटा को Excel रिपोर्ट में एक्सपोर्ट करना, उपयोगकर्ताओं द्वारा अपलोड की गई टेबल को इम्पोर्ट करना, इनवॉइस, प्राइस लिस्ट या वित्तीय दस्तावेज़ जनरेट करना पड़ता है। PhpSpreadsheet आपको सर्वर पर ऑफिस सुइट इंस्टॉल किए बिना प्रोग्रामेटिक रूप से ऐसा करने देती है। यह XLSX, ODS, CSV, HTML, PDF (बाहरी लाइब्रेरी के माध्यम से) सहित 30 से अधिक फ़ाइल फ़ॉर्मेट को सपोर्ट करती है, और फ़ॉर्मूले, कंडीशनल फ़ॉर्मेटिंग, मर्ज किए गए सेल, इमेज और कमेंट के साथ काम कर सकती है।

यह लाइब्रेरी सक्रिय रूप से विकसित हो रही है (GitHub पर 3000 से अधिक स्टार) और Laravel Excel, PhpOffice Suite और कई कॉर्पोरेट सिस्टम जैसे प्रोजेक्ट्स में उपयोग की जाती है। यह रिपोर्ट बनाने, डेटा माइग्रेशन, दस्तावेज़ प्रबंधन ऑटोमेशन और CRM/ERP सिस्टम के साथ इंटीग्रेशन के लिए एकदम सही है।

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

PhpSpreadsheet Composer के माध्यम से इंस्टॉल की जाती है, जो PHP के लिए मानक डिपेंडेंसी मैनेजर है। सुनिश्चित करें कि आपके पास PHP संस्करण 7.4 या उससे ऊपर (8.0+ अनुशंसित) इंस्टॉल है।

composer require phpoffice/phpspreadsheet

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

require 'vendor/autoload.php';

यदि आप किसी फ्रेमवर्क (Laravel, Symfony) का उपयोग कर रहे हैं, तो लाइब्रेरी आमतौर पर सर्विस प्रोवाइडर के माध्यम से स्वचालित रूप से कनेक्ट हो जाती है।

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

आइए एक सरल स्क्रिप्ट बनाएं जो डेटा टेबल के साथ एक Excel फ़ाइल जनरेट करे और उसे डाउनलोड करने के लिए आउटपुट करे:

getActiveSheet();

// 2. सेल भरें
$sheet->setCellValue('A1', 'नाम');
$sheet->setCellValue('B1', 'ईमेल');
$sheet->setCellValue('A2', 'राहुल शर्मा');
$sheet->setCellValue('B2', 'rahul@example.com');
$sheet->setCellValue('A3', 'प्रिया वर्मा');
$sheet->setCellValue('B3', 'priya@example.com');

// 3. डाउनलोड के लिए हेडर सेट करें
header('Content-Type: application/vnd.openxmlformats-officedocument.spreadsheetml.sheet');
header('Content-Disposition: attachment;filename="users.xlsx"');
header('Cache-Control: max-age=0');

// 4. फ़ाइल को आउटपुट में लिखें
$writer = new Xlsx($spreadsheet);
$writer->save('php://output');
exit;

यह कोड users.xlsx नामक फ़ाइल बनाता है जिसमें दो पंक्तियों का डेटा होता है। आप इसे Excel या LibreOffice Calc में खोल सकते हैं।

4. मुख्य तरीके/फंक्शन/क्लास

4.1. Spreadsheet::__construct()

सिग्नेचर: new Spreadsheet()

यह क्या करता है: एक डिफ़ॉल्ट वर्कशीट के साथ एक नया खाली दस्तावेज़ बनाता है।

$spreadsheet = new Spreadsheet();
$sheet = $spreadsheet->getActiveSheet();
echo $sheet->getTitle(); // "W