Yii - अनुभव विनिमय: मॉडल

इस लेख की सामग्री उन डेवलपर्स के लिए है, जिनके पास पहले से ही YII ढांचे के साथ काम करने का कौशल है। अनुभवी प्रोग्रामर सामग्री को निर्बाध पा सकते हैं।
यह लेख फ्रेमवर्क संस्करण YII 1.1.14 के लिए लिखा गया था। एक बिल्ली के नीचे कोड टुकड़े के साथ बहुत सारे पाठ हैं।

चलिए शुरू करते हैं

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

प्रवास

माइग्रेशन बनाते समय, आपको कई जटिल निर्भर प्रश्नों से बचना चाहिए; यदि संभव हो तो, एक माइग्रेशन को एक SQL क्वेरी बनाना चाहिए। आइए देखें कि ऐसा क्यों है।

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

एक मॉडल वर्ग बनाना

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

पहली चीज जो हम करते हैं वह वह वर्ग है जिसमें से मॉडल विरासत में मिला है। अगर ActiveRecord.php फ़ाइल अभी तक application.compords निर्देशिका में मौजूद नहीं है, तो इसे बनाने का समय आ गया है, यह हमारे सभी मॉडलों के लिए आधार वर्ग होगा।

class ActiveRecord extends CActiveRecord { const SCENARIO_CREATE = 'insert'; const SCENARIO_UPDATE = 'update'; const SCENARIO_SEARCH = "search"; /** Return model ID * * @return integer */ public function getId() { return $this->id; } /** * Returns the static ActiveRecord model. * Please note that you should have this exact method in all your CActiveRecord descendants! * @param string $className active record class name. * @return ActiveRecord the static model class */ public static function model($className=__CLASS__) { return parent::model($className); } } 

विरासत मॉडल से सभी दोहराए जाने वाले तरीकों को DRY सिद्धांत के अनुपालन के लिए इस वर्ग में ले जाना चाहिए। रिटर्न निर्देश को निर्दिष्ट करने के तरीकों पर टिप्पणी छोड़ना न भूलें, यह न केवल PHPDoc के लिए बल्कि आईडीई के लिए भी है।

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

बेस मॉडल

यदि मॉडल बहुत बड़ा है और इसमें कई विशेषताएं हैं, तो ऐसे मॉडल को दो में विभाजित करना सुविधाजनक है। मूल मॉडल और मूल एक मूल से विरासत में मिला है।
उदाहरण के लिए, वंशानुक्रम श्रृंखला इस तरह दिख सकती है:
User -> BaseUser -> ActiveRecord -> CActiveRecord
इसी समय, YII (संबंधपरक संबंध, सत्यापन नियम, विशेषता लेबल) के संचालन के लिए आवश्यक तरीके आधार मॉडल में रखे गए हैं, और हम अपने तरीकों को मॉडल के मुख्य वर्ग में रखते हैं।
मॉडल के आधार और मुख्य वर्ग में, स्थिर विधि मॉडल () को फिर से दिखाना अनिवार्य है, जैसा कि नीचे दिखाया गया है। वापसी टैग में विधि पर टिप्पणी में, आपको अपनी कक्षा को निर्दिष्ट करना याद रखना चाहिए।

  /** * Returns the static BaseUser model * * @param string $className active record class name. * @return BaseUser */ public static function model($className=__CLASS__) { return parent::model($className); } 

नाम का अनुवाद

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

  /** * @return array customized attribute labels (name=>label) */ public function attributeLabels() { return array( 'id' => Yii::t('BaseUser','ID'), 'firstName' => Yii::t('BaseUser','First Name'), 'middleName' => Yii::t('BaseUser','Middle Name'), 'lastName' => Yii::t('BaseUser','Last Name'), 'phone' => Yii::t('BaseUser','Phone Number'), 'email' => Yii::t('BaseUser','E-mail'), // and more... ); } 

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

मॉडल में लगातार

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

  const STATUS_DRAFT = 1; const STATUS_PUBLIC = 2; const STATUS_TRASH = 3; const FLAG_HAS_CAR = 1; const FLAG_HAS_HOUSE = 2; const FLAG_HAS_CREDIT = 4; const FLAG_HAS_DEPOSIT = 8; 

जाहिर है, स्रोत में ऐसे स्थिरांक का सामना करते हुए वे तुरंत हमें बताते हैं कि हम क्या व्यवहार कर रहे हैं।

डेटा एक्सेस के तरीके

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

  /** * Set user status * * @param int $status * @return \User */ public function setStatus($status){ $this->status = intval($status); return $this; } /** * Return First Name * * @return string */ public function getFirstName() { return (string)$this->upperFirst($this->firstName); } 

मामूली ऑपरेशन

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

  /** * Make user active * * @return bool */ public function makeActive(){ if($this->hasEventHandler('onBeforeCount')){ $this->onBeforeCount(new CEvent($this)); } $result = $this->setStatus(self::STATUS_ACTIVE) ->save(); if($this->hasEventHandler('onAfterMakeActive')){ $this->onAfterMakeActive(new CEvent($this)); } return $result; } 

इस पर, मैं दर्शकों की राय जानने के लिए बाधित करूंगा।

UPD : मीटिचिक और फेसर से परिवर्तन किए गए ।