👩🏻‍🤝‍👨🏾 🤚🏽 🛎️ LiveStreet और ORM 🧗🏾 🤳🏼 🈵

संस्करण 0.5 का विमोचन मेरे लिए एक गतिविधि पृष्ठ और हस्ताक्षरित ब्लॉग से एक विषय फ़ीड जोड़ने की तुलना में कुछ अधिक था। नया संस्करण ORM और ActiveRecord को लागू करता है। साथ में, वे डेवलपर के लिए एक शक्तिशाली टूलकिट प्रदान करते हैं, उसी प्रकार के कोड के ढेर को समाप्त करते हैं जिसे आपको प्लगइन विकसित करने पर हर बार लिखना होता था। एक ही मंच, जिसे लेख में चर्चा की जाएगी, अपडेट के बाद कोड की 2177 लाइनें खोनी चाहिए । इस लेख में, मैं एक उदाहरण के रूप में LiveStreet के लिए एक प्लगइन बनाकर ORM और AR में गहराई से तलना चाहता हूं।

लगभग एक साल पहले, भगोड़े ने ट्रंक संस्करण में नवाचारों के बारे में एक लेख पोस्ट किया।

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

मैं मंच प्लगइन के उदाहरण के साथ सब कुछ पर विचार करूंगा। सबसे पहले हमें एक प्लगइन कंकाल बनाने की आवश्यकता है:

plugin

^{स्रोत फ़ाइलों को जीथब पर देखा जा सकता है, मैं प्लगइन के विवरण पर ध्यान नहीं दूंगा।}

अब मंच नामक एक मॉड्यूल बनाएं।

plugin

हमें मॉड्यूल को मॉड्यूल के रूप में वर्णित करने की आवश्यकता है, और, Init विधि में, हमें नियमित मॉड्यूल से Init विधि के मूल को इनहेरिट करने की आवश्यकता है:

class PluginForum_ModuleForum extends ModuleORM { public function Init() { parent::Init(); } }

संस्थाओं का वर्णन करने से पहले, हमें उनके बीच सभी कनेक्शनों पर विचार करने की आवश्यकता है, ताकि गेटर्स के माध्यम से हेरफेर करना आसान हो:

और बनाई गई संस्थाओं का वर्णन करें:

Category.entity.class.php

 class PluginForum_ModuleForum_EntityCategory extends EntityORM {}

Forum.entity.class.php

 class PluginForum_ModuleForum_EntityForum extends EntityORM { protected $aRelations = array( 'category'=>array(EntityORM::RELATION_TYPE_BELONGS_TO,'PluginForum_ModuleForum_EntityCategory','category_id'), 'user'=>array(EntityORM::RELATION_TYPE_BELONGS_TO,'ModuleUser_EntityUser','user_id'), 'topic'=>array(EntityORM::RELATION_TYPE_BELONGS_TO,'PluginForum_ModuleForum_EntityTopic','topic_id'), 'post'=>array(EntityORM::RELATION_TYPE_BELONGS_TO,'PluginForum_ModuleForum_EntityPost','post_id'), ); }

Topic.entity.class.php

 class PluginForum_ModuleForum_EntityTopic extends EntityORM { protected $aRelations = array( 'user'=>array(EntityORM::RELATION_TYPE_BELONGS_TO,'ModuleUser_EntityUser','user_id'), 'post'=>array(EntityORM::RELATION_TYPE_BELONGS_TO,'PluginForum_ModuleForum_EntityPost','post_id'), 'forum'=>array(EntityORM::RELATION_TYPE_BELONGS_TO,'PluginForum_ModuleForum_EntityForum','forum_id'), ); }

Post.entity.class.php

 class PluginForum_ModuleForum_EntityPost extends EntityORM { protected $aRelations = array( 'user'=>array(EntityORM::RELATION_TYPE_BELONGS_TO,'ModuleUser_EntityUser','user_id'), 'topic'=>array(EntityORM::RELATION_TYPE_BELONGS_TO,'PluginForum_ModuleForum_EntityTopic','topic_id'), 'forum'=>array(EntityORM::RELATION_TYPE_BELONGS_TO,'PluginForum_ModuleForum_EntityForum','forum_id'), ); }

Read.entity.class.php

 class PluginForum_ModuleForum_EntityRead extends EntityORM {}

अब उदाहरण के लिए, प्लगइन मॉड्यूल में कक्षाओं का वर्णन किए बिना यह सब हेरफेर किया जा सकता है:

 $this->PluginForum_ModuleForum_GetCategoryItemsAll(); //

 $this->PluginForum_ModuleForum_GetForumItemsByCategoryId($oCategory->getId()); //     ID

 $this->PluginForum_ModuleForum_GetTopicItemsByForumId($oForum->getId(),array('#page' => array(1,15), '#cache'=>'')); /** *           : * array( * 'collection' => array of objects * 'count' => integer * ); *  array('#page' => array(' ', '  ')) *  array('#cache' => '')     */

# कैश फ़िल्टर निम्नलिखित पैरामीटर भी ले सकता है:

 array( '#cache' => array( 'keys', 'tags', 'time' ) );

रिश्ते कई प्रकार के होते हैं:

 protected $aRelations = array( 'entity'=>array(EntityORM::RELATION_TYPE_BELONGS_TO,'ModuleSome_EntitySome','field_id'), //      . ,   prefix_forum_topic    ID' ,      ID    'entity'=>array(EntityORM::RELATION_TYPE_HAS_MANY,'ModuleSome_EntitySome','field_id'), //    'entity'=>array(EntityORM::RELATION_TYPE_HAS_ONE,'ModuleSome_EntitySome','field_id'), // , ,    ( )  ,       () ort 'entity'=>array(EntityORM::RELATION_TYPE_MANY_TO_MANY,'ModuleSome_EntitySome','field_id'), //      EntityORM::RELATION_TYPE_TREE //  ,    parent_id   );

संस्थाओं का वर्णन करने के बाद, निम्नलिखित तरीके हमारे लिए उपलब्ध होंगे:

 /** *   [name]    */ /** *    */ Add(); Update(); Save(); //   Update()  Add(),        ,      () ort Delete(); Reload(); // : $oParam->setTitle('--'); $oParam->Update(); /** *    /  */ ShowColumnsFrom[Table](); LoadTreeOf[Entity](); Get[Entity]ItemsBy[Filter, Array, JoinTable, Gte, Lte, Gt, Lt, Like, In](); Get[Entity]All(); Get[Entity]ItemsAll(); /** * ,     tree */ GetChildrenOf[Entity](); GetParentOf[Entity](); GetDescendantsOf[Entity](); GetAncestorsOf[Entity](); // : $this->ModuleHabr_GetTopicItemsAll(); /** *  -   singleton Engine,     */ get[Column](); // : $oParam->getTitle();

डेटाबेस में तालिकाओं को इस प्रकार नामित किया जाना चाहिए: उपसर्ग_ <मॉड्यूल-नाम> _ <इकाई-नाम> (या कॉन्फ़िगर में उनके नाम लिखें), लेकिन यदि इकाई का नाम मॉड्यूल के नाम से मेल खाता है, तो बस तालिका का नाम इस तरह से रखें: उपसर्ग_ <मॉड्यूल- नाम>। फ़ील्ड्स के अपने मानक भी होते हैं: <इकाई-नाम> _ <फ़ील्ड-नाम>, या बस <फ़ील्ड-नाम>।

यह सब, सज्जनों, आपके ध्यान के लिए धन्यवाद। मैं आपको याद दिलाता हूं कि नवीनतम फोरम स्रोतों को जीआईटी में देखा जा सकता है।

UPD : लेख के लिए सुधार किए गए, उनकी टिप्पणियों के लिए ort का धन्यवाद।

LiveStreet और ORM

More articles: