XOOPS 2.5 से 2.7 तक अपग्रेड करना

:::सावधानी[पहले बैकअप लें] अपग्रेड करने से पहले हमेशा अपने डेटाबेस और फ़ाइलों का बैकअप लें। कोई अपवाद नहीं. :::

2.7 में क्या बदला

• PHP 8.2+ आवश्यक — PHP 7.x अब समर्थित नहीं है
• संगीतकार-प्रबंधित निर्भरताएँ - कोर लाइब्रेरी composer.json के माध्यम से प्रबंधित की जाती हैं
• PSR-4 ऑटोलोडिंग - मॉड्यूल कक्षाएं नेमस्पेस का उपयोग कर सकती हैं
• बेहतर XoopsObject - नई getVar() प्रकार की सुरक्षा, अप्रचलित obj2Array()
• बूटस्ट्रैप 5 एडमिन — एडमिन पैनल को बूटस्ट्रैप 5 के साथ फिर से बनाया गया

प्री-अपग्रेड चेकलिस्ट

• PHP 8.2+ आपके सर्वर पर उपलब्ध है
• पूर्ण डेटाबेस बैकअप (mysqldump -u user -p xoops_db > backup.sql)
• आपके इंस्टॉलेशन का पूर्ण फ़ाइल बैकअप
• स्थापित मॉड्यूल और उनके संस्करणों की सूची
• कस्टम थीम का अलग से बैकअप लिया गया है

अपग्रेड कदम

1. साइट को रखरखाव मोड में रखें

// mainfile.php — add temporarily
define('XOOPS_MAINTENANCE', true);

2. डाउनलोड XOOPS 2.7

wget https://github.com/XOOPS/XoopsCore27/releases/latest/download/xoops-2.7.x.zip
unzip xoops-2.7.x.zip

3. कोर फ़ाइलें बदलें

नई फ़ाइलें अपलोड करें, छोड़कर:

• uploads/ - आपकी अपलोड की गई फ़ाइलें
• xoops_data/ - आपका कॉन्फ़िगरेशन
• modules/ - आपके स्थापित मॉड्यूल
• themes/ - आपकी थीम
• mainfile.php — आपकी साइट कॉन्फिग

rsync -av --exclude='uploads/' --exclude='xoops_data/' \
  --exclude='modules/' --exclude='themes/' --exclude='mainfile.php' \
  xoops-2.7/ /var/www/html/

4. अपग्रेड स्क्रिप्ट चलाएँ

अपने ब्राउज़र में https://yourdomain.com/upgrade/ पर नेविगेट करें। अपग्रेड विज़ार्ड डेटाबेस माइग्रेशन लागू करेगा।

5. अद्यतन मॉड्यूल

XOOPS 2.7 मॉड्यूल PHP 8.2 संगत होना चाहिए। अद्यतन संस्करणों के लिए मॉड्यूल इकोसिस्टम की जाँच करें।

एडमिन → मॉड्यूल में, प्रत्येक स्थापित मॉड्यूल के लिए अपडेट पर क्लिक करें।

6. रखरखाव मोड निकालें और परीक्षण करें

mainfile.php से XOOPS_MAINTENANCE लाइन हटाएँ सत्यापित करें कि सभी पेज सही ढंग से लोड हुए हैं।

सामान्य मुद्दे

अपग्रेड के बाद “कक्षा नहीं मिली” त्रुटियाँ

• XOOPS रूट में composer dump-autoload चलाएँ
• xoops_data/caches/ निर्देशिका साफ़ करें

अपडेट के बाद मॉड्यूल टूट गया

• 2.7-संगत संस्करण के लिए मॉड्यूल के GitHub रिलीज़ की जाँच करें
• मॉड्यूल को PHP 8.2 के लिए कोड परिवर्तन की आवश्यकता हो सकती है (बहिष्कृत फ़ंक्शन, टाइप किए गए गुण)

एडमिन पैनल CSS टूटा हुआ

• अपना ब्राउज़र कैश साफ़ करें
• सुनिश्चित करें कि फ़ाइल अपलोड के दौरान xoops_lib/ को पूरी तरह से बदल दिया गया था