👴🏻 👨🏾‍🤝‍👨🏽 📭 PHPLego: Do-it-खुद की वेबसाइट प्लगइन्स 🧐 🏢 🈂️

सुप्रभात, प्रिय गृह पाठकों!

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

इस लेख में मैं एक मामूली माइक्रोबाइक साझा करना चाहता हूं जो साइट निर्माण के कठिन व्यवसाय में मेरी मदद करता है।

आपके साथ हमारा पहला परिचित बहुत दिलचस्प निकला, और मैं आपकी रचनात्मक आलोचना के लिए ईमानदारी से धन्यवाद देता हूं। मैं उसी नस में जारी रहने की उम्मीद करता हूं।

इसलिए, अपने लिए, मैंने निम्नलिखित मानदंडों के अनुसार समस्या को तैयार किया:

1) प्रत्येक मॉड्यूल में एक फ़ोल्डर में काम करने के लिए आवश्यक सभी चीजें होनी चाहिए - टेम्प्लेट, मॉडल और नियंत्रक। ताकि इसे आसानी से कॉपी किया जा सके, नया बनाया जा सके और नया मॉड्यूल बनाया जा सके।

2) मॉड्यूल को इसे बनाने वालों के बारे में कुछ भी जानने की जरूरत नहीं है - यह वह सभी डेटा प्राप्त करता है जो इसे कंस्ट्रक्टर के माध्यम से काम करने की आवश्यकता होती है। यह सुनिश्चित करना है कि मॉड्यूल न केवल मेरी साइट पर काम करता है, बल्कि मेरे सभी दोस्तों और ग्राहकों की सभी साइटों पर भी बिना किसी फाइल के डब किया जाता है।

3) मॉड्यूल का उपयोग करने के लिए कहीं और अतिरिक्त फ़ाइलों को पंजीकृत करने या शामिल करने के लिए आवश्यक नहीं है। यह मूर्खतापूर्ण कष्टप्रद है।

4) एक मॉड्यूल में मॉड्यूल शामिल हो सकते हैं। यानी नेस्टेड मॉड्यूल के लिए समर्थन होना चाहिए।

5) मॉड्यूल टेम्प्लेट के अंदर लिंक (एक href = ...) होना चाहिए, भले ही नेस्टिंग मॉड्यूल कितना गहरा हो। अगर हम एक मूल मॉड्यूल से दूसरे में मॉड्यूल को स्थानांतरित करते हैं, तो टेम्प्लेट्स को कॉर्न नहीं करने के लिए।

6) साइट खुद भी एक मॉड्यूल होनी चाहिए, उस मामले के लिए। किसी मित्र से कार्य स्थल खरीदने के लिए, उसे एक फ़ोल्डर में रखें और अनावश्यक परिवर्तन के बिना एक पृष्ठ पर सभी को एम्बेड करें।

खैर, एक लेख के लिए, मुझे लगता है कि पर्याप्त है, चलो कार्यान्वयन के लिए नीचे उतरें।

प्रोजेक्ट फ़ाइल संरचना

सबसे पहले, परियोजना फाइलों की संरचना को स्केच करें:

/nome/user/www/ |---[.myengine] //    | |---[classes] //   | |---autoload.php //    ,     | `---README.TXT //      |---[classes] //   | |---[articles] //   | | |---[m] //   | | | `---article.class.php //   ( : articles_m_article) | | |---[view] //   CSS   | | | |---[css] //    | | | | `---style.css //    | | | |---article_list.tpl //    | | | `---one_article.tpl //     | | `---controller.class.php //    ( : articles_controller) | |---[comments] //   | |---[fotos] //   | |---[site] //    ( ) | `---[users] //   |---.setup.php //   (  ,    ..) `---index.php //

मॉड्यूल स्टार्टअप

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

हमारे मामले में, एक फ़ोल्डर है / .myengine/classes - ये हमारे इंजन के मॉड्यूल हैं, कुछ मॉड्यूल जो हम अपनी सभी परियोजनाओं में उपयोग करते हैं। ए / कक्षाएं परियोजना के मॉड्यूल का एक फ़ोल्डर है।

