Spatie PHP पैकेज: पूर्ण गाइड उदाहरणों के साथ

यह लाइब्रेरी क्या है और इसकी आवश्यकता क्यों है

Spatie कोई एक लाइब्रेरी नहीं, बल्कि उच्च गुणवत्ता वाले PHP पैकेजों का एक पूरा इकोसिस्टम है, जिसे बेल्जियम की इसी नाम की कंपनी द्वारा विकसित किया गया है। Spatie साफ, टेस्ट करने योग्य और अच्छी तरह से डॉक्यूमेंटेड कोड बनाने के अपने दृष्टिकोण के लिए जानी जाती है। उनके पैकेज कई तरह के कार्यों को कवर करते हैं: मीडिया फ़ाइलों के साथ काम करने और क्वेरी कैशिंग से लेकर भूमिकाओं और अनुमतियों के प्रबंधन तक।

Spatie कलेक्शन यूटिलिटीज (spatie/collection-utilities) हेल्पर फंक्शन और क्लासेज का एक सेट है जो PHP में ऐरे और कलेक्शन की मानक क्षमताओं को बढ़ाता है। यह डेटा को फ़िल्टर करने, सॉर्ट करने, बदलने और विश्लेषण करने के लिए सुविधाजनक मेथड प्रदान करता है, जिससे कोड अधिक पढ़ने योग्य और संक्षिप्त हो जाता है।

इसकी आवश्यकता क्यों है? आधुनिक PHP डेवलपमेंट (विशेषकर Laravel जैसे फ्रेमवर्क में) में डेटा कलेक्शन के साथ काम करना एक रोज़मर्रा का काम है। Spatie Collection Utilities आपको एक ही तरह के लूप और कंडीशन लिखने से बचाती है, और तैयार, अच्छी तरह से टेस्ट किए गए समाधान प्रदान करती है। इससे डेवलपमेंट तेज़ होता है, एरर कम होते हैं और कोड की मेंटेनबिलिटी बढ़ती है।

इंस्टॉलेशन

Spatie पैकेजों की इंस्टॉलेशन Composer के माध्यम से की जाती है, जो PHP के लिए मानक डिपेंडेंसी मैनेजर है।

composer require spatie/collection-utilities

यदि आप Laravel का उपयोग कर रहे हैं, तो Composer की ऑटोलोडिंग के कारण पैकेज स्वचालित रूप से रजिस्टर हो जाता है। अन्य फ्रेमवर्क या सादे PHP के लिए, बस अपनी स्क्रिप्ट में require 'vendor/autoload.php'; जोड़ें।

कोड उदाहरण के साथ त्वरित शुरुआत

इंस्टॉलेशन के बाद, आप तुरंत यूटिलिटीज का उपयोग शुरू कर सकते हैं। मुख्य क्लास जिसके साथ आप काम करेंगे वह है Spatie\CollectionUtilities\Collection। यह Laravel के मानक Illuminate\Support\Collection क्लास को एक्सटेंड करता है या एक स्वतंत्र क्लास के रूप में उपयोग किया जा सकता है।

<?php
require 'vendor/autoload.php';

use Spatie\CollectionUtilities\Collection;

// एक कलेक्शन बनाएं
$collection = new Collection([1, 2, 3, 4, 5, 6, 7, 8, 9, 10]);

// सम संख्याएं प्राप्त करने के लिए filter मेथड का उपयोग करें
$evenNumbers = $collection->filter(fn($item) => $item % 2 === 0);

// प्रत्येक आइटम को 2 से गुणा करने के लिए map मेथड का उपयोग करें
$doubled = $evenNumbers->map(fn($item) => $item * 2);

// वापस ऐरे में बदलने के लिए toArray मेथड का उपयोग करें
print_r($doubled->toArray());
// आउटपुट: Array ( [0] => 4 [1] => 8 [2] => 12 [3] => 16 [4] => 20 )
?>

यह सरल उदाहरण मेथड चेनिंग को दर्शाता है, जो Spatie कलेक्शन के साथ काम करने की एक प्रमुख विशेषता है।

मुख्य मेथड/फंक्शन

1. filter()

यह क्या करता है: कॉलबैक फंक्शन का उपयोग करके कलेक्शन को फ़िल्टर करता है। केवल उन्हीं आइटम्स को लौटाता है जिनके लिए कॉलबैक true लौटाता है।

पैरामीटर:

• callback (callable): एक फंक्शन जो वर्तमान आइटम और उसकी की प्राप्त करता है। इसे true या false लौटाना चाहिए।
• mode (int): वैकल्पिक। फ़िल्टरिंग मोड (डिफ़ॉल्ट ARRAY_FILTER_USE_BOTH)।

कार्यशील कोड उदाहरण:

$users = new Collection([
    ['name' => 'Alice', 'age' => 25],
    ['name' => 'Bob', 'age' => 17],
    ['name' => 'Charlie', 'age' => 30],
]);

$adults = $users->filter(fn($user) => $user['age'] >= 18);
// परिणाम: Alice और Charlie के साथ Collection

2. map()

यह क्या करता है: कलेक्शन के प्रत्येक आइटम पर कॉलबैक फंक्शन लागू करता है और बदले गए आइटम्स के साथ एक नया कलेक्शन लौटाता है।

पैरामीटर:

• callback (callable): एक फंक्शन जो वर्तमान आइटम और उसकी की प्राप्त करता है। इसे बदला हुआ मान लौटाना चाहिए।

कार्यशील कोड उदाहरण:

$prices = new Collection([100, 200, 300]);
$withTax = $prices