PHP लीगेसी कोड का रिफैक्टरिंग: A से Z तक — पूर्ण गाइड

PHP लीगेसी कोड का रिफैक्टरिंग: A से Z तक

पुराने (लीगेसी) कोड के साथ काम करना किसी भी PHP डेवलपर के जीवन का एक अपरिहार्य हिस्सा है। देर-सबेर आपको PHP 5.6 (या 4 भी) में लिखा गया एक प्रोजेक्ट मिलेगा, जहाँ कोई ऑटोलोडिंग नहीं है, ग्लोबल वेरिएबल का उपयोग किया जाता है, और बिज़नेस लॉजिक HTML के साथ मिला हुआ है। ऐसे कोड का रिफैक्टरिंग केवल "सफाई" नहीं है, बल्कि एक रणनीतिक प्रक्रिया है जो प्रोजेक्ट को तकनीकी ऋण से बचा सकती है और इसे बनाए रखने योग्य बना सकती है।

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

1. निदान और मूल्यांकन: कहाँ से शुरू करें?

कोड बदलने से पहले, यह समझना ज़रूरी है कि आप किसके साथ काम कर रहे हैं। प्रोजेक्ट के ऑडिट से शुरुआत करें।

चरण 1. "दर्द बिंदु" पहचानें

• निर्भरताएँ: क्या पुरानी लाइब्रेरी का उपयोग किया जा रहा है? उदाहरण के लिए, PDO या MySQLi के बजाय mysql_* फंक्शन।
• आर्किटेक्चर: क्या कोई संरचना (MVC) है? या सारा कोड एक ही फ़ाइल index.php में है?
• परीक्षण: क्या कोई स्वचालित परीक्षण मौजूद हैं? यदि नहीं, तो यह आपकी पहली प्राथमिकता है।

चरण 2. विश्लेषण के लिए उपकरण

समस्या वाले स्थानों को जल्दी से पहचानने के लिए स्थैतिक विश्लेषकों का उपयोग करें:

• PHPStan / Psalm: टाइप त्रुटियाँ और सिग्नेचर बेमेल ढूँढ़ेंगे।
• Rector: स्वचालित रूप से सिंटैक्स को PHP के नए संस्करण में अपडेट करेगा।
• PhpMetrics: चक्रीय जटिलता और कोड सुसंगतता दिखाएगा।

PHP 7.4 से 8.0 में अपडेट करने के लिए Rector चलाने का उदाहरण:

vendor/bin/rector process src/ --set php80

2. "दर्द रहित सर्जरी" रणनीति: चरण-दर-चरण योजना

लीगेसी कोड का रिफैक्टरिंग कोई "बड़ा धमाका" नहीं है। यह छोटे, सुरक्षित कदमों की एक श्रृंखला है। "Strangler Fig" तकनीक का उपयोग करें — पुराने मॉड्यूल को धीरे-धीरे नए से बदलें, सब कुछ एक साथ फिर से लिखे बिना।

चरण 1. कोड को परीक्षणों से कवर करें

परीक्षणों के बिना, रिफैक्टरिंग रूसी रूलेट खेलने जैसा है। विशेषता परीक्षणों (characterization tests) से शुरुआत करें:

class LegacyCalculatorTest extends TestCase {    public function testOldCalculation(): void {        // पुराना कोड चलाएँ और परिणाम रिकॉर्ड करें        $result = legacy_calculation(10, 5);        $this->assertEquals(15, $result);    }}

यह बदलावों से पहले एक "सुरक्षा जाल" बनाएगा।

चरण 2. "गंदे" तर्क को अलग करें

यदि कोड ग्लोबल वेरिएबल ($GLOBALS) के साथ काम करता है, तो उन्हें फंक्शन पैरामीटर में निकालें:

// पहले (ग्लोबल निर्भरता)function processOrder() {    global $db;    $result = $db->query("SELECT * FROM orders");}

// बाद में (निर्भरता इंजेक्शन)function processOrder(PDO $db) {    $result = $db->query("SELECT * FROM orders");}

चरण 3. पुराने फंक्शन को बदलें

उदाहरण के लिए, mysql_* को PDO से बदलना:

// पुराना कोड$link = mysql_connect('localhost', 'user', 'pass');mysql_select_db('test', $link);$result = mysql_query("SELECT * FROM users", $link);

// नया कोड (PDO)$pdo = new PDO('mysql:host=localhost;dbname=test', 'user', 'pass');$stmt = $pdo->query("SELECT * FROM users");$result = $stmt->fetchAll(PDO::FETCH_ASSOC);

3. लीगेसी PHP की सामान्य समस्याएँ और उनके समाधान

समस्या 1: "स्पेगेटी कोड" (लॉजिक और प्रेजेंटेशन का मिश्रण)

समाधान: कोड को परतों में विभाजित करें। बिज़नेस लॉजिक को अलग क्लासेस में निकालें, और HTML को टेम्पलेट्स (जैसे, Twig का उपयोग करके) में रखें।

// खराब: लॉजिक और HTML एक ही फ़ाइल मेंif ($user->isAdmin()) {    echo "<h1>नमस्ते, एडमिन!</h1>";} else {    echo "<h1>नमस्ते, उपयोगकर्ता!</h1>";}

// अच्छा: कंट्रोलर + टेम्पलेट//