कोलाडा - संग्रह के साथ सुविधाजनक काम

कोलाडा PHP में संग्रह के साथ सुविधाजनक और सुरक्षित काम के लिए एक पुस्तकालय है।

यह, सबसे पहले, एक ऑब्जेक्ट-ओरिएंटेड स्टाइल (जो PHP में बॉक्स से काफी असुविधाजनक है) में काम करते हैं। गैर-परिवर्तनीय संग्रह, वैकल्पिक मानों (वैकल्पिक मान), किसी भी मान (और सिर्फ स्केलर नहीं) की मदद से एनपीई (नल पॉइंटर अपवाद) के खिलाफ नक्शों में सुराग के लिए सभी के बारे में हैं।

स्थापना

संगीतकार के माध्यम से पुस्तकालय को स्थापित करना उतना ही सरल है ... इसे एक गिट उपमॉडल के रूप में कैसे जोड़ा जाए :)

{ "require": { "alexeyshockov/colada": "dev-master" } } 

 $ git submodule add git://github.com/alexeyshockov/colada.git vendor/colada 

संग्रह

स्थापना के बाद कोलाडा का उपयोग कैसे करें? कई विकल्प हैं, जिनमें से सबसे सरल: एक नियमित सरणी से एक संग्रह बनाते हैं, जो ज्यादातर मामलों में पहले से ही उपलब्ध है, और जिसके साथ आपको कुछ संशोधन करने की आवश्यकता है:

 $counts = to_collection(array(2, 3, 50, 36)); $users = to_set(array('label1', 'label2', 'label3')); 

यदि आपके पास सभी आवश्यक तत्व हैं, तो आप स्वयं एक संग्रह भी बना सकते हैं:

 $counts = collection(2, 3, 50, 36); $users = set('label1', 'label2', 'label3'); 

लगभग मानक सरणी () की तरह!

mapBy (), acceptBy () / rejectBy (), foldBy ()

संग्रह के साथ काम करने की कार्यात्मक शैली का एक अच्छा वर्णन पहले से ही लेख में बहुत अच्छी तरह से दिया गया है " छोरों के लिए क्या गलत है? "। कोलाडा के नक्शे में, स्वीकार / अस्वीकार और गुना का बिल्कुल वही अर्थ है जो संग्रह के साथ काम करने के लिए अन्य सभी पुस्तकालयों में है (अंडरस्कोर। जेएस, स्काला कलेक्शंस, आदि)।

एक उदाहरण पर विचार करें:

 $saleCount = $users ->acceptBy(x()->isActive()) ->mapBy(x()->getSales()) ->foldBy(function($count, $posts) { return $count + count($posts); }, 0); 

मुझे उम्मीद है कि ऊपर दिया गया कोड अपने लिए बोलता है, और पढ़ने के दौरान इसका अर्थ स्पष्ट है, अपवाद के साथ ... किस तरह का x ()?

x ()

जिनके पास स्काला या इसी तरह की भाषा में प्रोग्रामिंग का अनुभव है, जिसमें क्लोजर के साथ काम करना शुरू में संभव के रूप में सुविधाजनक बनाया गया था, यह परिचित लग सकता है।

स्केला:

 val emails = users.map(x.getEmail()); 

PHP (कोलाडा):

 $emails = $users->mapBy(x()->getEmail()); 

PHP में, स्कैल्स की तुलना में क्लोजर के साथ काम करना थोड़ा अधिक वर्बोज़ है। लेकिन ज्यादातर मामलों के लिए, जब आपको संग्रह में किसी ऑब्जेक्ट पर बस गेटटर को कॉल करने की आवश्यकता होती है, तो सब कुछ सरल किया जा सकता है, जैसा कि ऊपर दिखाया गया है।

x () संग्रह का भविष्य तत्व है। इसका उपयोग करना एक साधारण क्लोजर के बराबर है:

 $emails = $users->mapBy(function($user) { return $user->getEmail() }); 

क्या आप अभी भी हर छोटी चीज़ के लिए एक बंद लिख रहे हैं? फिर हम आपके पास जाते हैं! ;)

