पेशेवर पाठ्यक्रम "फ्रेमवर्क लारवेल" के छात्रों के लिए लेख का अनुवाद तैयार किया गया था।

फ्रैक वान डेर हर्टन और स्पैटी टीम ने लारवेल इवेंट प्रोजेक्टर पर एक लंबे समय तक कड़ी मेहनत की है, एक पैकेज जो इवेंट सोर्सिंग की अवधारणा को लारवेल फ्रेमवर्क में उपयोग करने की अनुमति देता है। और अंत में, पहला स्थिर संस्करण (v1.0.0) उपलब्ध है!

आप संगीतकार का उपयोग करके अपने प्रोजेक्ट में ईवेंट प्रोजेक्टर स्थापित कर सकते हैं और, लारवेल में स्वचालित पैकेट पहचान के लिए धन्यवाद, पैकेज माइग्रेशन और कॉन्फ़िगरेशन प्रकाशित करने के तुरंत बाद काम करने के लिए मिलता है!

composer require spatie/laravel-event-projector:^1.0.0 

इवेंट प्रोजेक्टर के लिए PHP 7.2 की आवश्यकता होती है, इसलिए आपके एप्लिकेशन को PHP के नवीनतम संस्करण का समर्थन करना चाहिए, हालांकि लारवेल फ्रेमवर्क को कम से कम 7.1.3 के PHP संस्करण की आवश्यकता है।

"इवेंट जनरेशन" क्या है

घटनाक्रम उत्पन्न करने वाले लेख में , इस अवधारणा का वर्णन इस प्रकार है:

डोमेन में डेटा की वर्तमान स्थिति को संग्रहीत करने के बजाय, इस डेटा पर किए गए कार्यों के पूरे अनुक्रम को रिकॉर्ड करने के लिए उपयोग करें, परिशिष्ट-केवल मोड में काम कर रहा भंडारण केवल डेटा जोड़ रहा है। भंडारण रिकॉर्ड की एक प्रणाली के रूप में कार्य करता है और इसका उपयोग डोमेन ऑब्जेक्ट्स को भौतिक बनाने के लिए किया जा सकता है। यह हमें जटिल विषय क्षेत्रों में कार्यों को सरल बनाने की अनुमति देता है, क्योंकि डेटा मॉडल और विषय क्षेत्र को सिंक्रनाइज़ करने की कोई आवश्यकता नहीं है, जो बेहतर स्केलेबिलिटी, बढ़ी हुई उत्पादकता और परिचालन दक्षता की ओर जाता है। यह दृष्टिकोण लेनदेन डेटा की स्थिरता सुनिश्चित करता है, और आपको एक पूर्ण परिवर्तन लॉग और इतिहास रखने की भी अनुमति देता है, जिससे प्रतिपूरक कार्यों को करना संभव हो जाता है।

मेरा सुझाव है कि आप पूरा लेख पढ़ें। यह इस टेम्पलेट का एक उत्कृष्ट विवरण प्रदान करता है, उचित उपयोग के लिए विचारों पर विचार करता है, और उन स्थितियों का वर्णन करता है जहां यह उपयोगी हो सकता है।

मुझे इवेंट जनरेशन की अवधारणा की व्याख्या भी पसंद है, जो इवेंट प्रोजेक्टर के लिए प्रलेखन के परिचय में दी गई है :

घटनाओं की पीढ़ी डेटा के संबंध में समान है, जैसे Git कोड के संबंध में है। अधिकांश एप्लिकेशन डेटाबेस में केवल अपनी वर्तमान स्थिति संग्रहीत करते हैं। उपयोगी जानकारी का एक महत्वपूर्ण हिस्सा खो गया है - आपको नहीं पता कि आवेदन इस स्थिति तक कैसे पहुंचा।

इवेंट जनरेशन की अवधारणा आपके एप्लिकेशन में होने वाली सभी घटनाओं को सहेजकर इस समस्या को हल करने का एक प्रयास है। इन घटनाओं को सुनने के परिणामस्वरूप आवेदन की स्थिति बनती है।

