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

LINQ क्यों?

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

var q = from c in db.Customers where c.Activity == 1 select new { c.CompanyName, c.ItemID, c.ItemName }; 

C # में, इस सिंटैक्स का समर्थन भाषा स्तर पर अंतर्निहित है, हालांकि वास्तव में यह सिंटैक्टिक चीनी है, जो निम्नलिखित रूप में अनुवाद करता है

 var q = db.Customers. Where((c) => c.Activity == 1). Select((c) => { c.CompanyName, c.ItemID, c.ItemName }); 

यहां डेटा अनुक्रमों पर Where और Select कार्य परिभाषित किए गए हैं, लेकिन प्रसंस्करण तर्क एकल तत्व के लिए निर्धारित है। कार्यात्मक प्रोग्रामिंग की भावना में निर्मित - सब कुछ एक फ़ंक्शन है और फ़ंक्शन की गणना करने का परिणाम केवल इनपुट मापदंडों पर निर्भर करता है। कार्यों की शुद्धता के लिए आवश्यकता साइड इफेक्ट्स के कारण त्रुटियों के एक पूर्व उन्मूलन की अनुमति देती है। अन्य प्लस हैं:

• चूंकि प्रसंस्करण का क्रम महत्वपूर्ण नहीं है, इसलिए सेट पर प्रसंस्करण समानांतर में किया जा सकता है।
• स्थानीय गणना के बजाय, LINQ क्वेरीज़ को नियमित SQL डेटाबेस प्रश्नों में (आंशिक रूप से शामिल) ध्वस्त किया जा सकता है। बाह्य रूप से अनुरोध वही रहता है।
• एक व्यक्तिगत तत्व का प्रसंस्करण तर्क अलग-थलग है। इसे अन्य संग्रह के लिए पुन: उपयोग किया जा सकता है या दूसरों के साथ जोड़ा जा सकता है।

PHP में एक ही टूल का होना अच्छा होगा। यह अच्छा होगा, जैसा कि C # में, बिना किसी अतिरिक्त कम्प्यूटेशनल ओवरहेड के। और यद्यपि ऐसे पुस्तकालय हैं, प्रत्येक इस कार्यक्षमता को एक अलग तरीके से लागू करता है। कारण यह है कि आसानी से उपयोग किया जाने वाला LINQ कार्यान्वयन कई सी # सुविधाओं पर आधारित है, जिन्हें PHP की आवश्यकता नहीं है और नकल करने की आवश्यकता है। और फिर हर किसी का स्वाद अलग होता है।

नकल क्यों नहीं हो सकती?

हम यह देखते हैं कि पहली नज़र में C # की क्या विशेषताएं PHP में लाइब्रेरी की प्रतिलिपि बनाने के लिए पर्याप्त नहीं हैं।

• ढीला टाइपिंग । बल्कि यह एक फायदा है।
• कोई अधिभार विधियाँ। यह पिछले पैराग्राफ का परिणाम है। उदाहरण के लिए, यदि आपको स्ट्रिंग्स, सरणियों और ऑब्जेक्ट्स की तुलना करने की आवश्यकता है, तो आपको cmpString , cmpArray , cmpLaptop नाम के साथ तीन अलग-अलग फ़ंक्शन लिखने और यदि एक बड़े एक के अंदर रखने की आवश्यकता है। दोनों समाधान खराब हैं। पहले मामले में, नाम में "कोड ऊपर" जहां कोड इन कार्यों का उपयोग किया जाता है में जानकारी। दूसरे मामले में, कार्यक्षमता का विस्तार करना मुश्किल है।
• कोई क्लास एक्सटेंशन नहीं। आप एक विधि नहीं लिख सकते हैं और इसे कॉल नहीं कर सकते हैं जैसे कि यह किसी अन्य वर्ग की एक विधि है, अर्थात, आप IEnumerable <T> को केवल अपने नामस्थान से जोड़कर नहीं बढ़ा सकते हैं। लेकिन PHP में एक मैजिक __call मेथड है जिसके माध्यम से आप कहीं और लागू किए गए स्टैटिक मेथड को कॉल कर सकते हैं। सच है, आपको वांछित वर्ग को संशोधित करने की आवश्यकता है, लेकिन यह हमेशा संभव नहीं है। आईडीई में समर्थन के बारे में भूलना भी लायक है।
• अच्छा रिटर्न उपज के साथ कोई जनरेटर नहीं (php <5.5)। एक ओर, यह श्लेष्म शर्करा है। आप एक फ़ंक्शन लिख सकते हैं जो \Iterator लौटाता है, जो next() एक अनाम फ़ंक्शन को कॉल करेगा जो अगले तत्व के मूल्य की गणना करेगा और वर्ग विशेषताओं में अपने राज्य को बचाएगा। लेकिन कोड का आकार कई गुना बढ़ जाएगा, और इसका उपयोगी हिस्सा गिर जाएगा। जेनरेटर 5.5 संस्करण में दिखाई दिए, लेकिन इस संस्करण के लोकप्रिय होने तक प्रतीक्षा करने में लंबा समय लगता है।
• कोई लंबोदर भाव नहीं। ये ऐसे छोटे अनाम कार्य हैं जिनकी कार्यक्षमता सीमित है, लेकिन संरचना के बारे में जानकारी संरक्षित है। एसक्यूएल के कार्यों की प्रतीकात्मक रूप से गणना करने या किसी अन्य भाषा में एक अभिव्यक्ति को निर्यात करने के लिए इसका उपयोग किया जा सकता है, कहते हैं, एसक्यूएल। आप PHP में एक अनाम फ़ंक्शन लिख सकते हैं, लेकिन आपको इसकी संरचना के बारे में जानकारी नहीं होगी और तदनुसार, एसक्यूएल के लिए कोई निर्यात नहीं होगा।
• कोई ऑपरेटर अधिभार नहीं। इसके अलावा, आप $f = (Exp::x()+1) * 2 जैसे कुछ लिखकर एक लैम्ब्डा अभिव्यक्ति को खूबसूरती से अनुकरण करने में सक्षम नहीं होंगे और Exp::x() विधि द्वारा लौटाए गए वर्ग के लिए जोड़ और गुणा कार्यों को ओवरलोड करना, Closure से वंशज ।

मामूली अंतरों का एक गुच्छा होता है, जैसे कि यह तथ्य कि भाषाओं में संग्रह के साथ काम करने के लिए आधार वर्गों को अलग-अलग कहा जाता है ( IEnumerator Iterator बन गया, IEnumerable IteratorAggregate बन गया), या कि PHP सरणियों में कोई विधि नहीं है, लेकिन यह सब आसानी से हल हो गया है।

क्या करें? क्या किया जाता है

काम शुरू करने से पहले, मैंने विशेष रूप से C # की छाप के तहत लिखने के लिए अन्य समाधानों की तलाश नहीं की, और अन्य लोगों के कार्यान्वयन से नहीं। पहला विकल्प कुछ शाम में लिखा गया था। फिर उन्होंने लंबे समय तक MSDN से सभी मानक विधियों को स्थानांतरित किया, अतिरिक्त कार्यक्षमता को काट दिया, तर्क के अनुसार .NET लाया। वर्ष की शुरुआत में, मैंने अन्य परियोजनाओं में क्षमताओं की तुलना की, कोड को फिर से काम किया, जीथब पर प्रोजेक्ट प्रकाशित किया। विकास के दौरान, मुख्य जोर निम्नलिखित बिंदुओं पर रखा गया था।

Iterators सब कुछ हैं और सब कुछ iterators हैं

जटिल लूप के बजाय, सरणी से सरणी में कॉपी करना, पुस्तकालय पुनरावृत्तियों के साथ काम करता है। PHP 5.5 से पहले, एक पुनरावृत्त को संसाधित करने के लिए, एक वर्ग लिखना आवश्यक था जो \Iterator इंटरफ़ेस को लागू करता है और इसे इनपुट पैरामीटर के रूप में संसाधित \Iterator लिए constructor \Iterator पास करता है।

 $data = new \ArrayIterator([1,2,3]); $even = new \CallbackFilterIterator($data, function ($item) { return $item % 2 == 0; } ); 

