PSR-14 - PHP में मुख्य घटना

पिछले साल, PHP-FIG , PHP कम्पेटिबिलिटी कॉन्सेप्ट ग्रुप ने कई नए स्पेसिफिकेशन जारी किए। अंतिम एक, PSR-14 , ईवेंट प्रेषण के लिए समर्पित है। अन्य पीएसआर की तरह, यह एक स्थानीय विनिर्देश है, लेकिन मानकीकरण के कई पहलुओं पर इसका बड़ा प्रभाव है।

अनुवादक से: यह प्रकाशनों की एक श्रृंखला के पहले भाग का अनुवाद है जिसमें PHP-FIG के सदस्यों में से एक लैरी (क्रेल) गारफील्ड बताते हैं कि PSR-14 क्या है, यह क्या करने में सक्षम है और यह क्या है और इसका उपयोग करने का सबसे अच्छा तरीका क्या है? उनके प्रोजेक्ट।

लक्ष्य

घटना प्रेषण लंबे समय से कई भाषाओं में उपयोग किया गया है। यदि आपने कभी सिम्फनी में EventDispatcher, Laravel में ईवेंट सिस्टम, Drupal में हुक, Zend फ्रेमवर्क में इवेंट मैनेजर , League \ Event पैकेज या ऐसा कुछ उपयोग किया है, तो आप समझते हैं कि यह क्या है।

एक सामान्य अर्थ में, ये सभी प्रणालियां एक "मध्यस्थ-पर्यवेक्षक" का एक रूप हैं। कोड का एक टुकड़ा प्रकार - "घटना" का एक संदेश भेजता है, और मध्यस्थ इसे कोड के अन्य व्यक्तिगत टुकड़ों - "श्रोताओं" को भेजता है। कभी-कभी सिग्नल को केवल एक दिशा में निर्देशित किया जाता है, कभी-कभी "श्रोता" किसी भी तरह कॉल करने वाले को डेटा वापस भेज सकता है। बेशक, वे सभी अलग-अलग हैं और एक-दूसरे के साथ बहुत संगत नहीं हैं।

यह स्टैंडअलोन पुस्तकालयों के लिए एक समस्या है जो विभिन्न पुस्तकालयों और अनुप्रयोगों से जुड़ना चाहते हैं। कई पुस्तकालयों को घटनाओं को एक या दूसरे रूप में भेजकर विस्तारित किया जा सकता है ताकि अन्य कोड उनसे संपर्क कर सकें। लेकिन इस तरह की एक मध्यस्थ परत वास्तव में, मालिकाना है। सिम्फनी EventDispatcher चलाने वाले पुस्तकालय को सिम्फनी के साथ विलय कर दिया जाता है। फिर इसे कहीं और उपयोग करने के लिए EventDispatcher स्थापित करने और प्रोग्राम में लाइब्रेरी से कनेक्ट करने की आवश्यकता होती है। लाइब्रेरी जो Drupal module_invoke_all() से बाइंडिंग सिस्टम को कॉल करती है, फिर Drupal से जुड़ी होती है। और इसी तरह।

PSR-14 का लक्ष्य इस निर्भरता के पुस्तकालयों से छुटकारा पाना है। यह पुस्तकालयों को एक पतली आम परत के माध्यम से विस्तार करने की अनुमति देता है, और फिर अतिरिक्त प्रयास और व्यय के बिना किसी अन्य वातावरण में उनके स्थानांतरण की सुविधा देता है, उदाहरण के लिए, सिम्फनी, ज़ेंड फ्रेमवर्क, लारवेल, TYPO3, eZ प्लेटफ़ॉर्म या स्लिम में। जब तक पर्यावरण में PSR-14 के साथ संगतता है, तब तक सब कुछ काम करेगा।

विनिर्देश

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

 namespace Psr\EventDispatcher; interface EventDispatcherInterface { public function dispatch(object $event); } interface ListenerProviderInterface { public function getListenersForEvent(object $event) : iterable; } interface StoppableEventInterface { public function isPropagationStopped() : bool; } 

पहले दो विनिर्देशन के मूल हैं। StoppableEventInterface एक विस्तार है, जिस पर हम बाद में लौटेंगे।

मुझे लगता है कि EventDispatcher आप में से अधिकांश के लिए परिचित है - यह उस विधि के साथ एक वस्तु है जिसके साथ आप घटना को पारित करते हैं - मध्यस्थ जो आपने पहले ही बात की थी। हालाँकि, ईवेंट को परिभाषित नहीं किया गया है - यह कोई भी PHP ऑब्जेक्ट हो सकता है। इस पर और बाद में।

अधिकांश मौजूदा कार्यान्वयन में एक ऑब्जेक्ट या फ़ंक्शन का सेट होता है जो एक मध्यस्थ या डिस्पैचर के रूप में कार्य करता है और कोड को पंजीकृत करने के लिए एक स्थान होता है जो घटना (श्रोताओं) को प्राप्त करता है। PSR-14 के लिए, हमने जानबूझकर इन दो जिम्मेदारियों को अलग-अलग वस्तुओं में विभाजित किया है। डिस्पैचर प्रदाता सूची से श्रोताओं की एक सूची प्राप्त करता है जो इस सूची को बनाता है।

प्रदाता को श्रोताओं की सूची कहां से मिलती है? हाँ, वह कहाँ चाहता है! श्रोता और घटना को जोड़ने के लिए एक बिलियन और एक तरीका है, ये सभी बिल्कुल वैध और असंगत हैं। शुरुआत में, हमने फैसला किया कि छात्रों को पंजीकृत करने के लिए "वन ट्रू वे" का मानकीकरण बहुत सीमित होगा। हालांकि, श्रोता को डिस्पैचर से जोड़ने की प्रक्रिया का मानकीकरण करके, आप उपयोगकर्ता को कुछ अजीब और समझ से बाहर करने के लिए मजबूर किए बिना उत्कृष्ट लचीलापन प्राप्त कर सकते हैं।

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

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

सरल उदाहरण है

सामान्य शब्दों में, सभी भागों को एक साथ जोड़ने की योजना कुछ इस तरह दिखाई देगी।

 class Dispatcher implements EventDispatcherInterface { public function __construct(ListenerProviderInterface $provider) { $this->provider = $provider; } public function dispatch(object $event) { foreach ($this->provider->getListenersForEvent($event) as $listener) { $listener($event); } return $event; } } $dispatcher = new Dispatcher($provider); $event = new SomethingHappened(); $dispatcher->dispatch($event); 

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

कोड

PSR-14 पहले से ही प्रमुख रूपरेखाओं और अनुप्रयोगों द्वारा समर्थित है।

• मैथ्यू वीयर ओ'पनी ने पहले ही ज़ेंड-फ्रेमवर्क 4.0 में पीएसआर -14 के लिए ज़ेंड फ्रेमवर्क में समर्थन शुरू करने का वादा किया है।
  
• सिम्फनी ने हाल ही में PSR-14 के साथ संगतता के लिए EventDispatcher में परिवर्तन की घोषणा की , जो 5.0 / 5.1 में पूर्ण समर्थन देगा।
  
• Yii फ्रेमवर्क ने PSR-14 को 3.0 संस्करण में एकीकृत करने के अपने इरादे की घोषणा की।
  
• TYPO3 CMS के बेनी मैक ने कहा कि अगले TYPO3 रिलीज में, सभी मौजूदा ट्रैप + सिग्नल / स्लॉट कॉन्सेप्ट PSR-14 का समर्थन करेंगे।
  

PSR-14 में तीन पूरी तरह कार्यात्मक स्वतंत्र कार्यान्वयन हैं जो आप पहले से ही किसी भी एप्लिकेशन में उपयोग कर सकते हैं।

• इस लेख के लेखक लैरी गारफील्ड द्वारा तुकियो ।
  
• मैथ्यू वीयर ओ'पनी द्वारा फली इवेंट डिस्पैचर ।
  
• बेनी मैक से कार्ट , जो एक एम्बेडेड प्लगइन के रूप में काम करता है।
  

लेखक पूरे PSR वर्किंग ग्रुप का धन्यवाद करता है: लैरी गारफील्ड , Cees-Jan Kiewiet , बेंजामिन मैक , एलिजाबेथ स्मिथ , रयान वीवर , मैथ्यू वीयर ओ'पनी । पूरे काम के दौरान, प्रक्रिया बेहद उत्पादक थी: सभी ने मिलकर काम किया, सामूहिक रूप से, जैसा कि यह होना चाहिए। परिणाम सुखद है, और मैं आर्किटेक्चर पर संयुक्त काम में आगे के सभी प्रयासों को उत्पादक के रूप में पसंद करूंगा।

आप अगले भाग के मूल और प्रलेखन या PHP रूस में 17 मई से अधिक जानकारी प्राप्त कर सकते हैं। दूसरा विकल्प कई कारणों से आकर्षक है। उदाहरण के लिए, कार्यक्रम समिति के प्रमुख अलेक्जेंडर ( समदर्क ) मकरोव उन लोगों में से हैं, जिन्होंने Yii में PSR-14 पेश किया है। और सिद्धांत रूप में, कार्यक्रम समिति और वक्ताओं की रचना अविश्वसनीय रूप से मजबूत है, PHP के व्यावसायिक उपयोग के क्षेत्र से शायद ही कोई विषय है जिस पर इस सम्मेलन में चर्चा नहीं की जा सकती है।