PHP में उपसर्ग और उपसर्ग (और CSS)

कुछ समय पहले मैंने PHP और CSS में उपसर्गों और उपसर्गों का उपयोग करने का अभ्यास किया। यह विशेष रूप से सच है जब कुछ स्थानीय दृश्यता से परे हो जाता है और वैश्विक अंतरिक्ष में है, वाईआई में समान मॉडल लेते हैं।



उपसर्ग और उपसर्ग मुख्य कार्य को आगे बढ़ाते हैं - इकाई को यथासंभव अद्वितीय बनाने के लिए, और इतना ही कि यह आसानी से किसी भी पाठ संपादक के साथ मिल सकता है। आज, IDE एक महान चीज़ का समर्थन करता है - "Usages का पता लगाएं", लेकिन यह हमेशा मदद नहीं करता है, और मैं इस बारे में थोड़ा नीचे लिखूंगा।



हंगेरियन नोटेशन की शैली में नामकरण मुझे पसंद नहीं था। सी ++ / डेल्फी के बाद से मुझे यह दृष्टिकोण पसंद नहीं आया है - मैंने इसे अनावश्यक माना और हमेशा स्पष्ट नहीं। मुझे बीईएम का कार्यान्वयन पसंद आया, लेकिन मैं इसका पूरी तरह से उपयोग नहीं करता हूं। मैंने उन तरीकों को अलग करने और संयोजित करने की कोशिश की जो मुझे सबसे ज्यादा पसंद थे, और मैं आपको उनके बारे में बताऊंगा।

---

सीएसएस

मैं उपसर्ग "cl_", पहचानकर्ता उपसर्ग "id_" के साथ सभी सीएसएस कक्षाएं शुरू करता हूं। यदि वर्ग या पहचानकर्ता ब्लॉक के अंतर्गत आता है, तो मैं उपसर्ग "b_" के बाद जोड़ता हूं, यदि मॉड्यूल के लिए - "m_"। मैं उपसर्गों के साथ किसी भी आंतरिक स्थिति या मिनी-ब्लॉक का संकेत देता हूं।

.cl_b_promoblock {} #id_m_user_list {} #id_m_order_preview .cl_b_user_info {} .cl_user_list_item .cl_visible {} #id_b_main_menu .cl_main_menu_item.cl_selected {}
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

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



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

---

PHP (Yii)

यह किसी भी तरह से गलत है कि नियंत्रक, सत्यापनकर्ता, आदि। अतिरिक्त उपसर्ग और उपसर्ग हैं, लेकिन मॉडल नहीं है। मैंने फैसला किया कि वाईआई के "जादू" के कारण, यह खोजना मुश्किल होगा कि उपयोगकर्ता वर्ग का उपयोग कहां किया जाता है, और एक सरल पाठ खोज के साथ, उपयोगकर्ता शब्द जहां भी संभव होगा पाया जाएगा।



इसलिए, मॉडल वर्गों को WbUserModel, WbCatalogItemModel, आदि के रूप में जाना जाता है, जहां:

• Wb: प्रोजेक्ट पहचानकर्ता (नाम के लिए संक्षिप्त);
• उपयोगकर्ता: वास्तव में, मॉडल;
• मॉडल: इसका मतलब है कि यह एक मॉडल है न कि कुछ और।

सत्यापनकर्ता (WbExistsByPkValidator, WbCensureValidator) और स्वयं के सहायक पुस्तकालय (LArray, LTime, LString) , जहां उपसर्ग "L" लाइब्रेरी के लिए एक संक्षिप्त नाम है, भी इस पैटर्न के तहत गिर गया। पुस्तकालयों के लिए, आप स्ट्रिंगलिब या ऐरेलिब का भी उपयोग कर सकते हैं, लेकिन मेरी राय यह है कि "एल" उपसर्ग उन्हें एक के बाद एक फ़ाइल सूची में डालता है, जो सुविधाजनक है। वैसे, "स्कोप" विधियों के लिए, मैं उपसर्ग भी जोड़ता हूं, उदाहरण के लिए, स्कोपप्रकाशित () या स्कोप्लास्ट (इंट $ सीमा), उन्हें "साधारण" विधियों से अलग करने के लिए।



ऐसे नामों का उपयोग विशिष्टता प्रदान करता है, और जिस स्थिति में मैं एक आईडीई के बिना भी एक विशेष वर्ग के सभी उपयोग पा सकता हूं। मैं कक्षाओं और विशेषताओं के शाब्दिक प्रतिनिधित्व के उपयोग को छोड़ने के लिए हर संभव तरीके से कोशिश कर रहा हूं, मैं विशेष रूप से इसे एक बड़ी बुराई मानता हूं जब किसी वर्ग का लिंक स्ट्रिंग्स के संघ से उत्पन्न होता है - यह "खोज Usages" के माध्यम से या पाठ में खोज के माध्यम से नहीं पाया जा सकता है। उदाहरण के लिए:

 public function actionGetData($object_type) { $model_class = 'Wb' . $object_type . 'Model'; $model = new $model_class(); return $model; }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

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

 public function relations() { return array( 'R_PriceItems' => array(self::HAS_MANY, WbCatalogPriceItemModel::CLASS, 'category_id'), 'R_CategoryParent' => array(self::BELONGS_TO, WbCatalogCategoryModel::CLASS, array('parent_id' => 'id'), ) } public function RecalculatePriceItems() { foreach ($this->R_PriceItems as $price_item) { $price_item->price = $price_item->new_price; } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

जैसा कि आप ऊपर दिए गए कोड (संबंध विधि) में देख सकते हैं, मैं संबंधित मॉडलों के लिए कक्षाओं को गतिशील रूप से परिभाषित करता हूं, पाठ नहीं। लेकिन यह केवल PHP> 5.5 के लिए संभव है। यदि (और सबसे अधिक संभावना है) सर्वर PHP के इस संस्करण का समर्थन नहीं करता है, तो आप ActiveRecord का विस्तार कर सकते हैं और CLASS के बजाय _CLASS_ () विधि का उपयोग कर सकते हैं। फिर PHP> 5.5 पर स्विच करने के बाद _CLASS_ () को CLASS से एक सरल "फाइंड एंड रिप्लेसमेंट" के साथ बिना किसी समस्या के बदलना संभव होगा।

 class ActiveRecord extends CActiveRecord { public static function _CLASS_() { return get_called_class(); } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

---

"फॉर" या "अगेंस्ट"

मेरे वातावरण में नामकरण के लिए इस तरह के दृष्टिकोण के लिए "फॉर" और "अगेंस्ट" दोनों के समर्थक हैं।



विशेष रूप से, वे निजी गुणों और विधियों के लिए उपसर्ग "_" ($ _items, $ _version) का उपयोग करते हैं। अक्सर ऐसे मामले होते हैं जब डेटाबेस में टेबल के लिए प्रोजेक्ट उपसर्ग इंगित करता है, उदाहरण के लिए, wb_catalog_item। YouTube पृष्ठों के स्रोत कोड में हर जगह HTML और CSS में उपसर्ग "yt-" होता है (यह सबसे अधिक संभावना यह भी सुनिश्चित करता है कि तृतीय-पक्ष साइटों से कनेक्ट होने पर कोई संघर्ष नहीं हो) ।



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



हां, उपसर्गों और उपसर्गों ने कोड लेखन को कुछ हद तक धीमा कर दिया है, लेकिन कोड केवल एक बार लिखा है, और एक से अधिक बार पढ़ा और परिशोधित किया जाता है। मेरे लिए, कोड को पढ़ना बहुत आसान है, जिसमें आप तुरंत उपसर्गों और मामले को निर्धारित कर सकते हैं जहां मॉडल विशेषता, जहां विधि, और जहां गुंजाइश या संबंध है। उपसर्ग "R_" स्पष्ट रूप से यह स्पष्ट करता है कि यह एक कनेक्शन है, और उपसर्ग "मॉडल" है कि यह एक मॉडल है। उदाहरण के लिए, एक WebUser वर्ग है - यह एक घटक है (CWebUser का विस्तार करता है) , और एक उपयोगकर्ता वर्ग है - और यह पहले से ही एक मॉडल है।



और अंत में ... Yii सभी जगह कॉल चेन का उपयोग करता है। उदाहरण के लिए, $ श्रेणी-> first_item-> स्टोर। इस मामले में, स्टोर एक संबंध है, जिसका अर्थ गोदाम के साथ संचार है। लेकिन एक बिंदु पर, आपको कैटलॉग_इटेम तालिका में स्टोर नामक एक नया कॉलम जोड़ने की आवश्यकता है। यह वह जगह है जहाँ समस्या शुरू होती है, क्योंकि सामान्य दृष्टिकोण के साथ, कोड विश्लेषण के बिना, आप स्टोर कनेक्शन को किसी अन्य चीज़ के साथ नहीं ले सकते हैं और प्रतिस्थापित कर सकते हैं ताकि कोई नाम संघर्ष न हो। उपसर्गों का उपयोग करने के मामले में, सब कुछ 1-2-3 मिनट में "ढूंढें और बदलें" के स्तर पर तय किया जाएगा।

---

मैं हबर के श्रोताओं से इस दृष्टिकोण की एक रचनात्मक चर्चा करना चाहूंगा। शायद गैर-अद्वितीय नामों के साथ समस्याओं के अन्य समाधान हैं।