डेटाबेस माइग्रेशन - अपने आवेदन के साथ एकीकरण

यह लेख मिग्रेटन लाइब्रेरी के व्यावहारिक उपयोग के लिए समर्पित है, जो कोडइग्निटर संस्करण 2.1.0 अपडेट में दिखाई दिया। मैं दृढ़ता से अनुशंसा करता हूं कि आप इस सामग्री को पढ़ने से पहले लेख के पहले भाग को पढ़ते हैं, जो सीधे माइग्रेशन के निर्माण को संदर्भित करता है।

समस्या और उसके समाधान का विवरण

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

आगंतुकों के लिए अलर्ट जोड़ें

जिस प्रोजेक्ट के लिए मैंने माइग्रेशन इंटीग्रेशन किया था, सभी नियंत्रकों को भी मूल CI_Controller नहीं , बल्कि विस्तारित MY_Controller विरासत में मिली है , जिसमें डेटाबेस सहित इसके निर्माता में कुछ उपयोगिता क्रियाएं शामिल हैं। इसलिए, फ़ाइल % site_path% / एप्लिकेशन / कोर / MY_Controller.php के लिए हमें कुछ पंक्तियाँ जोड़ने की आवश्यकता होगी:

<?php if ( ! defined('BASEPATH')) exit('No direct script access allowed'); class MY_Controller extends CI_Controller { protected $db_update = FALSE; // it's TRUE if site's database needs update, FALSE otherwise public function __construct() { parent::__construct(); $is_admin_page = is_a($this, 'Admin'); $this->db_update = $this->migration->get_fs_version()!=$this->migration->get_db_version(); if ($this->db_update) { if (!$is_admin_page) show_error(',     ', 503, ',        '); else return TRUE; } ### Your super overpowered code goes here.. } } 

नोट: पिछले लेख की तरह, सभी स्रोत फ़ाइलों को लेख के अंत में सूचीबद्ध किया गया है।

मुझे लगता है कि एक पूरे के रूप में कोड समझ में आता है, यह केवल ध्यान देने योग्य है कि हम त्रुटि को एडमिन पेज ( एडमिन कंट्रोलर, जो MY_Controller वारिस करेंगे ) को छोड़कर हर जगह दिखाएगा। लेकिन व्यवस्थापक पैनल के लिए, हम कंस्ट्रक्टर को आगे निष्पादित नहीं करेंगे, क्योंकि इसमें एक डेटाबेस के लिए कॉल हो सकता है जिसमें एक पुरानी संरचना है। वैसे, जैसा कि आप देख सकते हैं, पेरेंट कंस्ट्रक्टर कोड को कंस्ट्रक्टर में पहले कहा जाता है, जो डेकोरेटर पैटर्न को लागू करता है।

व्यवस्थापक पैनल के माध्यम से एक अद्यतन स्क्रिप्ट बनाएं

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

इसलिए, हमारे पास इसे बनाने का एक कार्य है ताकि आप व्यवस्थापक पैनल में लॉग इन कर सकें, और किसी भी पेज पर डेटाबेस को अपडेट करने के लिए एक सुझाव दिया गया था। इसके लिए, मैजिक _remap मेथड सही है , जिसे कंट्रोलर मेथड्स में से किसी एक को एक्सेस करते समय कहा जाएगा, और एक निर्णय ले सकते हैं, रिक्वेस्टेड मेथड को ट्रांसफर कर सकते हैं या कुछ अन्य एक्शन करने के लिए कुकी दिखा सकते हैं :

  public function _remap($method, $params = array()) { if (!$this->m_user->authorised() && $method != 'index') { header('Location:/admin/'); //If user isn't autorised, redirect him to the login form } if (!$this->db_update || (!$this->m_user->authorised() && $method== 'index') || $method=='logout' || $method=='update_db') { return call_user_func_array(array($this, $method), $params); // Calls requested method if it is ok to do so } else { $this->data['body'] = '<h1>!</h1>  <a href="/admin/update_db">  </a>'; // Show update database link $this->load->view('admin/default.phtml', $this->data); } } 

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

  public function update_db() { $this->data['body'] = '<h1>    </h1>'; if ( ! $this->migration->current()) { show_error($this->migration->error_string()); } $this->load->view('admin/default.phtml', $this->data); } 

कॉन्फ़िगरेशन संपादित करें और परीक्षण करें

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

  $autoload['libraries'] = array('database', 'session', 'migration'); 

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

  $config['migration_enabled'] = TRUE; $config['migration_version'] = 1; $config['migration_path'] = APPPATH . 'migrations/'; 

कृपया ध्यान दें कि मैंने 1 संस्करण को इंगित किया है, जिसका अर्थ है कि हमने पहले ही मेलिंग सूची कार्यक्षमता कर ली है, जिसके लिए हमने पिछले ट्यूटोरियल में माइग्रेशन लिखा था।

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

बोनस - सीएलआई के माध्यम से अद्यतन स्क्रिप्ट

एक बोनस के रूप में, क्ली के माध्यम से अद्यतन करने के लिए एक स्क्रिप्ट बनाने पर विचार करें, जो हमें माइग्रेशन को स्वचालित करने की अनुमति देगा जब वे साइट पर अपलोड किए जाते हैं, उदाहरण के लिए, हुक का उपयोग करके संस्करण नियंत्रण प्रणालियों से।
सौभाग्य से, CodeIgniter अपने नवीनतम संस्करणों में कमांड लाइन से चलने की क्षमता रखता है, जिसे बॉक्स से बाहर कहा जाता है। इसलिए, इसके साथ शुरू करने के लिए, हम नियंत्रक % site_path% / एप्लिकेशन / नियंत्रकों / cli.php को निजी चर $ args के साथ बनाएंगे , जिसमें वे सभी तर्क होंगे जिनके साथ स्क्रिप्ट को बुलाया गया था, नियंत्रक और उसके तरीके के नाम को छोड़कर (हम उन्हें कंस्ट्रक्टर में काट देंगे):

 <?php if ( ! defined('BASEPATH')) exit('No direct script access allowed'); class Cli extends MY_Controller { private $args = array(); // Contains CLI arguments, except controller name and its method public function __construct() { parent::__construct(); if(!$this->input->is_cli_request()) { show_404(); } $this->output->enable_profiler(FALSE); $this->args = array_slice($_SERVER['argv'], 3); } // Other code goes here.. } 

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

अंत में, हम पलायन के लिए एक विधि लिखते हैं:

 public function migration() { if ( !is_array($this->args) || empty($this->args)) { print ( "Usage: php index.php cli migration [OPTIONS]\n\n" ); print ( "Options are:\n" ); print ( "-l, --last\t\tupdate database to the latest version\n" ); print ( "-c, --current\t\t show current versions of database and code\n" ); exit; } for ( $i=0; $i<count($this->args); $i++ ) { $arg = $this->args[$i]; if ( $arg=="-l" || $arg=="--last" ) { print "Updating your database to the latest version..\n"; if (!$this->migration->current()) { print $this->migration->error_string().'\n'; exit; } else print "Update complete!\n"; } elseif ( $arg=="-c" || $arg=="--current" ) { print 'Current code version is:\t'. $this->migration->get_fs_version().'\n'; print 'Current database version is:\t'.$this->migration->get_db_version().'\n'; } } } 

इसे कॉल करने के लिए, आपको बस अतिरिक्त विशेषताओं के बिना कमांड लाइन पर " php /%index_dir%/index.php cli माइग्रेशन " टाइप करना होगा, और स्क्रिप्ट कृपया आपको उपयोग के लिए उपलब्ध विकल्प बताएगी। यदि आप " php /%index_dir%/index.php cli माइग्रेशन -l " टाइप करते हैं, तो विधि आपके डेटाबेस को अपडेट करने और आपको परिणाम देने की कोशिश करेगी।
बेशक, कोड का यह टुकड़ा केवल एक उदाहरण है जो केवल मूल बातें खुद करता है, लेकिन यह सीएलआई और माइग्रेशन का उपयोग करने का एक सामान्य विचार देता है, और आपके लिए जोड़ना मुश्किल नहीं होगा, उदाहरण के लिए, निर्दिष्ट संशोधन से पहले डेटाबेस को अपडेट करने के लिए '-r' विकल्प (जिस तरह से) आपके लिए एक सरल होमवर्क होगा)।

निष्कर्ष

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

पूर्ण स्रोतों के साथ संग्रह डाउनलोड करें

भाग I: डेटाबेस माइग्रेशन - लाइब्रेरी और उसके उपयोग का अवलोकन