वर्तमान पुनरावृत्तियों से डेटा पढ़ते समय, डेटा को मूल पुनरावृत्तियों से खींचना और संसाधित करना शुरू होता है। चलने वाले पुनरावृत्तियों का ओवरहेड न्यूनतम प्रतीत होता है। ठेठ अनुक्रम प्रसंस्करण कार्यों के लिए 15 से अधिक पुनरावृत्तियों को लागू किया गया है।

• CallbackFilterIterator - फ़िल्टरिंग आइटम
• CallbackIterator - एक फ़ंक्शन द्वारा एक अनंत अनुक्रम उत्पन्न करना
• डिस्टिक्टिलेटर - अद्वितीय तत्व जारी करना
• सिवाय इक्वेटोरेटर, इंटेरसेक्टेरेटर - घटाव, दो अनुक्रमों का प्रतिच्छेदन
• GroupingIterator - कुंजी द्वारा समूहीकरण
• IndexIterator - कुंजी द्वारा आइटम छांटना
• JoinIterator, OuterJoinIterator - सख्त, कुंजी द्वारा दो अनुक्रमों के सख्त बंधन नहीं
• सीमांतक - क्रम की एक श्रृंखला जारी करना
• ProductIterator - कई पुनरावृत्तियों के क्रॉस-उत्पाद
• प्रोजेक्शनइंटरेटर - तत्वों का प्रक्षेपण (कुंजी)
• ReverseIterator - उलटा क्रम
• SkipIterator - हालत सच है, जबकि लंघन तत्वों
• TakeIterator - तत्वों का मुद्दा जबकि स्थिति सच है
• LazyIterator एक सार वर्ग है। जब तत्व पहली बार पढ़ा जाता है, तो एक इटरेटर बनाया जाता है।
• VariableIterator - इट्रेटर खोलने के बाद मूल इटरेटर बदल सकता है

Iterators को LINQ कार्यक्षमता के बाकी हिस्सों से स्वतंत्र रूप से उपयोग किया जा सकता है, उन्हें एक अलग नामस्थान पर भी ले जाया जाता है।

आलसी कंप्यूटिंग भी काम करता है

यदि LINQ विधियों में अनाम फ़ंक्शन को एक अभिव्यक्ति के रूप में पारित किया जाता है, तो यह उच्चतम निष्पादन गति, सुंदर हाइलाइटिंग और आईडीई में रिफैक्ट करने की क्षमता देता है, लेकिन अभिव्यक्ति की संरचना के बारे में जानकारी खो जाती है। यह एसक्यूएल को अन्य प्रोग्रामिंग भाषा में अभिव्यक्ति को फिर से संगठित करने की अनुमति नहीं देता है। लंबोदर भाव के विपरीत। इस समस्या को हल करने के लिए, कई लेखक "अभिव्यक्ति" के रूप में वैध PHP कोड की एक स्ट्रिंग पास करते हैं। SQL के प्रत्येक तत्व के लिए एक स्ट्रिंग का उपयोग करके मूल्यांकन किया जाता है और एक मौका है कि इसे किसी अन्य भाषा में पुन: स्वरूपित किया जा सकता है, SQL कहते हैं। कुछ अपने स्वयं के स्ट्रिंग प्रारूप के साथ आते हैं, उदाहरण के लिए $x ==> $x*$x । इस स्थिति में, आईडीई में कोड हाइलाइटिंग और रिफैक्टिंग खो जाता है, निष्पादन लंबा है, कोड कैश नहीं है और सुरक्षित नहीं है।

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

 $exp = new ExpressionBuilder(); $exp->add(1); $exp->add('+',1); $exp->add(2); $exp->export(); // [1, 2, 2, '+'] 

परिचालन प्राथमिकताओं और कोष्ठकों का समर्थन किया जाता है। Expression क्लास अनलोड किए गए ऐरे से चलती है और, यदि यह डेटा का सामना करती है, तो इसे स्टैक पर फेंकता है, और यदि यह टाइप OperationInterface ऑब्जेक्ट का सामना करता है, तो यह इस पर नियंत्रण स्थानांतरित करता है। ऑब्जेक्ट स्टैक से आवश्यक संख्या में तर्क लेता है, परिणाम की गणना करता है और स्टैक पर वापस फेंकता है। स्टैक के अंत में, एक मान रहता है - परिणाम। उच्च स्तर पर, LambdaInstance क्लास और इसके Lambda डेकोरेटर का उपयोग करके भाव बनाए जाते हैं। अवसरों के उदाहरण।

1. तर्क, स्थिरांक तक पहुंच
   

    /*   */ $f = Lambda::v(); $f = function ($x) { return $x; }; 

2. गणितीय संचालन, तुलना संचालन, तार्किक संचालन
   

    $f = Lambda::v()->add()->v()->mult(12)->gt(36); $f = function ($x) { return $x + $x*12 > 36; }; 

3. कोष्ठक
   

    $f = Lambda::v()->mult()->begin()->c(1)->add()->v()->end(); $f = function ($x) { return $x * (1 + $x); }; 

4. स्ट्रिंग ऑपरेशन
   

    $f = Lambda::v()->like('hallo%'); 

5. सरणी पीढ़ी
   

    $f = Lambda::complex([ 'a'=>1, 'b'=>Lambda::v() ]); $f = function ($x) { return [ 'a' => 1, 'b' => $x ]; }; 

6. ऑब्जेक्ट गुणों और विधियों, सरणी तत्वों तक पहुंच
   

    $f = Lambda::v()->items('car'); $f = Lambda::v()->getCar(); $f = Lambda::car; $f = function ($x) { return $x->getCar(); }; 

7. वैश्विक कार्यों को बुलाओ
   

    $f = Lambda::substr(Lambda::v(), 3, 1)->eq('a'); $f = function ($x) { return substr($x,3,1) == 'a'; }; 

8. मानों के लिए LINQ विधियाँ
   

    $f = Lambda::v()->linq()->where(Lambda::v()->gt(1)); $f = function (\Iterator $x) { return new CallbackFilterIterator($x, function ($x) { return $x > 1; }); }; 

बेशक, मेमने के भावों की गणना करते समय, अतिरिक्त साइड ऑपरेशन किए जाते हैं। फ़ंक्शन (x)=>x+1 , फ़ंक्शन की प्रत्यक्ष कॉल की तुलना में Lambda गणना की गति 15 गुना धीमी है, और संरचना को केवल 3600 बाइट्स मेमोरी बनाम 800 की आवश्यकता होती है। यह एक प्रॉइलर के साथ विश्लेषण करने की योजना है कि गति कैसे बढ़ाएं और मेमोरी कम करें।

इंटरफ़ेस पर मिलो, और कार्यान्वयन पर देखें

सभी LINQ विधियाँ मानक .NET 4.5 से ली गई हैं और MSDN से विवरण के साथ संबंधित इंटरफेस ( GenerationInterface इन्टरफेस, FilteringInterface इन्टरफेस, आदि) पर बिखरी हुई हैं। यह बहुत सारी फाइलें निकला, लेकिन पार्सिंग फाइलों पर अतिरिक्त भार बड़ा नहीं होना चाहिए, खासकर अगर कैशिंग सक्षम है। PHP की क्षमताओं को देखते हुए विधियों का हस्ताक्षर यथासंभव अपरिवर्तित रहा है। IEnumerable इंटरफ़ेस सभी उल्लिखित इंटरफ़ेस और \IteratorAggregate इनहेरिट करता है। Linq वर्ग स्थानीय गणना के लिए IEnumerable इंटरफेस को लागू करता है। भविष्य में, आप IEnumerable का एक और कार्यान्वयन कर सकते हैं, जो एसक्यूएल क्वेरी एकत्र करेगा या डॉक्ट्रिन का एक मुखौटा होगा। निम्नलिखित विधियों को लागू किया जाता है।

• एकत्रीकरण - कुल, औसत, न्यूनतम, अधिकतम, योग, गिनती
• समास - समास, जिप
• एलिमेंट - एलिमेंटएट, एलिमेंटअटऑर्डफ़ॉल्ट, फ़र्स्ट, फ़र्स्टऑर्फ़ॉल्ट, लास्ट, लास्टऑर्फ़ॉल्ट, सिंगल, सिंगलऑर्फ़ॉल्ट
• समानता - इक्वेल
• छानना - ofType, जहाँ
• जनरेशन - से, रेंज, रिपीट
• समूहीकरण - groupBy
• जुड़ना - उत्पाद, शामिल होना, joinOuter, groupJoin
• विभाजन - छोड़ें, छोड़ें, ले जाएँ, ले जाएँ, ले जाएँ
• प्रोजेक्शन - चयन करें, चयन करें, कास्ट करें
• क्वांटिफायर - सभी, किसी भी, में शामिल है
• सेट - अलग, प्रतिच्छेदन, संघ को छोड़कर
• सॉर्टिंग - ऑर्डरबाय, ऑर्डरबायस्केंडिंग, फिरबाय, फिरबायस्केंडिंग, रिवर्स, ऑर्डर
• अन्य - toArray, toList, प्रत्येक

यदि विधि को डेटा स्रोत निर्दिष्ट करना होगा, तो यह एक सरणी ( array ), एक फ़ंक्शन ( callable ), या एक इटरेटर ( \Iterator , \IteratorAggregate ) हो सकता है। इसी तरह, एक अभिव्यक्ति को एक स्ट्रिंग, एक फ़ंक्शन ( callable ), एक सरणी ( array ), या एक लैम्ब्डा अभिव्यक्ति ( \LambdaInterface ) पारित किया जा सकता है। नीचे कुछ उदाहरण दिए गए हैं, विभिन्न प्रकार के यूनिट परीक्षण भी हैं ।

 // Grouping+Sorting+Filtering+array expression $x = Linq::from($cars)->group(Lambda::v()->getCategory()->getId())->select([ 'category' => Lambda::i()->keys(), 'best' => Lambda::v()->linq() ->where(Lambda::v()->isActive()->eq(true)) ->orderBy(Lambda::v()->getPrice()) ->last() ]) // Set + LambdaInterface expression $x = Linq::from($cars)->distinct(Lambda::v()->getCategory()->getTitle()); // Set + string expression $x = Linq::from($cars)->distinct('category.title'); // Generation+callable $fibonacci = function () { $position = 0; $f2 = 0; $f1 = 1; return function () use (&$position, &$f2, &$f1) { $position++; if ($position == 1) { return $f2; } elseif ($position == 2) { return $f1; } else { $f = $f1 + $f2; $f2 = $f1; $f1 = $f; return $f; } } } $x = Linq::from($fibonacci)->take(10); 

एक फ़ंक्शन जो किसी फ़ंक्शन को लौटाता है जो एक फ़ंक्शन लौटाता है ...

प्रत्येक LINQ विधि Linq वर्ग का एक ऑब्जेक्ट बनाता है, जो एक प्रारंभिक अनाम फ़ंक्शन और अन्य Linq ऑब्जेक्ट्स के लिए एक लिंक पारित किया जाता है, जिनमें से पुनरावृत्तियों शुरुआती फ़ंक्शन के लिए इनपुट डेटा हैं। चूंकि Linq \IteratorAggregate लागू करता \IteratorAggregate , पुनरावृत्तियों को स्वचालित रूप से श्रृंखला में प्रारंभ किया जाता है जब पहला तत्व अनुरोध किया जाता है।

यह सब क्यों?

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

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