तो, autoload.php फ़ाइल स्वयं :

 <?php //    PHP,    ,    new SomeClass() function __autoload($class_name){ $class_folder = 'classes'; //      //   //       $class_folder.      $class_paths[] = dirname($_SERVER['SCRIPT_FILENAME'])."/$class_folder/"; //   $class_paths[] = __DIR__."/classes/"; //     $CLASS_PATHS if(!empty($GLOBALS["CLASS_PATHS"])){ if(!is_array($GLOBALS["CLASS_PATHS"])) throw new Exception('$CLASS_PATHS must be array!'); $class_paths = array_merge($class_paths, $GLOBALS["CLASS_PATHS"]); } //   (      A_B_C) $slashed_class_name = str_replace("_", "/", $class_name); // A/B/C $short_path = substr($slashed_class_name, 0, strrpos($slashed_class_name, '/')); // A/B foreach($class_paths as $class_path){ //   A_B_C    /A/B/C.class.php $file_full_name = "{$class_path}/{$slashed_class_name}.class.php"; if(file_exists($file_full_name)){ require_once($file_full_name); return; } //   A_B_C    /A/B/C/A_B_C.class.php //     -      (     ) $file_full_name = "{$class_path}/{$slashed_class_name}/{$class_name}.class.php"; if(file_exists($file_full_name)){ require_once($file_full_name); return; } } } ?>

स्टार्टअप फाइल पर थोड़ा स्पष्टीकरण। यहां हमने वैश्विक $ CLASS_PATHS सरणी में मॉड्यूल पथ जोड़ने की क्षमता बनाई। ऑटोलॉड इस क्रम में मॉडल पथों के माध्यम से चक्र करेगा:

1) पहली बार बुलाया फ़ाइल के बगल में कक्षाएं फ़ोल्डर में देखें

2) यदि नहीं मिला, तो इंजन मॉड्यूल में देखें

2) अगर आपको यह नहीं मिला, तो यह $ CLASS_PATHS में जोड़े गए सभी फ़ोल्डरों पर पुनरावृत्ति करेगा।

मैं $ CLASS_PATHS में बहुत सारे रास्तों को जोड़ने की सिफारिश नहीं करूंगा - आखिरकार, फ़ाइल के अस्तित्व के बारे में फाइल सिस्टम के लिए हर कॉल समय है। हालांकि छोटा, लेकिन फिर भी।

इसके अलावा, सभी प्रोजेक्ट फ़ाइलों की सुविधा और पोर्टेबिलिटी के लिए, मैं एक फ़ाइल, एक निश्चित .setup.php बनाने का सुझाव देता हूं। इसे प्रोजेक्ट के रूट पर, साथ ही उन सभी सबफ़ोल्डर्स में बनाएं जहाँ मॉड्यूल का उपयोग करके PHP फ़ाइलों को संग्रहीत किया जाता है। रूट .setup.php में मॉड्यूल स्टार्टअप फ़ाइल शामिल होगी:

 <?php include __DIR__.'.myengine/autoload.php'; //    //     ,      ?>

और प्रोजेक्ट सबफ़ोल्डर में सभी .setup.php फ़ाइलों में शीर्ष-स्तर .setup.php शामिल होगा:

 <?php //  .setup.php  : include __DIR__.'/../.setup.php'; ?>

यह सुविधाजनक है क्योंकि मॉड्यूल बनाने वाली सभी फ़ाइलों में हमेशा एक ही पंक्ति होती है:

 <?php include '.setup.php'; // --         //   ,   $m = new SomeModule(); $m->run(); echo $m->getOutput(); ?>

और फिर, फ़ाइलों को फ़ोल्डर से फ़ोल्डर में स्थानांतरित करना (जो किसी भी रचनात्मक परियोजना की अनिवार्यता है), हमें समावेश के मार्ग को सही करने की आवश्यकता है। सब कुछ तुरंत काम करता है।

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

नोट: कुछ प्रोजेक्ट फाइलें 'से शुरू होती हैं।' (डॉट्स) ताकि नाम से छांटने पर वे शीर्ष पर हों

मॉड्यूल नियंत्रक वर्ग

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

 abstract class Lego{ .................. //     http://habrahabr.ru/company/microset/blog/109481/ abstract public function getDir(); //  ,       //     (.. ,     ) public function getWebDir(){ $viewdir = str_replace('\\', '/', $this->getViewDir()); //  ,     //, !      DOCUMENT_ROOT: return str_ireplace($_SERVER['DOCUMENT_ROOT'], '', $viewdir).'/'.$dirname; } //    -,    public function getJavascripts(){ $js = array(); $h = @opendir($this->getDir()."/js"); while($file = @readdir($h)) if(preg_match("/(\.js|\.js\.php)$/i", $file)) $js[] = $this->getWebDir()."/js/".$file; return $js; } //    ,    public function getStylesheets(){ $css = array(); $h = @opendir($this->getDir()."/view/css"); while($file = @readdir($h)) if(preg_match("/(\.css|\.css\.php)$/i", $file)) $css[] = $this->getWebDir()."/view/css/".$file; return $css; } //  ,    ,        public function getHeaderBlock(){ $csses = $this->getStylesheets(); $jses = $this->getJavascripts(); $ret = ""; foreach($csses as $one) $ret .= "\n<link rel='stylesheet' href='{$one}' type='text/css' media='screen' />\n"; foreach($jses as $one) $ret .= "\n<script type='text/javascript' src='{$one}'></script>\n"; return $ret; } //    (   ,  ) public function fetch($template){ return Smarty::fetch($this->getDefaultDir().'/view/'.$template); } }

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

टेम्पलेट्स में सापेक्ष लिंक

यदि हम पिछले लेख को याद करते हैं, तो प्रत्येक लेगो ऑब्जेक्ट एड्रेस बार में अपने सरणी चर को किराए पर लेता है, जिसका नाम मॉड्यूल के नाम से मेल खाता है। मॉड्यूल नियंत्रक की कुछ विधि को संदर्भित करने के लिए, यह वर्तमान पता बार को लेने के लिए पर्याप्त है और इसमें केवल वर्तमान मॉड्यूल से संबंधित डेटा को प्रतिस्थापित करना है। एड्रेस बार के GET मापदंडों के साथ आलसी काम के लिए, आइए UriConstrucor class बनाएं:

 //       class UriConstructor{ public $arr; public function __construct($arr = false){ $this->arr = $arr ? $arr : $_GET; } //      (     ) public function put($key, $val){ $this->arr = array_replace_recursive($this->arr, array($key => $val)); return $this; } //      public function remove($key){ unset($this->arr[$key]); return $this; } //         public function clear(){ $this->arr = array(); return $this; } //         public function set($lego_name, $action /*....*/){ if(isset($this->arr[$lego_name]) && !is_array($this->arr[$lego_name])) unset($this->arr[$lego_name]); $this->arr[$lego_name]['act'] = $action; $params = func_get_args(); array_shift($params); array_shift($params); foreach($params as $key=>$one){ $this->arr[$lego_name][$action][$key] = $one; } return $this; } //    ,        public function setAct($action /*....*/){ $lego = Lego::current(); $params = array($lego->getName()); $params = array_merge($params, func_get_args()); return call_user_func_array( array($this, "set"), $params ); } //    get-,   (    ) public function url($path = false){ if(!$path) $path = $_SERVER['SCRIPT_NAME']; return $path.'?'.$this; } //      -    GET- public function __toString(){ return http_build_query($this->arr); } //      GET-   public function asArray(){ return $this->arr; } }

और लेगो बेस क्लास में, हम कुछ और तरीके जोड़ते हैं:

 abstract class Lego{ .................. //    public function uri(){ return new UriConstructor(); } //  ,   ,         href //    action- ,    ,    public function actUri($action /* params */){ $params = func_get_args(); array_unshift($params, $this->getName()); return call_user_func_array( array($this->uri(), "set"), $params ); } }

और टेम्प्लेट में हम इस तरह लिंक लिखते हैं:

 <a href="{$lego->actUri('allfotos')->url()}"> </a>  ,  ,  : <a href="{$lego->actUri('showonefoto', $id)->url()}"> </a> //       : <a href="/index.php?.....__...&fotos[act]=showonefoto&fotos[0]=123">....</a>

सबसे पहले, निश्चित रूप से, आपको लेगो ऑब्जेक्ट को टेम्पलेट इंजन में पास करना होगा, ताकि $ लेगो वेरिएबल उपलब्ध हो। यह लेगो बेस क्लास के रन () पद्धति में किया जा सकता है:

 abstract class Lego{ .................. //    public function run(){ Smarty::assign("lego", $this); //   $lego -     ..... //    } }

अब, अब हमने टेम्प्लेट को भी खोल दिया है। मॉड्यूल यह जानना बंद कर देता है कि कौन सा प्रोजेक्ट उन्हें बनाता है, और कौन सा मॉड्यूल, वे प्रोजेक्ट में और प्रोजेक्ट के बीच आसानी से चल-फिर सकते हैं।

बेशक, मॉड्यूल को किसी तरह परियोजना के साथ जोड़ा जाना चाहिए, अन्यथा यह पूरी तरह से अर्थहीन होगा। इसलिए, डेटा कंस्ट्रक्टर के माध्यम से प्राप्त किया जाना चाहिए।

यहाँ एक विशिष्ट मॉड्यूल के लिए कोड है:

 /*  ,   ,    $entity_id  $entity_name */ class fotos_controller extends Lego{ private $entity_id; private $entity_name; private $num_for_page = 5; //     ( ),     function __construct($name = false, $entity_id = 0, $entity_name = "User"){ parent::__construct($name); $this->entity_id = $entity_id; $this->entity_name = $entity_name; } //   ,       Lego. public function getDir(){ return __DIR__; } //   -    //   ,    function action_index(){ Database::query("select * from `fotos` where `entity_name`='{$this->entity_name}' and `entity_id`={$this->entity_id} and deleted = 0 order by created desc"); $fotos = Database::fetchObjects(); Output::assign("fotos", $fotos); return $this->fetch("allfotos.tpl"); } //        function action_mainbar(){ $offset = $this->_get($this->getName()."_offset", 0); Database::query("select * from `fotos` where `entity_name`='{$this->entity_name}' and `entity_id`={$this->entity_id} and deleted = 0 order by created desc limit {$offset}, ".($this->num_for_page+1)); $fotos = Database::fetchObjects(); Output::assign("fotos", $fotos); Output::assign("offset", $offset); Output::assign("num_for_page", $this->num_for_page); return $this->fetch("lego_fotos.tpl"); } //             function action_sidebar(){ return $this->action_mainbar(); } //     (   POST) function action_submit(){ $f = new tbl_fotos(); $f['entity_name'] = $this->entity_name; $f['entity_id'] = $this->entity_id; $f['user_id'] = User::getCurrentUser()->getId(); $f['text'] = $this->_post($this->getName()."_text"); $f['file_id'] = FotoStorage::putFromPost($this->getName()."_file"); if($f['file_id']) $f->insert(); $this->_goto($this->actUri("mainbar")->url()); //_goto -   header("Location: ... } //       function action_showone($foto_id){ $f = new tbl_fotos($foto_id); Output::assign("foto", $f); $ret = $this->fetch("showone.tpl"); // .    $c = new comments_controller("foto_comments", "tbl_fotos", $f->getId()); $c->run(); return $ret.$c->getOutput(); //    } //  "  " function action_set_as_main($foto_id){ Auth::authorize(); $f = new tbl_fotos($foto_id); $user = $f->getOwner(); $user['foto'] = $f['file_id']; $user->update(); $this->_goto($this->actUri("showone", $foto_id)->url()); } //  " " function action_delete($foto_id){ Auth::authorize(); $f = new tbl_fotos($foto_id); //FileStorage::delete($f['file_id']); if($f->isMain()){ $user = User::getCurrentUser(); $user['foto'] = ""; $user->update(); } $f['deleted'] = 1; $f->update(); $this->_goto($this->actUri("showone", $foto_id)->url()); } //  "  " function action_restore($foto_id){ Auth::authorize(); $f = new tbl_fotos($foto_id); $f['deleted'] = 0; $f->update(); $this->_goto($this->actUri("showone", $foto_id)->url()); } }

प्रत्येक मॉड्यूल, साइट के रूट मॉड्यूल सहित, कोड की निम्नलिखित पंक्तियों द्वारा निष्पादित किया जाता है।

उदाहरण के लिए, यह प्रोजेक्ट के मूल में index.php है:

 <?php include ".setup.php"; //    $lego = new site_controller(); //  -  $lego->run(); //   echo $lego->getOutput();// !      ?>

बस इतना ही।

कैसे लेगो-मॉड्यूल जीवन-देने वाले AJAX को जोड़ा जाए, आप यहां पढ़ सकते हैं।

आप वास्तव में परीक्षण कर सकते हैं कि यह यहां AJAX के साथ कैसे काम करता है ।

मुझे उम्मीद है कि यह लेख किसी के लिए उपयोगी है।

सभी सफल लेगो प्रोग्रामिंग। :)

आपका ध्यान के लिए धन्यवाद! हमेशा तुम्हारा, जोज़िक।

PHPLego: Do-it-खुद की वेबसाइट प्लगइन्स

प्रोजेक्ट फ़ाइल संरचना

मॉड्यूल स्टार्टअप

मॉड्यूल नियंत्रक वर्ग

टेम्पलेट्स में सापेक्ष लिंक

More articles: