जैसा कि आप PHP के लिए LINQ पुस्तकालयों की तुलना करने वाले मेरे पिछले लेख से देख सकते हैं, बहुत सारे पुस्तकालय हैं, और गुणवत्ता कम है: किसी भी पुस्तकालय में आलसी गणना लागू नहीं होती है, आधे मामलों में परीक्षण होते हैं, कॉलबैक के प्रकार सीमित हैं, और कभी-कभी यह पूरी तरह से अस्पष्ट है कि LINQ का क्या अर्थ है । इसलिए मैंने अपनी लाइब्रेरी लिखी। मिलिए:

YaLinqo - फिर भी PHP के लिए वस्तुओं के लिए एक और LINQ

विशेषताएं:

PHP में सबसे व्यापक .NET LINQ पोर्ट, कई अतिरिक्त तरीकों के साथ। कुछ तरीके गायब हैं, लेकिन काम जारी है। कुल मिलाकर, 70 से अधिक तरीके लागू किए गए हैं।
आलसी गणना, पाठ अपवाद, और बहुत कुछ, जैसा कि मूल LINQ में है।
प्रत्येक विधि के लिए विस्तृत PHPDoc प्रलेखन। MSDN से अनुकूलित लेखों का पाठ।
100% यूनिट टेस्ट कवरेज।
कॉलबैक को कई सिंटैक्स के समर्थन के साथ स्ट्रिंग्स और सरणियों, स्ट्रिंग "लैम्ब्डा" के रूप में क्लोजर, "एक फ़ंक्शन को इंगित करता है" द्वारा परिभाषित किया जा सकता है।
मानों पर कुंजी के रूप में अधिक ध्यान दिया जाता है: परिवर्तनों को दोनों पर लागू किया जा सकता है; अधिकांश कॉलबैक दोनों को स्वीकार करते हैं; यदि संभव हो, तो रूपांतरणों के दौरान चाबियाँ खो नहीं जाती हैं।
साइकिल का न्यूनतम आविष्कार: Iterator, IteratorAggregate, आदि का उपयोग पुनरावृत्ति के लिए किया जाता है (और इन्यूमर के साथ उनका उपयोग किया जा सकता है); जब भी संभव हो, अपवादों को देशी हैंग-अप आदि द्वारा उपयोग किया जाता है।

कोड उदाहरण:

//     ,    , //   .      ,   . from($categories) ->orderBy('$v["name"]') ->groupJoin( from($products) ->where('$v["quantity"] > 0') ->orderByDescending('$v["quantity"]') ->thenBy('$v["name"]'), '$v["id"]', '$v["catId"]', 'array("name" => $v["name"], "products" => $e)' );

लागू किए गए तरीके

जनरेशन: चक्र, खालीइनेम (खाली), से, उत्पन्न, Infinity, toNegativeInfinity, मैच, returnEnum (वापसी), रेंज, रेंजडाउन, रेंजटो, रिपीट, स्प्लिट;
प्रोजेक्शन, फ़िल्टरिंग: टाइप, सेलेक्ट, सिलेक्ट मेनी, जहाँ;
समूहीकरण, कनेक्शन: groupJoin, join, groupBy;
एकत्रीकरण: समुच्चय, समुच्चयबोधक, औसत, गिनती, अधिकतम, maxBy, मिनट, minBy, योग;
सेट: सभी, किसी भी, समाहित;
पेजिंग: elementAt, elementAtOrDefault, First, FirstOrDefault, firstOrFallback, last, lastOrDefault, lastOrFallback, single, singleOrDefault, singleOrFallback, indexOf, lastIndexOf, findLastIndexex
रूपांतरण: toArray, toArrayDeep, toList, toListDeep, toprise, toJSON, toLookup, toKeys, toValues, toObject, toString;
क्रिया: कॉल (करना), प्रत्येक (फॉरएच), लिखना, लिखना।

उदाहरण

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

प्रारंभिक डेटा (या तो डेटाबेस से, या कुछ JSON सेवा से, या "आयरन" स्थिरांक, या कुछ अन्य स्रोत):

 $products = array( array('name' => 'Keyboard', 'catId' => 'hw', 'quantity' => 10, 'id' => 1), array('name' => 'Mouse', 'catId' => 'hw', 'quantity' => 20, 'id' => 2), array('name' => 'Monitor', 'catId' => 'hw', 'quantity' => 0, 'id' => 3), array('name' => 'Joystick', 'catId' => 'hw', 'quantity' => 15, 'id' => 4), array('name' => 'CPU', 'catId' => 'hw', 'quantity' => 15, 'id' => 5), array('name' => 'Motherboard', 'catId' => 'hw', 'quantity' => 11, 'id' => 6), array('name' => 'Windows', 'catId' => 'os', 'quantity' => 666, 'id' => 7), array('name' => 'Linux', 'catId' => 'os', 'quantity' => 666, 'id' => 8), array('name' => 'Mac', 'catId' => 'os', 'quantity' => 666, 'id' => 9), ); $categories = array( array('name' => 'Hardware', 'id' => 'hw'), array('name' => 'Operating systems', 'id' => 'os'), );

वास्तव में, कार्य: गैर-शून्य मात्रा वाले उत्पादों को फ़िल्टर करने के लिए, उपयुक्त श्रेणियों में रखा गया है। मात्रा के अवरोही क्रम में पहले उत्पादों को क्रमबद्ध करें, फिर नाम से। नाम से छांटे गए श्रेणियाँ। आपको निम्नलिखित प्राप्त करना चाहिए (संक्षिप्तता के लिए सुधारित):

 Array ( [hw] => Array ( [name] => Hardware [products] => Array ( [0] => Array ( [name] => Mouse [catId] => hw [quantity] => 20 [id] => 2 ) [1] => Array ( [name] => CPU [catId] => hw [quantity] => 15 [id] => 5 ) [2] => Array ( [name] => Joystick [catId] => hw [quantity] => 15 [id] => 4 ) [3] => Array ( [name] => Motherboard [catId] => hw [quantity] => 11 [id] => 6 ) [4] => Array ( [name] => Keyboard [catId] => hw [quantity] => 10 [id] => 1 ) ) ) [os] => Array ( [name] => Operating systems [products] => Array ( [0] => Array ( [name] => Linux [catId] => os [quantity] => 666 [id] => 8 ) [1] => Array ( [name] => Mac [catId] => os [quantity] => 666 [id] => 9 ) [2] => Array ( [name] => Windows [catId] => os [quantity] => 666 [id] => 7 ) ) ) )

निम्नलिखित PHP 5.3 से क्लोजर का उपयोग करके एक उदाहरण है। सबसे लंबा रिकॉर्ड, लेकिन विभिन्न प्रकार के आईडीई में सबसे अच्छा समर्थन।

 from($categories) ->orderBy(function ($cat) { return $cat['name']; }) ->groupJoin( from($products) ->where(function ($prod) { return $prod["quantity"] > 0; }) ->orderByDescending(function ($prod) { return $prod["quantity"]; }) ->thenBy(function ($prod) { return $prod["name"]; }), function ($cat) { return $cat["id"]; }, function ($prod) { return $prod["catId"]; }, function ($cat, $prods) { return array("name" => $cat["name"], "products" => $prods); } );

स्ट्रिंग लैम्ब्डा का उपयोग करके रिकॉर्डिंग। ऑपरेटर के बाईं ओर "==>" तर्क नाम हैं, दाईं ओर वापसी मान है।

 from($categories) ->orderBy('$cat ==> $cat["name"]') ->groupJoin( from($products) ->where('$prod ==> $prod["quantity"] > 0') ->orderByDescending('$prod ==> $prod["quantity"]') ->thenBy('$prod ==> $prod["name"]'), '$cat ==> $cat["id"]', '$prod ==> $prod["catId"]', '($cat, $prods) ==> array("name" => $cat["name"], "products" => $prods)' );

और अंत में, सबसे छोटी प्रविष्टि। यदि कोई ऑपरेटर "==>" नहीं है, तो डिफ़ॉल्ट चर नामों का उपयोग किया जाता है: मूल्य के लिए v, कुंजी के लिए k, और a, मानों के लिए तुलनात्मक मान आदि।

 from($categories) ->orderBy('$v["name"]') ->groupJoin( from($products) ->where('$v["quantity"] > 0') ->orderByDescending('$v["quantity"]') ->thenBy('$v["name"]'), '$v["id"]', '$v["catId"]', 'array("name" => $v["name"], "products" => $e)' );

(संदेहपूर्ण) वास्तु समाधान

आप मूल LINQ को एक-एक करके कॉपी नहीं कर सकते हैं: विभिन्न भाषाएँ, विभिन्न सुविधाएँ, विभिन्न सुविधाएँ। इसलिए, अक्सर एक विकल्प बनाना पड़ता था। आपके लिए न्याय करना कितना अच्छा या बुरा है। चर्चा का स्वागत है।

चाबियाँ

आइए सबसे संदिग्ध के साथ शुरू करें: चाबियाँ डेटा का एक महत्वपूर्ण टुकड़ा घोषित की जाती हैं। कारण: वे स्पष्ट रूप से देशी पोकपशनेह पुनरावृत्तियों में मौजूद हैं, वे सरणियों में महत्वपूर्ण हैं, JSON में परिवर्तित करते समय वे महत्वपूर्ण हैं। सामान्य तौर पर, PHP में हर जगह कुंजियों का उपयोग किया जाता है, इसलिए मैं उनकी उपेक्षा नहीं करना चाहूंगा, जैसा कि कुछ अन्य पुस्तकालयों में है।

हालाँकि, मूल LINQ दृश्यों में कोई कुंजी नहीं है, इसलिए आपको कॉलबैक के लिए दोनों तर्कों की संख्या बढ़ानी होगी (अब वे सभी कुंजी के साथ काम कर सकते हैं, यदि संभव हो तो), और LINQ विधियों के लिए स्वयं: resultSelector resultSelectorValue + resultSelectorKey में बदल जाता है। हालांकि, ज्यादातर मामलों में, डेवलपर को इसके बारे में सोचने की आवश्यकता नहीं है: कॉलबैक को कम तर्कों के साथ पारित किया जा सकता है, और सभी LINQ विधियों में परिणाम के तर्क के लिए डिफ़ॉल्ट मान हैं।

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

यदि आपको महत्वपूर्ण जानकारी की आवश्यकता नहीं है, तो इनसे छुटकारा पाने के दो सरल तरीके हैं:

अंतिम ऑपरेशन के बजाय,।
कॉल toValues विधि - array_values के बराबर, लेकिन चयन की तरह आलसी।

तर्क आदेश

कार्यों और कॉलबैक में तर्कों के क्रम पर दूसरे स्थान पर संदिग्ध निर्णय है। वे हमेशा (सैद्धांतिक रूप से) सबसे कम इस्तेमाल होने वाले क्रम से जाते हैं। कॉलबैक में, इसलिए, पहले स्थान पर आमतौर पर मूल्य आता है, और फिर कुंजी, क्योंकि मूल्य लगभग हमेशा महत्वपूर्ण होता है, लेकिन कुंजी नहीं है। हालाँकि, तर्कों के क्रम को याद रखना अब और मुश्किल हो सकता है। उदाहरण के लिए, चयन में, मान को पहले चुना जाता है, और टॉपऑर्डर में, कुंजी का चयन किया जाता है।

हालाँकि, हम pokhapeshniki को इस तरह के अपमान के लिए इस्तेमाल नहीं कर सकते हैं - पूरी भाषा तर्क के पूरी तरह से यादृच्छिक क्रम (एक ही सुई और हैस्टैक) के साथ mottled है।

आइटम संकेत

मूल LINQ का उपयोग करने वालों के लिए एक स्पष्ट समाधान: indexOf जैसे तरीके, elementAt कुंजियों के साथ काम करते हैं, न कि गणना में तत्व की संख्यात्मक स्थिति। यदि आपको एक स्थिति की आवश्यकता है, तो पहले toValues को कॉल करें - कुंजी क्रमिक हो जाएगी: 0, 1, 2, 3, आदि। इसके अलावा, प्रकार के तरीकों के लिए, कॉलबैक के साथ कोई अधिभार नहीं हैं जो तत्व की स्थिति को स्वीकार करते हैं। इसी तरह, toValues का उपयोग करें।

लम्बे तर्क

Linq.js लाइब्रेरी में, जिसे मुझे लिखने के लिए प्रेरित किया गया था, सभी कॉलबैक में $ $, $ $, $ $ $, $ $ $, जैसे तर्क हैं। PHP में ऐसा नहीं होता है। आप स्ट्रिंग रूपांतरण कर सकते हैं, लेकिन मैं कोड को वैध छोड़ना चाहूंगा, भले ही वह लाइन के अंदर हो। मैं $ a, $ b, $ c दोनों के तर्कों को खाली नहीं कहना चाहता। इसलिए, सामग्री के अनुरूप नामों का उपयोग करने का निर्णय लिया गया:

आमतौर पर v के लिए मूल्य, k कुंजी के लिए
यदि कई मान हैं, तो v1 और v2
यदि मान एक अनुक्रम है, तो ई
एकत्रीकरण के दौरान बैटरी के लिए - ए
तुलना के तरीकों के लिए - ए और बी
(शायद कुछ और भूल गए)

खामी: आपको नाम जानने की जरूरत है। हालांकि, विस्तृत प्रलेखन के साथ यह एक समस्या नहीं होनी चाहिए।

"संदिग्ध" संग्रह

कोई सूची वर्ग नहीं है, टॉलिस्ट विधि केवल ऐरे के समान है, केवल अनुक्रमिक कुंजी (0, 1, 2, आदि) के साथ।

डिक्शनरी क्लास है। मूल रूप से केवल लुकअप के लिए एक आधार के रूप में कल्पना की गई थी, लेकिन अब एक अलग पूर्ण संग्रह बन गया है। साधारण सरणियों के विपरीत, वस्तुएं कुंजी हो सकती हैं (संभवतः मूल LINQ में)। लेकिन वास्तव में, LINQ खुद ही हर जगह प्रमुख वस्तुओं का समर्थन नहीं करता है, क्योंकि PHP आपको फोरचेक में प्रमुख वस्तुओं का उपयोग करने की अनुमति नहीं देता है। आप सभी चक्रों को फिर से लिख सकते हैं, लेकिन खेल मोमबत्ती के लायक कितना है यह एक सवाल है।

लुकअप क्लास है। कुंजी के द्वारा मानों की एक सूची (या यदि कोई कुंजी नहीं है तो एक खाली सरणी) देता है।

दोनों संग्रह एक एरे विधि का समर्थन करते हैं, जो एक आंतरिक सरणी देता है।

MSDN से प्रलेखन

MSDN से सहायता को सभी तरीकों से कॉपी किया गया, फिर पोर्ट वास्तविकताओं के लिए अनुकूलित किया गया। कहीं विवरण अन्य परियोजनाओं से हैं। कहीं - कहीं स्वतंत्र रूप से लिखा गया है। यदि आपको त्रुटियाँ मिलती हैं - रिपोर्ट।

सामान्य तौर पर, प्रमाण पत्र बहुत ठोस था। कुछ तरीके बीमार नहीं हैं ऐसे लेख।

विधि नाम

PHP में कुछ शब्दों को भाषा द्वारा स्वयं और सभी रजिस्टरों में पकड़ लिया जाता है। यहां तक कि खाली का उपयोग विधि नाम के रूप में नहीं किया जा सकता है। इसलिए, जहां संघर्ष होते हैं, तरीकों का नाम बदल दिया जाता है (लेख की शुरुआत में विधियों की सूची में मूल विधि नाम कोष्ठक में दिए गए हैं)। विशेष रूप से, रन / फॉरएच कॉल / प्रत्येक बन गया।

अपवाद नाम

PHP में कोई अंतर्निहित अपवाद नहीं हैं जो .NET में हैं। हालांकि, मैंने अनावश्यक कक्षाएं बनाने से बचने की कोशिश की। तो, InvalidOperationException के बजाय, एक अनपेक्षित Vueue अपवाद का उपयोग किया जाता है। अंत में, अप्रत्याशित मूल्यों के साथ ऑपरेशन अमान्य हो जाता है।

स्थिर छँटाई

