XenForo: प्रोग्रामर्स के लिए फोरम आर्किटेक्चर का एक संक्षिप्त अवलोकन

शुभ दोपहर



इस लेख में, मैं संक्षेप में नए मंच इंजन XenForo, VBulletin और IPB के एक नए प्रतियोगी की वास्तुकला का वर्णन करने की कोशिश करूंगा, स्रोत के साथ परिचित के कुछ घंटों के बाद मैं कितना सफल होगा। XenForo के बारे में, VBulletin3, साइरस और माइक के पूर्व लेखकों द्वारा डिज़ाइन किया गया था, मैंने पहले ही थोड़ा लिखा था ।

आयाम

XenForo कोड के मुख्य भाग का आकार 3.24 एमबी (3 405 312 बाइट्स) है। एक और 8.31 एमबी (8 724 429 बाइट्स) ज़ेंड फ्रेमवर्क द्वारा कब्जा कर लिया गया है, जो एक्सनफ़ोरो कोड के साथ आता है।

MVC

XenForo पूरी तरह से MVC आर्किटेक्चर पर आधारित है। मॉडल, विचार और नियंत्रक के लिए अलग-अलग कक्षाएं हैं। रूट इंडेक्स। एफपी आकार में 467 बाइट्स है और समाप्त होता है, क्योंकि यह ऐसे मामलों में होना चाहिए

$fc = new XenForo_FrontController(new XenForo_Dependencies_Public()); $fc->run();
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

बेशक, क्लास ऑटोलैडर उपयोग में है। ZF में क्लास नामकरण प्रणाली।



MVC स्वयं अभी भी आंतरिक रूप से Zend वर्गों का उपयोग करता है, लेकिन तथ्य यह है कि XenForo_Controller को संबंधित ZF वर्गों से विरासत में नहीं मिला है, यह बताता है कि यह हिस्सा फिर से लिखा जाएगा।



सभी नियंत्रकों को लगभग एक ही तरीके से विरासत में मिला है: वर्ग XenForo_ControllerPublic_Forum, XenForo_ControllerPublic_Abstract का विस्तार करता है। अपने कार्यों के साथ सिम्फनी के बाद, यह दृष्टिकोण कुछ असामान्य है, लेकिन आप जल्दी से इसकी आदत डाल लेते हैं।



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

सामग्री मॉडल

XenForo वास्तुकला को लंबे समय तक रखा गया था :) वैसे भी, फोरम इंजन में पहली बार, मैं अधिक या कम समझदार सामग्री वास्तुकला में आया था, ड्रुपल की याद ताजा करती है ("सब कुछ एक नोड है, याद है?)।" अब तक XenForo में चार प्रकार की सामग्री है: श्रेणी, मंच अनुभाग, पृष्ठ और लिंक (नियमित पुनर्निर्देशित)। प्रत्येक को नोड भी कहा जाता है। इसके अलावा, नोड का प्रत्येक उदाहरण अन्य प्रकार के उदाहरण का पूर्वज / वंशज हो सकता है। मुझे अभी तक नहीं पता है कि यह विस्फोटक मिश्रण, उदाहरण के लिए, एक पृष्ठ और इसके मंच अनुभाग से कैसे प्रदर्शित किया जाएगा, :) की कोशिश नहीं की है। इसके अलावा, कुछ प्रकार की सामग्री को बॉक्स के बाहर थोड़ा विस्तारित किया जा सकता है। इसलिए, उदाहरण के लिए, एक पृष्ठ के लिए, वास्तव में, इसकी HTML सामग्री के अलावा, आप एक PHP हैंडलर निर्दिष्ट कर सकते हैं जो डेटाबेस से अतिरिक्त डेटा प्राप्त करेगा, पृष्ठ के डिजाइन को बदल देगा, इसमें जानकारी सम्मिलित करेगा, या यहां तक ​​कि उपयोगकर्ता पर एक त्रुटि भी फेंक सकता है। PHP हैंडलर्स को हर जगह PHP कोड द्वारा इंगित नहीं किया जाता है, जैसा कि आप उम्मीद कर सकते हैं, लेकिन वर्ग और विधि नामों से। जब हुक सक्रिय हो जाता है, तो क्लास को ऑटोलैडर द्वारा लोड किया जाएगा (तदनुसार, यह फ़ाइल सिस्टम में सही ढंग से स्थित होना चाहिए)।



सामग्री प्रकार अभी भी हार्ड-कोडित हैं; आप उन्हें स्वयं नहीं जोड़ सकते। किसी कारण से, यहां तक ​​कि व्यवस्थापक क्षेत्र में उनके नाम भी स्थानीय नहीं हैं।

तृतीय-पक्ष पुस्तकालयों का उपयोग करना

XenForo कृपाण और Zend फ्रेमवर्क का उपयोग करता है। इसके अलावा, जैसे स्थानों की कोड में उपस्थिति

 ............ /*require_once('Zend/Loader/Autoloader.php'); $autoloader = Zend_Loader_Autoloader::getInstance(); $autoloader->pushAutoloader(array($this, 'autoload'));*/ spl_autoload_register(array($this, 'autoload'));
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

सबसे अधिक संभावना है, इसका मतलब है कि वे विकास की प्रक्रिया में अनावश्यक निर्भरता से छुटकारा पाने के लिए जारी रखेंगे, उन्हें अपने स्वयं के कुछ के साथ प्रतिस्थापित करें, अधिक हल्के और अधिक विशिष्ट।



ZF से बहुत कम वर्गों का उपयोग किया जाता है। उनमें से, Zend_Registry (एक XenForo_Db उदाहरण के रूप में सिंगलटन जैसी वस्तुओं के लिए एक रजिस्ट्री के रूप में), Zend_Config, Zend_Cache (जो विशेष रूप से बहुत सारे कैश, XenForo_Model मॉडल के आधार वर्ग में उपयोग किया जाता है), Zend_Service_ReCaptcha, Zend_Hon.ch



डेटाबेस के साथ काम करने के लिए, हम XenForo_DB वर्ग में लिपटे Zend_DB बंडल (Zend_Db_Adapater_Abstract and Co.) के हिस्से का उपयोग करते हैं, जो फिर से सुझाव देता है कि इस हिस्से को बाद में फिर से लिखा जाएगा।



क्वेरी डिज़ाइनर का उपयोग नहीं किया जाता है, वे सीधे कोड में बनाए जाते हैं, हमेशा की तरह (जो, ज़ाहिर है, कई डेटाबेस का समर्थन करने के लिए कुछ हद तक मुश्किल बनाता है। लेकिन दूसरी तरफ, प्रश्न मॉडल के अंदर केंद्रित हैं, इसलिए ...)

एडऑन आर्किटेक्चर

मंच का विस्तार करने के लिए, कई घटनाओं का इरादा है, जिसके लिए आप हैंडलर लटका सकते हैं। हैंडलर को संकेत दिया जाता है, जैसा कि पहले ही उल्लेख किया गया है, वर्ग और विधि के नाम के माध्यम से, जो आपको एपीसी जैसे त्वरक का उपयोग ऐड-ऑन को कैश करने की अनुमति देता है। प्लगइन के बारे में बुनियादी जानकारी के साथ हैंडलर की सूची को * .xml फ़ाइल में रखा गया है। लिखावट वैकल्पिक है। यह फोरम पर डिबग मोड को सक्रिय करने के लिए पर्याप्त है और अतिरिक्त सुविधाएं व्यवस्थापक पैनल में दिखाई देंगी। निश्चित रूप से, PHP एडऑन फ़ाइलों को पहले उपयुक्त फ़ोल्डर में अनपैक करना होगा। XenForo वर्ग / पुस्तकालय / XenForo में हैं, इसलिए आपका / पुस्तकालय / VasyaCorp में होगा। मैं इससे खुश था, क्योंकि काफी बार मैं VBBletin से हटाए जाने पर फाइल सिस्टम में प्लग-इन अवशेषों की तलाश कर रहा था।



चूंकि लगभग हर ऐडऑन में सेटिंग्स होनी चाहिए, उन्हें सही तरीके से व्यवस्थापक पैनल में बनाया जा सकता है और हुक के साथ जानकारी के साथ * .xml प्लगइन को निर्यात किया जा सकता है। वे XenForo की सेटिंग्स के रूप में एक ही स्थान पर स्थित हैं। आप उन्हें XenForo सामान्य सेटिंग्स अनुभाग में मनमाने स्थानों पर एम्बेड कर सकते हैं। सब कुछ लगभग उसी तरह व्यवस्थित है जैसा कि VBulletin में था। यह बहुत सुविधाजनक है और उन्हें समर्थन देने के लिए व्यावहारिक रूप से कोड लिखने की आवश्यकता नहीं है।



हुक की संख्या से मैं थोड़ा हैरान था। मुझे लगता है कि VBulletin में हुक की गगनभेदी मात्रा सभी को याद है जो सिर में भी नहीं रखी जा सकती है? XenForo में केवल 17 हुक हैं! इस तरह की मात्रा को उनके उद्देश्य से समझाया गया है। यहाँ उनके नाम हैं:

• container_admin_params
• container_public_params
• controller_pre_dispatch
• front_controller_post_view
• front_controller_pre_dispatch
• front_controller_pre_route
• front_controller_pre_view
• init_dependencies
• load_class_bb_code
• load_class_controller
• load_class_datawriter
• load_class_model
• load_class_route_prefix
• load_class_search_data
• load_class_view
• navigation_tabs
• visitor_setup

