🕵🏾 🛕 🗣️ टेम्पलेट फ़िल्टरिंग इवेंट मैनेजर 🌡️ ◾️ 👩🏿‍🤝‍👩🏾

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

मुझे पैटर्न द्वारा घटनाओं को उत्पन्न करने की क्षमता की आवश्यकता थी;
लाइब्रेरी इंटरफ़ेस नेत्रहीन पसंद नहीं किया गया था।

बेशक, मैंने लाइब्रेरी को "खुद के लिए" खत्म करने और कंघी करने का फैसला किया।

घटना पीढ़ी पैटर्न द्वारा

मुझे आवश्यक घटनाओं को उत्पन्न करने के लिए टेम्पलेट का उपयोग करने की क्षमता की आवश्यकता थी जिनके नाम पदानुक्रमित कुंजी ( foo.bar.baz ) हैं।
उदाहरण के लिए, ऐसी घटनाओं की सूची के लिए:

some.event
another.event
yet.another.event
something.new

"इवेंट" में समाप्त होने वाली सभी घटनाओं को उत्पन्न करना आवश्यक है। या "अभी तक" के साथ शुरू और "घटना" के साथ समाप्त होता है, और इससे कोई फर्क नहीं पड़ता कि बीच में क्या है।

Eventable

थोड़ा सोचने के बाद, मैंने पहले से पाए गए इवनमेंट के आधार पर लाइब्रेरी को लागू करने के बारे में निर्धारित किया।

घटना प्रेषण

इंटरफ़ेस के बारे में सोचते हुए, मैंने jQuery और घटनाओं के साथ काम करने के अपने तरीकों पर गौर किया: on() , one() , off() , trigger() । मुझे इसकी संक्षिप्तता और संक्षिप्तता के कारण अधिकांश भाग के लिए यह दृष्टिकोण पसंद आया।

परिणाम निम्नलिखित इंटरफ़ेस है:

 Dispatcher { public Dispatcher on(string $event, callable $listener) public Dispatcher once(string $event, callable $listener) public Dispatcher off([string $event [, callable $listener ]]) public Dispatcher trigger(string $event [, array $args ]) public Dispatcher fire(string $event [, array $args ]) }

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

trigger() एक ईवेंट कुंजी पैटर्न लेता है, और सभी मिलान घटनाओं को उठाता है।
fire() बदले में एक एकल, विशिष्ट घटना उठाती है।

यदि हैंडलर को एक बार निष्पादित किया जाना चाहिए, तो इसे एक once() विधि का उपयोग करके किसी घटना पर लटका दिया जाता है

Dispatcher.php

 namespace Yowsa\Eventable; class Dispatcher { protected $events = []; public function on($event, callable $listener) { if (!KeysResolver::isValidKey($event)) { throw new \InvalidArgumentException('Invalid event name given'); } if (!isset($this->events[$event])) { $this->events[$event] = []; } $this->events[$event][] = $listener; return $this; } public function once($event, callable $listener) { $onceClosure = function () use (&$onceClosure, $event, $listener) { $this->off($event, $onceClosure); call_user_func_array($listener, func_get_args()); }; $this->on($event, $onceClosure); return $this; } public function off($event = null, callable $listener = null) { if (empty($event)) { $this->events = []; } elseif (empty($listener)) { $this->events[$event] = []; } elseif (!empty($this->events[$event])) { $index = array_search($listener, $this->events[$event], true); if (false !== $index) { unset($this->events[$event][$index]); } } return $this; } public function trigger($event, array $args = []) { $matchedEvents = KeysResolver::filterKeys($event, array_keys($this->events)); if (!empty($matchedEvents)) { if (is_array($matchedEvents)) { foreach ($matchedEvents as $eventName) { $this->fire($eventName, $args); } } else { $this->fire($matchedEvents, $args); } } return $this; } public function fire($event, array $args = []) { foreach ($this->events[$event] as $listener) { call_user_func_array($listener, $args); } return $this; } }

पार्सिंग कीज़

आधा काम किया जाता है - डिस्पैचर को लागू किया जाता है और काम करता है। अगला कदम टेम्पलेट द्वारा ईवेंट फ़िल्टरिंग को जोड़ना है।
टेम्प्लेट सभी समान कुंजी हैं, लेकिन फ़िल्टरिंग के लिए लेबल के साथ:

* - विभाजक से पहले एक खंड;
** - सेगमेंट की कोई भी संख्या।

मुख्य application.user.signin.error के लिए .user.signin.error application.user.signin.error आप निम्नलिखित सही टेम्पलेट बना सकते हैं:

application.**.error
**.error
application.user.*.error
application.user.**

इस फ़िल्टरिंग को लागू करने के लिए, तीन तरीकों की आवश्यकता थी:

 KeysResolver { public static int isValidKey(string $key) public static string getKeyRegexPattern(string $key) public static mixed filterKeys(string $pattern [, array $keys ]) }

कुछ भी नहीं सैन्य: कुंजी सत्यापन, एक पैटर्न को एक नियमित अभिव्यक्ति में परिवर्तित करना और एक प्रमुख सरणी को फ़िल्टर करना।

KeysResolver.php

 namespace Yowsa\Eventable; class KeysResolver { public static function isValidKey($key) { return preg_match('/^(([\w\d\-]+)\.?)+[^\.]$/', $key); } public static function getKeyRegexPattern($key) { $pattern = ('*' === $key) ? '([^\.]+)' : (('**' === $key) ? '(.*)' : str_replace( array('\*\*', '\*'), array('(.+)', '([^.]*)'), preg_quote($key) ) ); return '/^' . $pattern . '$/i'; } public static function filterKeys($pattern, array $keys = array()) { $matched = preg_grep(self::getKeyRegexPattern($pattern), $keys); if (empty($matched)) { return null; } if (1 === count($matched)) { return array_shift($matched); } return array_values($matched); } }

पूरा पैकेज दो सरल वर्गों में फिट बैठता है, यह डिज़ाइन किए गए परीक्षण और संगीतकार-पैकेज के लिए आसान है।

क्या यह काम करता है?

यह प्रदर्शित करने के लिए कि ईवेंटेबल कैसे काम करता है और किन मामलों में यह उपयोगी हो सकता है, नीचे एक सरल उदाहरण है।

 require_once __DIR__ . '/../vendor/autoload.php'; $dispatcher = new Yowsa\Eventable\Dispatcher(); $teacher = 'Mrs. Teacher'; $children = ['Mildred', 'Nicholas', 'Kevin', 'Bobby', 'Anna', 'Kelly', 'Howard', 'Christopher', 'Maria', 'Alan']; // teacher comes in the classroom // and children welcome her once $dispatcher->once('teacher.comes', function($teacher) use ($children) { foreach ($children as $kid) { printf("%-12s- Hello, %s!\n", $kid, $teacher); } }); // every kid answers to teacher once foreach ($children as $kid) { $dispatcher->once("children.{$kid}.says", function() use ($kid) { echo "Hi {$kid}!\n"; }); } // boddy cannot stop to talk $dispatcher->on('children.Bobby.says', function() { echo "\tBobby: I want pee\n"; }); // trigger events echo "{$teacher} is entering the classroom.\n\n"; $dispatcher->trigger('teacher.comes', [$teacher]); echo "\n\n{$teacher} welcomes everyone personally\n\n"; $dispatcher->trigger('children.*.says'); for ($i = 0; $i < 5; $i++) { $dispatcher->trigger('children.Bobby.says'); }

Rezyultat

 Mrs. Teacher is entering the classroom. Mildred — Hello, Mrs. Teacher! Nicholas — Hello, Mrs. Teacher! Kevin — Hello, Mrs. Teacher! Bobby — Hello, Mrs. Teacher! Anna — Hello, Mrs. Teacher! Kelly — Hello, Mrs. Teacher! Howard — Hello, Mrs. Teacher! Christopher — Hello, Mrs. Teacher! Maria — Hello, Mrs. Teacher! Alan — Hello, Mrs. Teacher! Mrs. Teacher welcomes everyone personally Hi Mildred! Hi Nicholas! Hi Kevin! Hi Bobby! Bobby: I want pee Hi Anna! Hi Kelly! Hi Howard! Hi Christopher! Hi Maria! Hi Alan! Bobby: I want pee Bobby: I want pee Bobby: I want pee Bobby: I want pee Bobby: I want pee

शायद उपयोगी लिंक

द्वारा प्रेरित:

यह पता चला: