सिम्फनी 2 में ShtumiUsefulBundle का उपयोग करना - एक बंडल में कुछ उपयोगी चीजें

नए, लेकिन पहले से ही बहुत लोकप्रिय Symfony2 ढांचे के आधार पर परियोजनाओं को विकसित करते समय, एक कोड के अनैच्छिक रूप से सामना करता है जो कम से कम परिवर्तन के साथ, या यहां तक ​​कि उनके बिना, एक परियोजना से दूसरी परियोजना में भटकते हैं। एक साथ कई ऐसे "टुकड़े" एकत्र करने के बाद, मैंने ShtumiUsefulBundle बनाया, जिसका उपयोग करने के बारे में मैं बात करना चाहता हूं।

आप बंडल को GitHub: ShtumiUsefulBundle पर पा सकते हैं।

बंडल की स्थापना और विन्यास तुच्छ है और रीडमे में वर्णित है। मैं इस मुद्दे पर ध्यान नहीं दूँगा।

ऑटो-फिल फॉर्म भरें

Symfony2 में एक महान प्रकार के इकाई फ़ील्ड हैं - एक फ़ील्ड जिसमें एक ड्रॉप-डाउन सूची होती है, जो एक विशिष्ट तालिका से रिकॉर्ड के साथ पॉपुलेटेड होती है। इसके अलावा, फॉर्म जमा करने के बाद, आपको चयनित रिकॉर्ड की आईडी नहीं मिलती है, बल्कि ऑब्जेक्ट ही होता है। बहुत आराम से! आसानी से, जबकि तालिका में डेटा की मात्रा उचित सीमा से अधिक नहीं है। लेकिन जब, उदाहरण के लिए, आपकी उपयोगकर्ता तालिका में हजारों रिकॉर्ड होते हैं और आपको फ़ॉर्म में उपयोगकर्ता का चयन करने की आवश्यकता होती है, तो यह दृष्टिकोण अनुपयुक्त हो जाता है। इस मामले में एक उचित समाधान ऑटो-प्रतिस्थापन के साथ एक पाठ क्षेत्र का उपयोग करना है। ShtumiUsefulBundle आपको ऐसे फ़ील्ड बनाने और लचीले ढंग से कॉन्फ़िगर करने की अनुमति देता है।



पहले आपको ऑटो-प्रतिस्थापन के साथ सेटिंग्स में प्रत्येक फ़ील्ड को परिभाषित करने की आवश्यकता है (उदाहरण में दो हैं)।

//app/config/config.yml

shtumi_useful: autocomplete_entities: users: class: AcmeDemoBundle:User role: ROLE_ADMIN property: email products: class: AcmeDemoBundle:Product role: ROLE_ADMIN search: contains 

• वर्ग - सिद्धांत मॉडल।
• भूमिका - उपयोगकर्ता भूमिका जो क्षेत्र का उपयोग करने के लिए आवश्यक है। डिफ़ॉल्ट रूप से: IS_AUTHENTICATED_ANONYMOUSLY (सार्वजनिक रूप से उपलब्ध)
• संपत्ति - मॉडल की संपत्ति जो ऑटो-प्रतिस्थापन के लिए उपयोग की जाएगी। डिफ़ॉल्ट रूप से: शीर्षक।
• खोज - ऑटो-प्रतिस्थापन के लिए खोज का प्रकार:
  - start_with - दर्ज किए गए वर्णों के साथ शुरू होता है (डिफ़ॉल्ट)
  - End_with - प्रविष्ट वर्णों के साथ समाप्त होता है
  - समाहित है - अंदर प्रविष्ट वर्ण हैं
  

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

फ़ील्ड का उपयोग करना बहुत सरल है:

 $formBuilder ->add('product', 'shtumi_ajax_autocomplete', array('entity_alias'=>'products')); 

इस क्षेत्र का उपयोग सोनाटाडमिनबंडल में फिल्टर के रूप में भी किया जा सकता है (उन लोगों के लिए जो यह नहीं जानते - यह सिम्फनी 2 में व्यवस्थापक जनरेटर है - ईमानदार होने के लिए, मैं कल्पना नहीं कर सकता कि मैं इस बंडल के बिना कैसे रहूंगा ...)। ऐसा करने के लिए, बिक्री मॉडल में उपयोगकर्ता मॉडल के साथ एक ManyToOne एसोसिएशन के साथ एक उपयोगकर्ता संपत्ति होनी चाहिए।

 //src/Acme/DemoBundle/Admin/SaleAdmin.php protected function configureDatagridFilters(DatagridMapper $datagridMapper) { $datagridMapper ->add('id') ->add('user', 'shtumi_ajax_autocomplete', array('entity_alias'=>'users')) ; } 

यदि उस मॉडल के लिए जिसमें फ़िल्टर जोड़े जाते हैं तो ManyToOne गुच्छा के साथ कोई फ़िल्टर्ड फ़ील्ड नहीं है, तो आपको कॉलबैक का उपयोग करना होगा। आमतौर पर, ऐसी दो स्थितियां होती हैं। सबसे पहले, आपके पास एक होटल-> अभियान-> प्रस्ताव मॉडल संरचना हो सकती है। उसी समय, निश्चित रूप से, प्रस्ताव में होटल को संग्रहीत करने का कोई मतलब नहीं है, क्योंकि यह जानकारी का दोहराव है। लेकिन अभियान द्वारा ऑफ़र की सूची को फ़िल्टर करना आवश्यक हो सकता है। दूसरे, आप ऑटो-प्रतिस्थापन का उपयोग करके ई-मेल द्वारा उपयोगकर्ता तालिका को फ़िल्टर करना चाह सकते हैं। लेकिन समस्या यह है कि ई-मेल फ़ील्ड स्वयं उपयोगकर्ता मॉडल में है, और यहां किसी भी ManyToOne कनेक्शन की कोई बात नहीं हो सकती है।

Shtumi_ajax_autocomplete क्षेत्र में कॉलबैक का उपयोग करना मुश्किल नहीं है:

 //src/Acme/DemoBundle/Admin/UserAdmin.php protected function configureDatagridFilters(DatagridMapper $datagridMapper) { $datagridMapper ... ->add('email', 'shtumi_ajax_autocomplete', array('entity_alias'=>'users', 'callback' => function ($queryBuilder, $alias, $field, $data) { if (!$data['value']) { return; } if ($data['type']== 1){ //1 - no, 0 - yes $eq = " != "; } else { $eq = " = "; } $queryBuilder ->andWhere($alias . '.email' . $eq . ':value1') ->setParameter('value1', $data['value']); })) ; } 

आश्रित क्षेत्र

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



पिछले प्रकार के साथ शुरू करने के लिए, हमें उपयोग किए जाने वाले क्षेत्रों को कॉन्फ़िगर करने की आवश्यकता है:

//app/config/config.yml

 shtumi_useful: dependent_filtered_entities: region_by_country: class: AcmeDemoBundle:Region parent_property: country property: title role: ROLE_USER no_result_msg: 'No regions found for that country' order_property: title order_direction: ASC 

• वर्ग - आश्रित क्षेत्र का मॉडल।
• भूमिका - उपयोगकर्ता की भूमिका जिसके लिए क्षेत्र का उपयोग उपलब्ध होगा। डिफ़ॉल्ट रूप से, IS_AUTHENTICATED_ANONYMOUSLY सभी के लिए है।
• parent_property - एक मॉडल गुण जिसमें ManyToOne बंडल के साथ मुख्य मॉडल का लिंक होता है।
• संपत्ति - एक मॉडल संपत्ति जो निर्भर ड्रॉप-डाउन सूची में पाठ के रूप में उपयोग की जाती है। डिफ़ॉल्ट: शीर्षक
• no_result_msg - वह पाठ जिसका उपयोग आश्रित ड्रॉप-डाउन सूची में किया जाएगा यदि निर्भर तत्व डेटाबेस में अनुपस्थित हैं। डिफ़ॉल्ट रूप से: कोई परिणाम नहीं मिले। इस पाठ को संदेशों में अनुवादित किया जा सकता है
• order_property - मॉडल की एक संपत्ति जिसके द्वारा डेटा को ड्रॉप-डाउन सूची में सॉर्ट किया जाएगा। डिफ़ॉल्ट: आईडी
• क्रम_निर्देश - सॉर्ट दिशा:
  - ASC - (डिफ़ॉल्ट)
  - DESC

स्वयं फ़ील्ड का उपयोग करना फिर से कोई कठिनाई प्रस्तुत नहीं करता है।

 $formBuilder ->add('country', 'entity', array('class' => 'AcmeDemoBundle:Country' , 'required' => true , 'empty_value'=> '== Choose country ==')) ->add('region', 'shtumi_dependent_filtered_entity' , array('entity_alias' => 'region_by_country' , 'empty_value'=> '== Choose region ==' , 'parent_field'=>'country')) 

parent_field - इस रूप में मुख्य फ़ील्ड का नाम।

निर्भर क्षेत्र मान AJAX का उपयोग कर लोड किए गए हैं। इसलिए, इसका उपयोग पर्याप्त मात्रा में डेटा पर किया जा सकता है।

परिणामस्वरूप, उपयोगकर्ता फ़ॉर्म भरने के बाद, हमें एक देश ऑब्जेक्ट और एक क्षेत्र ऑब्जेक्ट मिलता है।

तारीखों के साथ काम करें

Symfony2 में एक अंतर्निहित तिथि प्रकार है। इसमें कई विजेट हैं और दिनांक, माह और वर्ष, या एक साधारण पाठ फ़ील्ड चुनने के लिए कई ड्रॉप-डाउन सूचियों की तरह दिख सकते हैं, जहाँ दिनांक एक विशिष्ट प्रारूप में प्रदर्शित होती है। परिणामस्वरूप, आपको एक DateTime ऑब्जेक्ट मिलता है। पॉप-अप कैलेंडर को इस क्षेत्र से जोड़ना मुश्किल नहीं है। ऐसा करने के लिए, आपको बस क्लास एट्रिब्यूट को फॉर्म एलिमेंट में पास करना होगा, और फिर jQuery UI, या किसी अन्य कैलेंडर को जोड़ने के बाद, टेम्प्लेट को इसके लिए टेम्पलेट में सेट करना होगा।

DATERANGE

कम अक्सर, लेकिन फिर भी फॉर्म में एक तिथि सीमा चुनना आवश्यक है। यहां कोई मानक सरल समाधान नहीं है, इसलिए मैंने इसके लिए एक सार्वभौमिक समाधान विकसित किया। ShtumiUsefulBundle में एक shtumi_daterange प्रकार है। इस प्रकार का फ़ील्ड डेट्रेंज क्लास की वस्तुओं के साथ काम करता है, जिसे बंडल के अंदर परिभाषित किया गया है। DateRange में अवधि की शुरुआत और समाप्ति तिथियां होती हैं, तिथियों का प्रतिनिधित्व करने के लिए प्रारूप, साथ ही ऑब्जेक्ट को स्ट्रिंग और इसके विपरीत परिवर्तित करने के तरीके।



इस प्रकार का उपयोग फिर से सेटिंग्स के साथ शुरू करने की आवश्यकता है, जहां आपको तिथि प्रारूप और डिफ़ॉल्ट समय अंतराल निर्दिष्ट करने की आवश्यकता है:

//app/config/config.yml

 shtumi_useful: date_range: date_format: d/m/Y default_interval: P30D 

DateRange ऑब्जेक्ट बनाने की सुविधा के लिए, एक अलग सेवा ShtumiUsefulBundle में पंजीकृत है।

DateRange ऑब्जेक्ट बनाने के तीन तरीके हैं:

1. shtumi_daterange सेवा का उपयोग करना

 // public function createToDate($dateEnd="now", $date_format = null, $date_interval=null) $dateRange1 = $this->container->get('shtumi_daterange')->createToDate(); $dateRange2 = $this->container->get('shtumi_daterange')->createToDate(new \DateTime('2012-01-11'), 'd/m/Y', 'P14D'); 

2. कक्षा से सीधे किसी वस्तु का निर्माण करना

 use Shtumi\UsefulBundle\Model\DateRange; ... $date_format = 'Ym-d'; $dateRange3 = new DateRange($date_format); $dateRange3->createToDate(new \DateTime(), 'P3D'); 

3. खजूर के अंतराल से युक्त एक स्ट्रिंग को पार्स करना।

 use Shtumi\UsefulBundle\Model\DateRange; ... $dateRange4 = new DateRange('m/d/Y'); $dateRange4->parseData('03/27/2012 - 04/05/2012'); 

DateRange ऑब्जेक्ट ही, जैसा कि पहले उल्लेख किया गया है, में दो मुख्य गुण हैं - डेटस्टार्ट की शुरुआत की तारीख और तारीख के अंत का अंतराल। ये गुण DateTime सिस्टम क्लास की वस्तुएँ हैं।

 echo $dateRange->dateEnd->format('dmY'); //23.03.2012 $x = (string)$dateRange3; // 2012-03-20 - 2012-03-23 

Shtumi_daterange फ़ॉर्म फ़ील्ड प्रकार का उपयोग करना फिर से सरल और सहज है:

 $formBuilder ->add('point1', "shtumi_daterange", array('required'=>false , 'default'=>$dateRange1)) 

अतिरिक्त DQL कार्य

हर कोई जानता है कि Symfony2 Doctrine ORM का उपयोग करता है, जिसकी अपनी DQL क्वेरी भाषा है। DQL सिंटैक्स SQL ​​के समान है, लेकिन इसमें MySQL के सभी फ़ंक्शन नहीं हैं। मुझे अक्सर IFNULL, ROUND और DATE_DIFF फ़ंक्शन का उपयोग करना पड़ता है, जो मानक डॉक्ट्रिन पैकेज में शामिल नहीं हैं।
ShtumiUsefulBundle DQL में MySQL के समान सिंटैक्स के साथ इन फ़ंक्शन का उपयोग करने की क्षमता जोड़ता है।

अतिरिक्त DQL कार्यों का उपयोग करने के लिए, आपको बस उन्हें डॉक्ट्रिन कॉन्फ़िगरेशन में जोड़ने की आवश्यकता है:

 doctrine: ... orm: entity_managers: default: dql: datetime_functions: datediff: Shtumi\UsefulBundle\DQL\DateDiff numeric_functions: ifnull: Shtumi\UsefulBundle\DQL\IfNull round: Shtumi\UsefulBundle\DQL\Round 

निष्कर्ष

बेशक, प्रस्तुत बंडल वैश्विक समस्याओं को हल नहीं करता है। लेकिन फिर भी, सिम्फनी में डेवलपर्स के सामने आने वाली कुछ छोटी समस्याएं हल हो गईं और कई परियोजनाओं पर मेरा जीवन आसान हो गया। मुझे उम्मीद है कि मेरा काम किसी और को दिलचस्प लगेगा और कम से कम उसके जीवन को थोड़ा आसान बना देगा। स्वाभाविक रूप से, जैसा कि हम रूपरेखा के साथ काम करना जारी रखते हैं, ShtumiUsefulBundle को नए प्रकार के रूपों, DQL फ़ंक्शन, TWIG एक्सटेंशन के साथ फिर से जोड़ा जाएगा, आदि। इस बंडल को विकसित करते समय, मैंने सार्वभौमिक और आसानी से विन्यास करने की कोशिश की, मैंने प्रलेखन में विस्तार से सब कुछ वर्णन करने की कोशिश की। मुझे इसके उपयोग, आलोचना, टिप्पणियों और सुझावों के बारे में समीक्षा सुनने में बहुत खुशी होगी।