मौजूदा php कोड में नेमस्पेस एम्बेड करें

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

मैंने अपनी कई परियोजनाओं का नामस्थान में अनुवाद किया, जो आपस में जुड़ी हुई थीं। परियोजनाएं बहुत बड़ी नहीं हैं और मैंने सप्ताहांत में पूरा परिवर्तन किया।

संक्रमण स्वयं किसी विशेष समस्या को प्रस्तुत नहीं करता है, नीचे मैंने आवश्यक क्रियाओं के अनुक्रम का वर्णन किया है, जो कि अधिकांश भाग के लिए नियमित हैं और अधिकांश कार्य को स्वचालित करने की संभावना है ... लेकिन जैसा कि कहा जाता है, शैतान विवरण में है।

कर्मों का अनुक्रम

क्या अनुवादित होने की आवश्यकता है: कक्षाएं, इंटरफेस, स्थिरांक, फ़ंक्शन।

हम कोड में क्या देख रहे हैं: परिभाषित करें ('{CONSTANT_NAME}'), वर्ग {CLASS_NAME}, इंटरफ़ेस {INTERFACE_NAME}, फ़ंक्शन {FUNCTION_NAME}।

अगला, हम एक तालिका संकलित करते हैं, जहाँ हम अपनी सभी संस्थाओं का परिचय देते हैं, जिसकी घोषणा हमने पिछले चरण में की थी। हम सभी संस्थाओं की घोषणाओं में आवश्यक नाम स्थान जोड़ते हैं।

अगला, हम कोड के माध्यम से जाते हैं और कॉल को तालिका से संस्थाओं में बदलते हैं, कॉल में आवश्यक नाम स्थान जोड़ते हैं, बशर्ते कि कॉलिंग कोड में इकाई से अलग नाम स्थान हो।

वास्तव में इस पर मुख्य और सबसे स्पष्ट हिस्सा समाप्त होता है।
यदि आपके पास एक ऑटोलैडर है, तो आपको इसे लोड करने योग्य कक्षाओं के नामस्थान को पहचानने के लिए सिखाने की आवश्यकता है।

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

और क्या बदलने की जरूरत है
नाम स्थान की घोषणा करके, आप वैश्विक संस्थाओं को कॉल को तोड़ देते हैं, उदाहरण के लिए, यदि आपका कोड एक फेंक नया अपवाद चलाता है, तो जब आप नाम स्थान दर्ज करते हैं, तो यह कोड टूट जाएगा। नए \ Exception को फेंकने के लिए आपको कोड बदलने की आवश्यकता होगी क्योंकि वैश्विक नामस्थान में अपवाद वर्ग मौजूद है। आप निम्न संरचनाओं की खोज में कोड के माध्यम से जा सकते हैं:
नई क्लास, क्लास :: मेथड, क्लास, इम्प्लीमेंट इंटरफेस आदि का विस्तार करती है।

पिछले चरणों में, हमने घोषित संस्थाओं की तालिका संकलित की और फिर कोड द्वारा उनकी कॉल की खोज की। यदि आपके कोड में फॉर्म के निर्माण शामिल हैं:
<?php
$class = 'Foo';
$class .= $bar;
$instance = new $class();
?>

फिर, तदनुसार, इस तरह के कोड को भी ढूंढना और बदलना होगा, पिछले चरण इसे ठीक नहीं करेंगे।

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

निष्कर्ष

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

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