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

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

अन्य बातों के अलावा, यह लाइब्रेरी बिल्कुल जटिल नहीं है, और इसे लागू करना अगर किसी अन्य प्लेटफॉर्म के लिए वांछित है तो मुश्किल नहीं होगा!

लाइब्रेरी अवलोकन

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

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

अब कल्पना करें कि आपको एप्लिकेशन को 3 संस्करणों के माध्यम से अग्रिम रूप से अपडेट करने की आवश्यकता है, या परीक्षण सर्वर पर यह देखने के लिए कि संस्करण को कुछ महीने पहले कैसे बनाया गया था? आसान, बस कोड को बदलना, डेटाबेस के वांछित संस्करण में माइग्रेट करना (माइग्रेशन धीरे-धीरे होगा, उदाहरण के लिए, 4 से 1 से 3 वें और 2 वें, और फिर 1 संस्करण रोल होगा)!

क्या आप मेरी तरह इस अवसर से प्रेरित हैं और इसे आजमाना चाहते हैं? कुछ भी आसान नहीं है!

व्यावहारिक उपयोग

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

वर्ग MY_M माइग्रेशन बनाएँ

इसलिए, शुरुआत के लिए, हमें प्रवासन वर्ग का विस्तार करने के लिए थोड़ा सा फ़ाइल करना होगा।
क्यों? सब कुछ बहुत सरल है, डिफ़ॉल्ट रूप से यह वर्ग रिपोर्ट करने में सक्षम नहीं है कि डेटाबेस और कोड के कौन से संस्करण वर्तमान हैं, और यह पूरी तरह से इन चेकों को पूरे कोड में लागू करने के लिए सही नहीं है, यह एक जगह पर करना बेहतर है।
ऐसा करने के लिए, हम CodeIgniter में उपयोग किए जाने वाले मानक वर्ग विस्तार पद्धति का उपयोग करेंगे - फ़ाइल % site_path% / एप्लिकेशन / लाइब्रेरीज़ / MY_Migration.php कोड के कुछ दर्जन लाइनों के साथ बनाएँ ।
यह वर्ग पूर्वजों के कार्यान्वयन के लिए 2 और सार्वजनिक तरीकों को जोड़ेगा:

/** * Wrapper function for the protected _get_version. * Get's the database current version * * @access public * @return integer Current DB Migration version */ public function get_db_version() { return parent::_get_version(); } /** * Retrieves current file system version * * @access public * @return integer Current file system Migration version */ public function get_fs_version() { return $this->_migration_version; } 

नोट: इसके बाद संक्षिप्त कोड लिस्टिंग दी जा सकती है, लेख के अंत में ट्यूटोरियल में उपयोग की जाने वाली सभी फाइलों का लिंक

जैसा कि आप देख सकते हैं, डेटाबेस संस्करण प्राप्त करने के लिए संरक्षित पद्धति के लिए फ़ंक्शंस केवल रैपर हैं और फिर से $ _migration_version संरक्षित गुण हैं, और काफी स्पष्ट रूप से इनकैप्सुलेशन के उपयोग को प्रदर्शित करता है ।
मैं आपको एक महत्वपूर्ण बिंदु पर ध्यान देने की भी सलाह देता हूं: मूल प्रवासन वर्ग में एक सीमा होती है, जिसके कारण इसके निर्माणकर्ता को केवल तब निष्पादित किया जाता है जब मूल वर्ग को आरंभीकृत किया जाता है।
इसलिए, एप्लिकेशन को सही तरीके से काम करने के लिए, मूल के बजाय स्वचालित रूप से MY_M माइग्रेशन को इनिशियलाइज़ करना , पैरेंट क्लास के कंस्ट्रक्टर को डुप्लिकेट करना आवश्यक है, इसमें लाइन 41 पर स्थिति बदल रही है:

  public function __construct($config = array()) { # Only run this constructor on main library load if (get_parent_class($this) !== FALSE) { return; } ### Other code here... } 

पर

  public function __construct($config = array()) { # Only run this constructor on main library load if (get_parent_class($this) !== FALSE && get_class($this)!='MY_Migration') { return; } ### Other code here... } 

एक माइग्रेशन बनाएं

आधार वर्ग का विस्तार करने से मामला छोटा रह जाता है। लाइब्रेरी को डेटाबेस में परिवर्तन या रोल बैक करने में सक्षम होने के लिए, माइग्रेशन वंश वर्ग (हमारे मामले में MY_M माइग्रेशन ) युक्त माइग्रेशन फ़ाइल बनाना आवश्यक है।
चूंकि यह हमारा पहला माइग्रेशन है, हम निम्न फ़ाइल बनाएंगे : % site_path% / एप्लिकेशन / माइग्रेशन / 001_add_messages.php , जिसमें अप और डाउन फ़ंक्शन शामिल हैं:

 <?php defined('BASEPATH') OR exit('No direct script access allowed'); class Migration_Add_messages extends MY_Migration { public function up() { $this->db->query(" CREATE TABLE IF NOT EXISTS `email_list` ( `list_id` INT(10) UNSIGNED NOT NULL AUTO_INCREMENT, `email` VARCHAR(255) CHARACTER SET utf8 COLLATE utf8_general_ci NULL DEFAULT NULL ) ENGINE=MyISAM;"); } public function down() { $this->db->query("DROP TABLE IF EXISTS `email_list`"); } } 

कृपया ध्यान दें कि माइग्रेशन वाली फाइलों में संस्करण के 3-टास्किंग डिजिटल सीरियल नंबर की शुरुआत होती है, जिसमें वे डेटाबेस का अनुवाद करते हैं, और उनमें निहित वर्ग को फ़ाइल नाम कहा जाता है, जहां संस्करण संख्या के बजाय माइग्रेशन_ है ।

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

अंत में, माइग्रेशन के साथ काम करने के लिए, आपको % site_path% / एप्लिकेशन / config / mig.php फ़ाइल में कॉन्फिग को थोड़ा ट्वीक करने की आवश्यकता है और उन्हें सक्षम करें, देखें कि हमारे कोड को सही तरीके से काम करने के लिए आवश्यक डेटाबेस के पथ और संस्करण को निर्दिष्ट किया गया है (मानक टिप्पणियों से काट दिया गया है) लिस्टिंग):

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

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

परिणाम

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

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

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

पुनश्च: कोडइग्निटर ब्लॉग पर प्रकाशित करने के लिए पर्याप्त कर्म नहीं है, इसलिए अब मैं सामान्य php ब्लॉग प्रकाशित नहीं कर रहा हूँ
UPD: अच्छा अनाम ने थोड़ा कर्म डाला, कोडनिग्नेट ब्लॉग पर स्थानांतरित कर दिया