एक छोटे से कोड के निरीक्षण से पता चला कि load_class_ * हुक परिवार को XenForo वर्ग प्रणाली को गतिशील रूप से विस्तारित करने के लिए डिज़ाइन किया गया है। यहाँ एक महत्वपूर्ण कोड है:

 public static function resolveDynamicClass($class, $type, $fakeBase = false) { if (!XenForo_Application::autoload($class)) { if ($fakeBase) { $fakeNeeded = true; } else { return false; } } else { $fakeNeeded = false; } if (!empty(self::$_classCache[$class])) { return self::$_classCache[$class]; } $createClass = $class; $extend = array(); XenForo_CodeEvent::fire('load_class_' . $type, array($class, &$extend)); if ($fakeNeeded) { if (!$extend) { return false; } eval('class ' . $class . ' extends ' . $fakeBase . ' {}'); } if ($extend) { try { foreach ($extend AS $dynamicClass) { // XenForo Class Proxy, in case you're wondering $proxyClass = 'XFCP_' . $dynamicClass; eval('class ' . $proxyClass . ' extends ' . $createClass . ' {}'); XenForo_Application::autoload($dynamicClass); $createClass = $dynamicClass; } } catch (Exception $e) { self::$_classCache[$class] = $class; throw $e; } } self::$_classCache[$class] = $createClass; return $createClass; }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

पृष्ठ पर कुछ भी बदलने के लिए मेरे लिए visitor_setup हुक का कुछ अप्रत्याशित उपयोग यहां दिखाया गया है । वस्तुतः किसी भी हुक के माध्यम से आप सिस्टम के दिल में उतर सकते हैं और व्यापार कर सकते हैं ।



सामान्य तौर पर, हुक की छोटी संख्या उनकी शक्ति से काफी मुआवजा लगती है।

टेम्पलेट प्रणाली

सभी आधुनिक मंचों की तरह, XenForo में बहुत सारे टेम्पलेट हैं। वाक्यविन्यास काफी शक्तिशाली है (नीचे अंश देखें), हालांकि, यह किसी को आश्चर्यचकित नहीं करेगा। PHPTAL ("nameless" XML / HTML) में विशेष टैग लिखे गए हैं। एक टेम्पलेट में कई फाइलें हो सकती हैं। उदाहरण के लिए, platform_list टेम्पलेट में forum_list, node_list (इसे forum_list में डाला गया है), node_list.css, sidebar.css, sidebar_online_users शामिल हैं। टेम्प्लेट में सीएसएस xen के माध्यम से जुड़ा हुआ है: आवश्यकता है, जो आपको अपनी पसंद के अनुसार सभी सीएसएस फ़ाइलों को कैश करने की अनुमति देता है।

 <xen:require css="node_list.css" /> <xen:if hascontent="true"> <fieldset> <ol class="nodeList sectionMain" id="forums"> <xen:contentcheck> <xen:foreach loop="$renderedNodes" value="$node">{xen:raw $node}</xen:foreach> </xen:contentcheck> </ol> </fieldset> </xen:if> ------------------------------------- <xen:edithint template="node_link.css" /> ------------------------------------- <xen:contentcheck> <xen:foreach loop="$onlineUsers.records" value="$user"> <xen:if is="{$user.is_moderator} OR {$user.is_admin}"> <li> <xen:avatar user="$user" size="s" img="true" /> <a href="{xen:link members, $user}" class="username">{xen:helper richUserName, $user}</a> <div class="muted">{xen:helper userTitle, $user}</div> </li> </xen:if> </xen:foreach> </xen:contentcheck>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

टेम्प्लेट में सहायकों के उपयोग पर ध्यान दें। सहायक, जैसा कि सिम्फनी में है, सिर्फ एक क्लास पद्धति है। उदाहरण के लिए, यहाँ सहायक हेल्परलिंक सहायक कोड है:

 public static function helperUserLink(array $user) { return '<a href="' . XenForo_Link::buildPublicLink('members', $user) . '" class="username">' . htmlspecialchars($user['username']) . '</a>'; }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

खोज इंजन

XenForo में खोज इंजन को एक अलग वर्ग के रूप में लागू किया गया है (कार्यान्वयन के विपरीत जिसे मैं VB से नफरत करता हूं, जिसमें, मेरी राय में, डेवलपर्स खुद लंबे समय से भ्रमित थे, वे बस इसे स्वीकार नहीं करते हैं), XenForo_Search_SourceHandler_Abstract को विरासत में मिला है। वर्तमान में, केवल एक ही कार्यान्वयन है - MySqlFt.php (वर्ग XenForo_Search_SourceHandler_MySqlFt, XenForo_Search_SourceHandler_Abstract का विस्तार करता है, लेकिन Sphinx निकट भविष्य में दिखाई देना चाहिए। फैशन आज ऐसा है :) फ़ोरम पहले जैसे नहीं हैं। छलांग और सीमा से बढ़ना ...



किसी अन्य खोज इंजन को सक्रिय करने के लिए व्यवस्थापक पैनल में कोई विकल्प नहीं है, लेकिन यह मत भूलो कि यह अभी भी एक बीटा है।

स्थानीयकरण प्रणाली

स्थानीयकरण प्रणाली लगभग पूरी तरह से VBulletin से अपने एनालॉग को इस अपवाद के साथ दोहराती है कि कोई वाक्यांश समूह नहीं हैं। यहाँ अंग्रेजी वाक्यांश फ़ाइल की शुरुआत है:

 <?xml version="1.0" encoding="utf-8"?> <phrases> <phrase title="1_more_message" global_cache="0" version_id="1000017" version_string="1.0.0 Alpha 7"><![CDATA[1 more message]]></phrase> <phrase title="about" global_cache="0" version_id="1000015" version_string="1.0.0 Alpha 5"><![CDATA[About]]></phrase>
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

प्रत्येक ऐडऑन के अपने वाक्यांश हो सकते हैं। भाषाओं का निर्यात किया जा सकता है। आप व्यवस्थापक पैनल में सीधे ऐड-ऑन का अनुवाद कर सकते हैं।



वैसे, XenForo का रूसी स्थानीयकरण लगभग तैयार है ।

शैली प्रणाली

मैं एक डिजाइनर नहीं हूं और सामान्य तौर पर मेरा स्वाद खराब है। डिजाइन और इसके विकास के बारे में सब कुछ मुझे डराता है। लेकिन XenForo में हम VB के समान एक पेड़ जैसी शैली प्रणाली देखते हैं, जिसमें हम कुछ शैली को आधार के रूप में ले सकते हैं और इसकी सेटिंग्स या टेम्पलेट का हिस्सा बदल सकते हैं। केवल साइरस और माइक ने सबसे अच्छे सीएसएस संपादक को लागू किया जो मैंने अपने जीवन में कभी देखा है। ड्रीमविवर आराम कर रहा है :)। XenForo में, सब कुछ कॉन्फ़िगर किया गया है और काफी नेत्रहीन रूप से कॉन्फ़िगर किया गया है। सीधे CSS को एडिट करने के बारे में भूल जाइए, दो हज़ार वैरिएबल वाली शीट के बारे में कि किसी प्रकार का गधे VB में लागू किया गया एक बुरा व्यक्ति है। यहां सब कुछ बहुत सक्षम रूप से समूहीकृत किया गया है ताकि 99% अनुभाग एक स्क्रीन पर फिट हो सकें। यदि आप डिजाइन के मामले में चूसने वाले नहीं हैं, जैसा कि मेरे पास एक कलात्मक स्वाद है, तो आप शायद अपने डिजाइनर को खारिज कर सकते हैं, क्योंकि आप शैली को खुद बना सकते हैं (कुछ महीनों में, जैसा कि आप संपादक के साथ पर्याप्त खेलते हैं)।

प्रमाणीकरण प्रणाली

क्या आपके पास एक डेटाबेस है, कहो, वर्डप्रेस से? अपने पासवर्ड को बचाने के साथ WP से XenForo डेटाबेस में उपयोगकर्ताओं को आयात करें! इसे बाद में काम करने के लिए, आपको बस XenForo_Authentication_Abstract वर्ग का विस्तार करना होगा ताकि XenForo को पासवर्ड को सत्यापित करने के बारे में बताया जा सके। उपयोगकर्ता डेटा xf_user_authenticate तालिका द्वारा आपके प्रमाणीकरण सिस्टम से जुड़ा हुआ है।

संचार सेवाएं

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

 <?php class XenForo_Model_IdentityService_Icq extends XenForo_Model_IdentityService_Abstract { protected function _getIdentityServiceId() { return 'icq'; } static public function verifyAccountName(&$accountName, &$error) { if (!preg_match('/^\d+$/', $accountName)) { $error = new XenForo_Phrase('please_enter_valid_icq_uin_using_numeric_characters_only'); return false; } return true; } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

अब कोई भी अपनी प्रोफ़ाइल के ICQ क्षेत्र में लाइन "ऊन के मोज़े बेचने" में प्रवेश नहीं कर पाएगा :)

अधिकारों और विशेषाधिकारों की प्रणाली

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



अनुमतियाँ चार प्रकार की होती हैं। इनहेरिट, अनुमति, निरस्त, अस्वीकार। अब तक मैं यह नहीं समझ पाया हूं कि रेवोक, डेनी से कैसे अलग है। इसके अलावा, रिवोक डिफ़ॉल्ट रूप से समूह के अधिकारों में नहीं है, जो बताता है कि यह प्रकार अधिकारों की विरासत के साथ जुड़ा हुआ है।



फोरम को डिबग मोड में बदलने के बाद, आप सिस्टम में नए प्रकार के विशेषाधिकार जोड़ सकते हैं (ऐड-ऑन उन्हें भी जोड़ सकते हैं)। कोड में, उन्हें कुछ इस तरह से चेक किया जाता है:

 $users[$userId]['canCleanSpam'] = (XenForo_Permission::hasPermission($visitor['permissions'], 'general', 'cleanSpam') && $this->getModelFromCache('XenForo_Model_User')->couldBeSpammer($users[$userId]));
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

सामान्य इंप्रेशन

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



वैसे, मैं वास्तव में PHPBB3 के लिए तत्पर था, मैं इसे गंभीरता से करना चाहता था। लेकिन मेरे लिए इसकी वास्तुकला XenForo की वास्तुकला की तुलना में बहुत कम स्पष्ट और तार्किक लगती है। ईमानदारी से, मैंने PHPBB3 में कभी प्रवेश नहीं किया। हम सिम्फनी 2 पर चार का इंतजार करेंगे ...



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



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