विनिर्देशों के बारे में संक्षेप में:

एक विनिर्देश एक डिज़ाइन पैटर्न है जिसके साथ आप बूलियन लॉजिक ऑपरेशंस द्वारा जुड़ी वस्तुओं की श्रृंखला के रूप में व्यावसायिक तर्क के नियमों को प्रतिबिंबित कर सकते हैं। विनिर्देशों आपको व्यावसायिक तर्क के रिपॉजिटरी और दोहराव में इसी तरह की नकल से छुटकारा पाने की अनुमति देते हैं।

आज, दो हैं (यदि आप अन्य परियोजनाओं को जानते हैं, तो कृपया टिप्पणियों में लिखें) सफल और लोकप्रिय PHP परियोजनाएं जो आपको विनिर्देशों और फ़िल्टर डेटा सेटों में व्यावसायिक नियमों का वर्णन करने की अनुमति देती हैं। ये RulerZ और Happyr Doctrine Specification हैं । दोनों परियोजनाएं अपने फायदे और नुकसान के साथ शक्तिशाली उपकरण हैं। इन परियोजनाओं की तुलना करने से एक संपूर्ण लेख तैयार होगा। यहां मैं आपको बताना चाहता हूं कि डॉक्ट्रिन स्पेसिफिकेशन में नई रिलीज हमारे लिए क्या लेकर आई है।

संक्षेप में सिद्धांत विशिष्टता के बारे में

जो लोग प्रोजेक्ट से कम या ज्यादा परिचित हैं, वे सुरक्षित रूप से इस सेक्शन को छोड़ सकते हैं।

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

सिद्धांत सिद्धांत के माध्यम से लागू होते हैं:

$result = $em->getRepository(MyEntity::class)->match($spec); 

 $spec = ... $alias = 'e'; $qb = $em->getRepository(MyEntity::class)->createQueryBuilder($alias); $spec->modify($qb, $alias); $filter = (string) $spec->getFilter($qb, $alias); $qb->andWhere($filter); $result = $qb->getQuery()->execute(); 

रिपॉजिटरी में कई तरीके हैं:

• match - विनिर्देश के अनुरूप सभी परिणाम प्राप्त करना;
• matchSingleResult - Query::getSingleResult() बराबर Query::getSingleResult() ;
• matchOneOrNullResult - matchOneOrNullResult बराबर, लेकिन null अनुमति देता है;
• getQuery - इसके लिए एक विनिर्देशन लागू करके एक QueryBuilder बनाता है और इसमें से एक क्वेरी ऑब्जेक्ट देता है।

हाल ही में, getQueryBuilder विधि उन्हें जोड़ा गया है, जो एक QueryBuilder बनाता है और, इसके लिए विनिर्देश को लागू करता है, इसे वापस करता है।

परियोजना कई प्रकार की विशिष्टताओं की पहचान करती है:

• तार्किक विनिर्देशों
• फ़िल्टर विशिष्टता
• क्वेरी संशोधक
• परिणाम संशोधक

तार्किक विनिर्देशों

andX और orX संग्रह के रूप में भी काम करते हैं।

• Spec::andX()
• Spec::orX()
• Spec::not()

यह Spec मुखौटा के माध्यम से पुस्तकालय विनिर्देशों की वस्तुओं को स्थापित करने के लिए प्रथागत है, लेकिन यह आवश्यक नहीं है। आप स्पष्ट रूप से विनिर्देश वस्तु को तुरंत हटा सकते हैं:

 new AndX(); new OrX(): new Not(); 

फ़िल्टर विशिष्टता

फ़िल्टरिंग विनिर्देश, वास्तव में, व्यापार तर्क के नियम बनाते हैं और WHERE अनुरोध में उपयोग किए जाते हैं। इनमें तुलनात्मक ऑपरेशन शामिल हैं:

• isNull - SQL IS NULL समतुल्य है
• isNotNull - SQL पूर्ण IS NOT NULL
• in - IN () बराबर
• notIn - NOT IN () समतुल्य नहीं
• eq - समानता परीक्षण =
• neq - असमानता के लिए जाँच !=
• lt - से कम <
• lte - <= से कम या बराबर
• gt - से अधिक >
• gte - से बड़ा या बराबर >=
• like - SQL LIKE समकक्ष
• InstOfX - DQL इंस्टेंट के बराबर

फ़िल्टरिंग विनिर्देशों का उपयोग करने का एक उदाहरण:

 $spec = Spec::andX( Spec::eq('ended', 0), Spec::orX( Spec::lt('endDate', new \DateTime()), Spec::andX( Spec::isNull('endDate'), Spec::lt('startDate', new \DateTime('-4 weeks')) ) ) ); 

क्वेरी संशोधक

क्वेरी मॉडिफायर का व्यावसायिक तर्क और व्यावसायिक नियमों से कोई लेना-देना नहीं है। जैसा कि नाम से ही स्पष्ट है, वे केवल QueryBuilder को संशोधित करते हैं। पूर्वनिर्धारित संशोधक का नाम और उद्देश्य QueryBuilder में समान तरीकों से मेल खाता है।

• join
• leftJoin
• innerJoin
• limit
• offset
• orderBy
• groupBy
• having

मैं slice संशोधक को अलग से नोट करना चाहता हूं। यह फ़ंक्शन की limit और offset को जोड़ता limit और स्लाइस के आकार और इसके सीरियल नंबर के आधार पर ऑफसेट की गणना करता है। इस संशोधन के कार्यान्वयन में, हम परियोजना के लेखक से असहमत थे। एक संशोधक बनाते हुए, मैंने पृष्ठांकन के दौरान विशिष्टताओं के विन्यास को सरल बनाने के लक्ष्य का पीछा किया। इस संदर्भ में, सीरियल नंबर 1 वाला पहला पृष्ठ सीरियल नंबर 1 के साथ पहले स्लाइस के बराबर होना चाहिए था। लेकिन प्रोजेक्ट के लेखक ने प्रोग्रामिंग शैली में उलटी गिनती शुरू करने के लिए इसे सही माना, अर्थात्, 0. इसलिए, यह याद रखने योग्य है कि यदि आपको पहले स्लाइस की आवश्यकता है, तो आपको निर्दिष्ट करना होगा। 0 सीरियल नंबर के रूप में।

परिणाम संशोधक

परिणाम संशोधक विनिर्देशों से थोड़ा अलग मौजूद हैं। वे डॉक्ट्रिन क्वेरी पर लागू होते हैं। निम्न संशोधक डेटा जलयोजन को नियंत्रित करते हैं ( Query::setHydrationMode() ):

• asArray
• asSingleScalar
• asScalar

cache संशोधक क्वेरी परिणाम के कैशिंग को नियंत्रित करता है।

हमें संशोधक roundDateTimeParams भी उल्लेख करना चाहिए। यह कैशिंग समस्याओं को हल करने में मदद करता है जब आपको व्यावसायिक नियमों के साथ काम करने की आवश्यकता होती है जो वर्तमान समय के साथ कुछ मूल्यों की तुलना करने की आवश्यकता होती है। ये सामान्य व्यवसाय नियम हैं, लेकिन इस तथ्य के कारण कि समय एक स्थिर नहीं है, एक से अधिक सेकंड के लिए कैशिंग आपके लिए काम नहीं करेगा। roundDateTimeParams संशोधक को इस समस्या को हल करने के लिए डिज़ाइन किया गया है। यह अनुरोध के सभी मापदंडों के माध्यम से जाता है, उनमें तारीख की खोज करता है और इसे निर्दिष्ट मूल्य तक नीचे ले जाता है, जो हमें तारीख मान देता है जो हमेशा एक मूल्य के गुणक होते हैं और हमें भविष्य में तारीख नहीं मिलेगी। यही है, अगर हम 10 मिनट के लिए अनुरोध को कैश करना चाहते हैं, तो हम Spec::cache(600) और Spec::roundDateTimeParams(600) । प्रारंभ में, सुविधा के लिए इन दो संशोधक को संयोजित करने का प्रस्ताव किया गया था, लेकिन उन्हें SRP के लिए अलग करने का निर्णय लिया गया।

एंबेडेड विनिर्देशों

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

नवाचारों

रिपॉजिटरी में नए तरीके जोड़े गए हैं:

• matchSingleScalarResult - Query::getSingleScalarResult() बराबर Query::getSingleScalarResult() ;
• matchScalarResult - Query::getScalarResult() बराबर Query::getScalarResult() ;
• iterate Query::iterate() के समतुल्य है Query::iterate() ।

MemberOfX विनिर्देश MemberOfX - डीईएन के समतुल्य MEMBER OF और indexBy क्वेरी संशोधक को indexBy - QueryBuilder::indexBy() के बराबर QueryBuilder::indexBy() ।

ऑपरेंड

नई रिलीज से ऑपरेंड की अवधारणा का परिचय होता है । फ़िल्टर में सभी स्थितियाँ बाएं और दाएं ऑपरेंड और उनके बीच एक ऑपरेटर होती हैं।

 <left_operand> <operator> <right_operand> 

पिछले संस्करणों में, बाएं ऑपरेंड केवल एक इकाई क्षेत्र हो सकता है, और सही ऑपरेंड केवल एक मान हो सकता है। यह एक सरल और प्रभावी तंत्र है जो अधिकांश कार्यों के लिए पर्याप्त है। उसी समय, यह कुछ प्रतिबंध लगाता है:

• कार्यों का उपयोग करने में असमर्थ;
• खेतों के लिए उपनाम का उपयोग नहीं कर सकते;
• दो क्षेत्रों की तुलना करना असंभव है;
• दो मूल्यों की तुलना करना असंभव है;
• अंकगणित संचालन का उपयोग करने में असमर्थ;
• मान के लिए डेटा प्रकार निर्दिष्ट नहीं कर सकता।

नए संस्करण में, ऑपरैंड ऑब्जेक्ट्स को तर्कों में फ़िल्टर करने के लिए पारित किया जाता है और DQL में उनके परिवर्तन को ऑपरेंड को स्वयं सौंप दिया जाता है। यह कई संभावनाओं को खोलता है और फिल्टर को आसान बनाता है।

क्षेत्र और मूल्य

पिछड़े संगतता को बनाए रखने के लिए, फ़िल्टर में पहला तर्क एक फ़ील्ड ऑपरेंड में परिवर्तित हो जाता है, अगर यह एक ऑपरेंड नहीं है, और अंतिम तर्क मान ऑपरेंड में परिवर्तित हो जाता है। इसलिए, आपको अपडेट करने में समस्या नहीं होनी चाहिए।

 // DQL: e.day > :day Spec::gt('day', $day); // or Spec::gt(Spec::field('day'), $day); // or Spec::gt(Spec::field('day', $dqlAlias), $day); 

 // DQL: e.day > :day Spec::gt('day', $day); // or Spec::gt('day', Spec::value($day)); // or Spec::gt('day', Spec::value($day, Type::DATE)); 

आप 2 क्षेत्रों की तुलना कर सकते हैं:

 // DQL: e.price_current < e.price_old Spec::lt(Spec::field('price_current'), Spec::field('price_old')); 

आप विभिन्न संस्थाओं के 2 क्षेत्रों की तुलना कर सकते हैं:

 // DQL: a.email = u.email Spec::eq(Spec::field('email', 'a'), Spec::field('email', 'u')); 

अंकगणित संचालन

मानक अंकगणितीय संचालन के लिए जोड़ा समर्थन - , + , * , / , % । उदाहरण के लिए, उपयोगकर्ता बिंदुओं की गणना पर विचार करें:

 // DQL: e.posts_count + e.likes_count > :user_score Spec::gt( Spec::add(Spec::field('posts_count'), Spec::field('likes_count')), $user_score ); 

अंकगणित संचालन एक दूसरे में निहित हो सकते हैं:

 // DQL: ((e.price_old - e.price_current) / (e.price_current / 100)) > :discount Spec::gt( Spec::div( Spec::sub(Spec::field('price_old'), Spec::field('price_current')), Spec::div(Spec::field('price_current'), Spec::value(100)) ), Spec::value($discount) ); 

कार्यों

नई रिलीज़ ने फ़ंक्शंस के साथ ऑपरेंड को जोड़ा। उन्हें विशेष वर्ग के स्थिर तरीकों के रूप में, या Spec::fun() विधि के माध्यम से उपयोग किया जा सकता है।

 // DQL: size(e.products) > 2 Spec::gt(Spec::size('products'), 2); // or Spec::gt(Spec::fun('size', 'products'), 2); // or Spec::gt(Spec::fun('size', Spec::field('products')), 2); 

कार्यों को एक दूसरे में निहित किया जा सकता है:

 // DQL: trim(lower(e.email)) = :email Spec::eq(Spec::trim(Spec::lower('email')), trim(strtolower($email))); // or Spec::eq( Spec::fun('trim', Spec::fun('lower', Spec::field('email'))), trim(strtolower($email)) ); 

कार्यों के लिए तर्क अलग तर्क के रूप में, या उन्हें एक सरणी में पारित करके पारित किया जा सकता है:

 // DQL: DATE_DIFF(e.create_at, :date) Spec::DATE_DIFF('create_at', $date); // or Spec::DATE_DIFF(['create_at', $date]); // or Spec::fun('DATE_DIFF', 'create_at', $date); // or Spec::fun('DATE_DIFF', ['create_at', $date]); 

नमूना प्रबंधन

कभी-कभी आपको रिटर्न मानों की सूची प्रबंधित करने की आवश्यकता होती है। उदाहरण के लिए:

• परिणाम के लिए एक और इकाई जोड़ें ताकि लिंक प्राप्त करने के लिए उपश्रेणियां न बनाएं;
• पूरी इकाई को वापस नहीं करने के लिए, लेकिन केवल अलग-अलग क्षेत्रों का एक सेट;
• उपनाम का उपयोग करें;
• छंटाई के लिए शर्तों के साथ छिपे हुए उपनामों का उपयोग करें (इसके लिए डॉक्ट्रिन की आवश्यकता होती है, लेकिन वे इसे ठीक करने का वादा करते हैं )।

संस्करण 0.8.0 से पहले, इन कार्यों को इन आवश्यकताओं के लिए विशिष्टताओं के निर्माण की आवश्यकता थी। संस्करण 0.8.0 से शुरू होकर, आप getQueryBuilder() विधि का उपयोग कर सकते हैं और QueryBuilder इंटरफ़ेस के माध्यम से चयन का प्रबंधन कर सकते हैं।

नया रिलीज़ 1.0.0 select और addSelect अनुरोध addSelect जोड़ता है। select पूरी तरह से चयन करने योग्य मूल्यों की सूची को बदल देता है, और addSelect सूची में नए मान जोड़ता है। एक मूल्य के रूप में, आप एक ऑब्जेक्ट का उपयोग कर सकते हैं जो Selection इंटरफ़ेस या फ़िल्टर को लागू करता है। इस प्रकार, आप अपनी आवश्यकताओं को पूरा करने के लिए पुस्तकालय की क्षमताओं का विस्तार कर सकते हैं। उन अवसरों पर विचार करें जो पहले से हैं।

आप एक फ़ील्ड का चयन कर सकते हैं:

 // DQL: SELECT e.email FROM ... Spec::select('email') // or Spec::select(Spec::field('email')) 

आप चयन में एक फ़ील्ड जोड़ सकते हैं:

 // DQL: SELECT e, u.email FROM ... Spec::addSelect(Spec::field('email', $dqlAlias)) 

आप कई क्षेत्रों का चयन कर सकते हैं:

 // DQL: SELECT e.title, e.cover, u.name, u.avatar FROM ... Spec::andX( Spec::select('title', 'cover'), Spec::addSelect(Spec::field('name', $dqlAlias), Spec::field('avatar', $dqlAlias)) ) 

आप दिए गए मानों के लिए एक इकाई जोड़ सकते हैं:

 // DQL: SELECT e, u FROM ... Spec::addSelect(Spec::selectEntity($dqlAlias)) 

आप चयन क्षेत्रों के लिए उपनाम का उपयोग कर सकते हैं:

 // DQL: SELECT e.name AS author FROM ... Spec::select(Spec::selectAs(Spec::field('name'), 'author')) 

आप चयन में छिपे हुए फ़ील्ड जोड़ सकते हैं:

 // DQL: SELECT e, u.name AS HIDDEN author FROM ... Spec::addSelect(Spec::selectHiddenAs(Spec::field('email', $dqlAlias), 'author'))) 

उदाहरण के लिए, किसी उत्पाद पर छूट पाने के लिए आप भावों का उपयोग कर सकते हैं:

 // DQL: SELECT (e.price_old is not null and e.price_current < e.price_old) AS discount FROM ... Spec::select(Spec::selectAs( Spec::andX( Spec::isNotNull('price_old'), Spec::lt(Spec::field('price_current'), Spec::field('price_old')) ), 'discount' )) 

आप विनिर्देशों में उपनाम का उपयोग कर सकते हैं:

 // DQL: SELECT e.price_current AS price FROM ... WHERE price < :low_cost_limit Spec::andX( Spec::select(Spec::selectAs('price_current', 'price')), Spec::lt(Spec::alias('price'), $low_cost_limit) ) 

यह मूल रूप से सभी है। यहीं से नवाचारों का अंत होता है। नई रिलीज ने कई दिलचस्प और उपयोगी विशेषताएं ला दी हैं। मुझे आशा है कि उन्होंने आपकी रुचि की होगी।

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