क्रमबद्ध अस्थिर है। अर्थात्, नेस्टेड ऐरे के पहले तत्व द्वारा [[0,1], [1,0], [0,2]] को छांटते समय, कोई भी गारंटी नहीं देता कि [0,1] और [0,2] एक के बाद एक चले जाएंगे उस क्रम में। परिणाम दोनों [[0,1], [0,2], [1,0]] , और [[0,2], [0,1], [1,0]] ।

क्यों? क्योंकि PHP में स्थिर छँटाई के लिए कोई फ़ंक्शन नहीं हैं, और लाइब्रेरी के अंदर usort का उपयोग किया जाता है। सैद्धांतिक रूप से, आप मूल LINQ की तरह क्रमबद्ध बना सकते हैं, लेकिन क्या यह आवश्यक है? रनटाइम और मेमोरी उपयोग के साथ स्थिरता के लिए सभी को भुगतान करना होगा। मैंने फैसला किया कि जब से हम "PHP पथ" का पालन कर रहे थे, अस्थिरता PHP में ही होनी चाहिए।

अन्य

यूनिट टेस्ट कवरेज लगभग 100% है।

लाइसेंस एक सरलीकृत बीएसडी (दो-बिंदु) है।

आवश्यकताएँ - PHP 5.3।

का उपयोग करें:

 require_once __DIR__ . '/lib/Linq.php'; //     use \YaLinqo\Enumerable; //     use \YaLinqo\Enumerable as E; //   //      from,     Enumerable —   Enumerable::from(array(1, 2, 3)); from(array(1, 2, 3));

अन्य पुस्तकालयों के साथ तुलना

स्पष्टता के लिए, मैंने तालिका में जावास्क्रिप्ट के लिए पुस्तकालय भी जोड़े। उनकी तुलना एक अलग लेख में होगी।

विकिपीडिया के रूप में किंवदंती, लेकिन एक अतिरिक्त अर्थ के साथ:

लाल - कोई रास्ता नहीं
पीला - तीसरी कक्षा शादी नहीं है
हरे रंग की चीज है
नीला - मरा हुआ

मैं तालिका में अंग्रेजी के लिए माफी माँगता हूँ। रूसी में यह बहुत लंबा निकला।

मेरे लिए धन्यवाद

उन्होंने मुफ्त में काम किया, कोई भी पैसा नहीं देगा। यदि आप उदारता का हमला महसूस करते हैं, तो आप बस PHP और PHPStorm में इन सुविधाओं के लिए वोट कर सकते हैं। शायद वे नोटिस करेंगे और पुस्तकालय का उपयोग अधिक सुखद होगा।

पीएचपी

Iterator :: key () को केवल संख्या और स्ट्रिंग्स को वापस करने की अनुमति है।
1. 45684 कुंजी-प्रकार के अज्ञेय होने के लिए फोरचेक के लिए एक अनुरोध
क्लोजर के सिंटैक्स को छोटा करने के साथ एक विशेषता थी, और पैच, विश्लेषण, आदि संलग्न थे - डेवलपर जिसने सुविधा को डिजाइन किया था उसने अपना सर्वश्रेष्ठ प्रदर्शन किया। लेकिन परिणाम "नेफिग नीड" के साथ बंद कर दिया गया था। :-(

PHPStorm IDE

लाइनों के अंदर PHP कोड
- WI-3477 मुखर ('शाब्दिक') के अंदर PHP भाषा को बाहर निकालना, समान और समान
- WI-2377 इंजेक्शन भाषा के साथ स्ट्रिंग के अंदर php चर के लिए कोई स्वत: पूर्णता नहीं है
PHP कोड विश्लेषण
- WI-11110 अनिर्धारित विधि: बंद का उपयोग करते समय गलत तरीके से अपरिभाषित विधि
PHPDoc टिप्पणियाँ
- WI-8270 PhpDoc त्वरित प्रलेखन में त्रुटि अगर {लिंक} एक लाइन में दो बार उपयोग की जाती है

लिंक

GitHub से PHP के लिए वस्तुओं के लिए एक और LINQ डाउनलोड करें

PS मुझे बताएं, कृपया, जहां आप अंग्रेजी में एक समान लेख पोस्ट कर सकते हैं।

PHP के लिए LINQ। भाग 2. यदि पहाड़ मोहम्मद के पास नहीं जाता है, तो मोहम्मद पहाड़ पर जाता है