डेटाबेस अपडेट समस्याओं का निवारण

डेटाबेस अपडेट से संबंधित किसी भी समस्या को हल करने से पहले, हमेशा डेटाबेस और कोडबेस का बैकअप लें।

यदि ऐसी कोई समस्या है जो डेटाबेस अपडेट को सुरक्षित रूप से चलाने में बाधा डालती है, तो update.php एक त्रुटि संदेश दिखाएगा।

त्रुटि संदेश को ध्यान से पढ़ें ताकि समस्या को सही तरीके से ठीक किया जा सके।

अमान्य मॉड्यूल या थीम

कुछ मामलों में update.php यह बता सकता है कि कुछ मॉड्यूल या थीम अमान्य हैं। ऐसा तब होता है जब कोई मॉड्यूल या थीम core.extension.yml फ़ाइल में सूचीबद्ध होती है, लेकिन कोडबेस में अनुपस्थित होती है या साइट के साथ असंगत होती है।

इस समस्या को हल करते समय पहले सुनिश्चित करें कि आपने core.extension.yml फ़ाइल का गलत संस्करण इम्पोर्ट नहीं किया है। फिर त्रुटि संदेश के आधार पर आगे की समस्या निवारण करें। समस्या हल होने के बाद update.php को फिर से चलाएँ।

मॉड्यूल या थीम गायब है

1. यदि update.php रिपोर्ट करता है कि कोई मॉड्यूल या थीम अनुपस्थित है और सही core.extension.yml फ़ाइल उपयोग में है, तो सुनिश्चित करें कि मॉड्यूल या थीम आपकी साइट की कोडबेस में मौजूद है।

• उदाहरण के लिए, [site-root]/modules और [site-root]/sites/all/modules निर्देशिकाओं को जांचें। [site-root]/modules को प्राथमिकता दी जाती है, लेकिन दोनों स्कैन किए जाते हैं।

2. यदि फ़ोल्डर पूरी तरह से अनुपस्थित है, तो Drupal.org पर मॉड्यूल खोजें और उसे अपने मॉड्यूल फ़ोल्डर में पुनः डाउनलोड करें। सुनिश्चित करें कि आप अपनी Drupal संस्करण के अनुरूप मॉड्यूल संस्करण डाउनलोड कर रहे हैं।

3. यदि फ़ोल्डर मौजूद है लेकिन कुछ फ़ाइलें गायब हैं या क्षतिग्रस्त हैं, तो आप उसी तरह Drupal.org से मॉड्यूल डाउनलोड कर सकते हैं और मौजूदा फ़ोल्डर को नई प्रति से बदल सकते हैं।

4. यदि मॉड्यूल Drupal.org से डाउनलोड नहीं किया गया था, तो उसका मूल स्रोत खोजने का प्रयास करें।

• यदि मॉड्यूल आपकी साइट या किसी कस्टम एप्लिकेशन से संबंधित है, तो उसकी मूल प्रति खोजें और मॉड्यूल फ़ोल्डर में पुनः जोड़ें।
• यदि मॉड्यूल किसी तृतीय पक्ष (जैसे GitHub) से आया है, तो उसकी मान्य संस्करण खोजें और डाउनलोड करें।

5. यदि मॉड्यूल नहीं मिल रहा है, तो अंतिम उपाय के रूप में आप core.extension.yml से उसकी प्रविष्टि हटा सकते हैं, लेकिन सावधान रहें — इससे साइट पर अन्य गंभीर त्रुटियाँ हो सकती हैं।

6. एक बार मॉड्यूल बहाल हो जाने पर, update.php को फिर से चलाएँ।

मॉड्यूल या थीम Drupal के स्थापित संस्करण के साथ असंगत है

1. यदि update.php बताता है कि कोई मॉड्यूल या थीम Drupal संस्करण के साथ असंगत है, तो आपको या तो Drupal को अपडेट करना होगा या मॉड्यूल/थीम को।

2. पहले जांचें कि आपकी साइट पर Drupal कोर का कौन सा संस्करण स्थापित है। यह आप “रिपोर्ट्स → स्थिति रिपोर्ट” (Reports → Status report) पेज पर देख सकते हैं।

3. फिर मॉड्यूल या थीम की संस्करण जानकारी जानने के लिए modules/modulename/modulename.info.yml फ़ाइल खोलें। फ़ाइल के शीर्ष पर आपको इनमें से कोई एक पंक्ति दिखेगी:

core: 8.x
core_version_requirement: ^8.8 || ^9

इसका अर्थ है कि मॉड्यूल Drupal 8.8+ और Drupal 9 दोनों के साथ संगत है।

core_version_requirement: ^9

यह इंगित करता है कि मॉड्यूल केवल Drupal 9 के साथ संगत है। (core_version_requirement के बारे में अधिक जानकारी।)

core: 8.x

इसका अर्थ है कि मॉड्यूल केवल Drupal 8 के साथ संगत है।

core: 7.x

इसका अर्थ है कि मॉड्यूल केवल Drupal 7 के साथ संगत है।

4. यदि Drupal कोर का संस्करण मॉड्यूल से पुराना है, तो Drupal कोर अपडेट करें।

5. यदि मॉड्यूल का संस्करण Drupal कोर से पुराना है, तो मॉड्यूल का नया संस्करण डाउनलोड और इंस्टॉल करें।

6. यदि कोई संगत संस्करण उपलब्ध नहीं है, तो बैकअप से साइट की पिछली कार्यशील स्थिति पुनर्स्थापित करें।

7. जैसे ही Drupal कोर और मॉड्यूल/थीम दोनों संगत हो जाएँ, update.php को पुनः चलाएँ।

मॉड्यूल या थीम PHP संस्करण के साथ असंगत है

1. यदि मॉड्यूल या थीम PHP संस्करण के साथ असंगत है, तो उसकी .info.yml फ़ाइल में ऐसी पंक्ति खोजें:

php: 7.3

2. विकल्प 1: अपने PHP संस्करण के अनुरूप मॉड्यूल या थीम का संस्करण स्थापित करें।

3. विकल्प 2: अपनी साइट का PHP संस्करण बदलें ताकि यह मॉड्यूल के साथ संगत हो।

4. जैसे ही PHP संस्करण और मॉड्यूल/थीम दोनों संगत हो जाएँ, update.php फिर से चलाएँ।