हशी (उर्फ नक्शे)

यदि संग्रह केवल तत्वों का संग्रह है, तो हैश प्रमुख / मूल्य जोड़े हैं जो हम भी हर दिन मुठभेड़ करते हैं। नियमित संग्रह के साथ, हम एक हैश बना सकते हैं

 $users = to_map(array('managers' => array(1, 3), 'users' => array(2, 3, 4))); 

और इसके साथ एक ऑब्जेक्ट-ओरिएंटेड शैली में काम करते हैं, परिचित मैपबी () और एक्सेप्टबाय () / रिजेक्टबी (), साथ ही अन्य उपयोगी और सुविधाजनक तरीकों का उपयोग करके: मैपएलाइज़बाय (), फ्लिप (), पिक ()।

किसी ने कहा कि एक कोड लिस्टिंग कभी-कभी एक हजार शब्दों से बेहतर होती है:

 $usersByGroups = $users ->mapBy(x()->isActive()) ->groupBy(x()->getGroup()) ->mapElementsBy(x()->count()); foreach ($groups as $group) { echo 'Group "'$group->getName().'" contains '.$usersByGroups->get($group)->orElse(0).' users.'; echo "\n"; } 

ऊपर दिए गए कोड में, आप एक विशेषता देख सकते हैं: संग्रह और हैश के साथ काम करने वाले "चीनी" तरीकों के अलावा, मानचित्र :: get () कुंजी द्वारा मूल्य वापस नहीं करता है, लेकिन कुछ विकल्प वर्ग का एक आवरण वस्तु, जिसका मैंने पहले उल्लेख नहीं किया था वर्तमान क्षण।

वैकल्पिक मूल्य

सर एंथनी होयर, जिन्हें NULL मूल्यों को पेश करने का श्रेय दिया जाता है, ने एक बार कहा था:

मैं इसे अपनी अरबों डॉलर की गलती कहता हूं।

एनपीई (नल सूचक अपवाद) के खिलाफ सुरक्षा के विषय पर, बहुत सारे शब्द कहे गए और कई समाधानों का आविष्कार किया गया। उनमें से एक तथाकथित वैकल्पिक मूल्यों की शुरूआत है। कुछ भाषाओं में, वे शुरू में मौजूद हैं: हास्केल में, हो सकता है, स्काला में, यह विकल्प है। अन्य भाषाओं के लिए पुस्तकालय हैं, जैसे कि जावा के लिए Google अमरूद से वैकल्पिक ।

कोलाडा में वैकल्पिक मान उनके स्काला समकक्ष के समान हैं। कुछ का अर्थ है मूल्य की उपस्थिति, कोई भी इसका अभाव नहीं है। उपयोग में, वैकल्पिक मूल्य संग्रह के समान हैं (सरलीकरण, आप सोच सकते हैं कि एक या शून्य तत्वों का संग्रह वापस आ गया है):

 echo ": "; echo $user->getCity()->mapBy(x()->getName())->orElse('-'); 

ऊपर दिए गए उदाहरण से पता चलता है कि डोमेन मॉडल की कक्षाओं में वैकल्पिक मूल्य कैसे लागू किया जा सकता है। इस मामले में, उपयोगकर्ता के शहर के साथ काम करते समय, हम यह कभी नहीं भूलेंगे कि यह भरा नहीं जा सकता है। उसी तरह, हम यह कभी नहीं भूलेंगे कि इस हैश में अनुरोधित कुंजी बिल्कुल भी मौजूद नहीं हो सकती है।


वैकल्पिक मूल्यों का उपयोग एक व्यापक विषय है, जिसका विस्तृत विवरण एक अलग लेख का मामला है।

प्रदर्शन और स्मृति उपयोग

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

फिर भी, इस स्थिति में भी, परिणाम मेरे खुद के लिए, मेरी राय में काफी था। संग्रह को लागू करने के लिए SplFixedArray का उपयोग करने के लिए धन्यवाद, नियमित सरणियों की तुलना में मेमोरी का उपयोग और भी कम है:


काम की गति के संबंध में, कोई चमत्कार नहीं हैं - आपको प्रयोज्य के लिए भुगतान करना होगा ... खोज (संग्रह :: (), मैप :: गेट () ...), साथ ही साथ शेष बन्स को माथे में लागू किया जाता है और स्वाभाविक रूप से, तत्वों की विस्तारित तुलना। अंतर्निहित एनालॉग्स की तुलना में धीमी गति से काम करना। लेकिन सब कुछ आपकी मदद से बेहतर सहित बदल सकता है;)

लेकिन यहां कुछ ऐसा है जो पहले से ही अनुकूलित है, और आपको इसे याद रखने और उपयोग करने से डरने की ज़रूरत नहीं है - मैपबी से रूपांतरण श्रृंखला () और स्वीकार () / अस्वीकार () डिफ़ॉल्ट रूप से आलसी हैं! यह उन लोगों से बहुत परिचित है जिनके पास कार्यात्मक भाषाओं में प्रोग्रामिंग का अनुभव है, और उदाहरण में स्पष्ट रूप से देखा जा सकता है:

 $emails = $users ->acceptBy(x()->isActive()) ->mapBy(x()->getEmail()); 

इस कोड में, उपयोगकर्ता संग्रह के माध्यम से मार्ग केवल एक ही होगा, दो नहीं, जैसा कि आप सोच सकते हैं। अधिक सटीक रूप से, ऊपर दिए गए कोड में यह बिल्कुल भी मौजूद नहीं होगा। मार्ग तभी पूरा होगा जब नए संग्रह के तत्वों की वास्तव में आवश्यकता हो:

 $emails = $users ->acceptBy(x()->isActive()) ->mapBy(x()->getEmail()); foreach ($emails as $email) { echo $email; } 

"प्रतियोगियों"

स्काला भाषा (स्काला कलेक्शंस) और अंडरस्कोर.जेएस लाइब्रेरी से प्रेरित होकर, शुरू से ही मैं कल्पना नहीं कर सकता था कि PHP के लिए ऐसा कुछ मौजूद नहीं था। लेकिन या तो मैं बुरी तरह से देख रहा था, या वास्तव में विकास के समय कोई समाधान नहीं थे जो PHP में समान सुविधा प्रदान करते थे।

फिर भी, कुछ घटनाक्रम हैं और मैं उन्हें यहां लाना चाहूंगा ताकि हर कोई तुलना कर सके और सही उपकरण चुन सके।

तो, इंटरनेट पर क्या है:

• डॉक्ट्रिन कॉमन में संग्रह संग्रह के साथ काम करने के लिए एक सहायक आवरण है, जो डॉक्ट्रिन परियोजनाओं में आंतरिक उपयोग के लिए विकसित किया गया है और विशेष रूप से उनके बाहर नहीं जाना जाता है। यह वास्तव में, किसी भी अतिरिक्त गुणों (अपरिवर्तनीय, गैर-स्केलर कुंजियों, आदि) के बिना एक स्टार्ट-अप सरणी पर एक साधारण वस्तु-उन्मुख आवरण प्रदान करता है।
• Underscore.php PHP के लिए Underscore.js का एक सीधा एनालॉग है, मेरी राय में, व्यावहारिक रूप से भाषा की बारीकियों को ध्यान में रखे बिना।
• Rmk-Framewrok (हैबे पर वर्णन के साथ) - हमारे हमवतन से एक उल्लेखनीय विकास, मुख्य रूप से विभिन्न डेटा संरचनाओं को प्रदान करने पर केंद्रित है जो डिफ़ॉल्ट रूप से PHP में लागू नहीं होते हैं। पुस्तकालय में शुरू में कोलाडा की तुलना में एक अलग उद्देश्य है, इसलिए यह प्रयोज्य की एक व्यक्तिपरक तुलना के साथ खो देता है।

निष्कर्ष में

उपयोगी (संभवतः) लिंक:

• github.com/alexeyshockov/colada - स्रोत कोड (पुल अनुरोधों का स्वागत है)
• alexeyshockov.github.com/colada - एपीआई प्रलेखन

पुनश्च

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