समझ की सुविधा के लिए, जीवन से एक छोटा सा उदाहरण पर विचार करें। कल्पना कीजिए कि आप एक बैंक हैं। आपके ग्राहकों के खाते हैं। केवल खाते की शेष राशि के बारे में जानकारी रखना पर्याप्त नहीं है। आपको सभी लेनदेन भी याद रखने होंगे। इवेंट जनरेशन टेम्प्लेट का उपयोग करते समय, डेटाबेस में खाता शेष केवल एक अलग क्षेत्र नहीं होगा, बल्कि संग्रहीत लेनदेन की जानकारी के आधार पर गणना की जाएगी। यह कई लाभों में से एक है जो इवेंट पीढ़ी की अवधारणा प्रदान करता है।

यह पैकेज इवेंट पीढ़ी की अवधारणा के साथ लारवेल ढांचे के उपयोगकर्ताओं को परिचित करने के लिए डिज़ाइन किया गया है और अभ्यास में इसके उपयोग की सुविधा प्रदान करता है।

ऐसा लगता है कि इवेंट प्रोजेक्टर, इवेंट जनरेशन पैटर्न के साथ काम को आसान बनाने में मदद करता है। प्रलेखन ने मुझे यह पता लगाने में भी मदद की कि लारवेल ढांचे की अवधारणाओं के हिस्से के रूप में इस दृष्टिकोण का उपयोग कैसे किया जाए जो मुझे पहले से ही पता है।

लारवेल इवेंटिंग बेसिक्स

इवेंट प्रोजेक्टर पैकेज में इवेंट जनरेशन कैसे काम करता है और इस प्रक्रिया में कौन से घटक शामिल हैं, यह समझने के लिए, आपको पहले प्रोजेक्टर सेक्शन बनाना चाहिए।

उच्च स्तर पर (मुझे क्षमा करें यदि मैं पूरी तरह से अपने आकलन में सही नहीं हूं, क्योंकि घटनाओं की पीढ़ी मेरे लिए एक नई अवधारणा है) इवेंट प्रोजेक्टर का उपयोग करने वाली घटनाओं की पीढ़ी में शामिल हैं:

• शानदार मॉडल
• कंधों को कार्यान्वित करने वाली घटनाएँ
• प्रोजेक्टर कक्षाएं

दस्तावेज़ में उपलब्ध कराई गई createWithAttributes स्थिर विधि के साथ एक मॉडल वर्ग का एक उदाहरण:

 namespace App; use App\Events\AccountCreated; use App\Events\AccountDeleted; use App\Events\MoneyAdded; use App\Events\MoneySubtracted; use Illuminate\Database\Eloquent\Model; use Ramsey\Uuid\Uuid; class Account extends Model { protected $guarded = []; protected $casts = [ 'broke_mail_send' => 'bool', ]; public static function createWithAttributes(array $attributes): Account { /* *      (uuid). */ $attributes['uuid'] = (string) Uuid::uuid4(); /* *          uuid. */ event(new AccountCreated($attributes)); /* *         uuid. */ return static::uuid($attributes['uuid']); } public function addMoney(int $amount) { event(new MoneyAdded($this->uuid, $amount)); } public function subtractMoney(int $amount) { event(new MoneySubtracted($this->uuid, $amount)); } public function delete() { event(new AccountDeleted($this->uuid)); } /* *         uuid. */ public static function uuid(string $uuid): ?Account { return static::where('uuid', $uuid)->first(); } } 

यहां आपको खाता खोलने, MoneySubtracted MoneyAdded , MoneySubtracted और MoneyAdded जैसी घटनाओं पर ध्यान देना होगा, खाता खोलने के लिए क्रमशः ट्रिगर किया जाएगा, खाते में पैसे जोड़े जाएंगे, खाते से पैसे निकाले MoneySubtracted और खाता हटाया जाएगा।

निम्नलिखित MoneyAdded घटना (किसी खाते में पैसे जोड़ने) का एक उदाहरण है। ShouldBeStored इंटरफ़ेस इवेंट प्रोजेक्टर पैकेज को बताता है कि इस ईवेंट को सहेजा जाना चाहिए:

 namespace App\Events; use Spatie\EventProjector\ShouldBeStored; class MoneyAdded implements ShouldBeStored { /** @var string */ public $accountUuid; /** @var int */ public $amount; public function __construct(string $accountUuid, int $amount) { $this->accountUuid = $accountUuid; $this->amount = $amount; } } 

और अंत में, खाते में धन की भरपाई करने के लिए प्रोजेक्टर वर्ग के अंदर एक इवेंट हैंडलर का एक आंशिक उदाहरण (मेरी पसंदीदा प्रकार की बैंकिंग घटना):

 public function onMoneyAdded(MoneyAdded $event) { $account = Account::uuid($event->accountUuid); $account->balance += $event->amount; $account->save(); } 

यह सब एक साथ जोड़ने के लिए, एक नया खाता बनाने और धन जोड़ने पर प्रलेखन से एक उदाहरण पर विचार करें:

 Account::createWithAttributes(['name' => 'Luke']); Account::createWithAttributes(['name' => 'Leia']); $account = Account::where(['name' => 'Luke'])->first(); $anotherAccount = Account::where(['name' => 'Leia'])->first(); $account->addMoney(1000); $anotherAccount->addMoney(500); $account->subtractMoney(50); 

मुझे संदेह है कि ल्यूक और लीया के खातों में संतुलन गांगेय मानक ऋण में व्यक्त किया गया है, हालांकि सामान्य तौर पर मुझे संदेह है कि वे खुले तौर पर इस तरह के ऑपरेशन करेंगे।

इस पैकेज का उपयोग करके घटनाओं को उत्पन्न करने के निम्नलिखित लाभ से मेरा ध्यान आकर्षित किया गया था, जैसा कि प्रलेखन में संकेत दिया गया है:

प्रोजेक्टर के साथ काम करते समय एक दिलचस्प बिंदु - उन्हें घटनाओं के घटित होने के बाद बनाया जा सकता है। कल्पना करें कि बैंक प्रत्येक खाते में औसत शेष पर एक रिपोर्ट प्राप्त करना चाहता है। इस मामले में, यह एक नया प्रोजेक्टर बनाने, सभी घटनाओं को खेलने और अंत में यह डेटा प्राप्त करने के लिए पर्याप्त होगा।

घटनाओं के अंत में नए प्रोजेक्टर बनाने का विचार बहुत आशाजनक लगता है। यह पता चला है कि आपको पहले से सभी "सही" डेटा प्राप्त करने की आवश्यकता नहीं है, लेकिन आप परिणाम के लिए आ सकते हैं।

प्रदर्शन के अनुसार, प्रलेखन के अनुसार, प्रोजेक्टर तक पहुंच "बहुत जल्दी होती है।"

और जानना चाहते हैं?

आरंभ करने के लिए, मेरा सुझाव है कि आप इवेंट प्रोजेक्टर प्रलेखन पढ़ें और सुनिश्चित करें कि आपके पास PHP 7.2 का नवीनतम संस्करण स्थापित है। स्पैट टीम ने लारवेल पर एक नमूना आवेदन भी अपलोड किया, जिसमें इवेंट प्रोजेक्टर पैकेज की क्षमताओं का प्रदर्शन किया गया।

आप कोड डाउनलोड कर सकते हैं, तारांकन चिह्न के साथ भंडार को चिह्नित कर सकते हैं, और गिटहब पर इवेंट प्रोजेक्टर प्रोजेक्ट के विकास में भी योगदान दे सकते हैं। लेखन के समय, प्रोजेक्ट इवेंट प्रोजेक्टर में पहले से ही 15 प्रतिभागी हैं, जिनके प्रयासों से 1.0 की स्थिर रिलीज संभव हो गई। बहुत अच्छा काम, Spatie! मुझे यकीन है कि इवेंट प्रोजेक्टर एक और शानदार पैकेज होगा जिसे लारवेल समुदाय द्वारा सराहा जाएगा।