ServBay एनवायरनमेंट में OctoberCMS को इंस्टॉल और कॉन्फ़िगर करना

अवलोकन

OctoberCMS एक ओपन-सोर्स कंटेंट मैनेजमेंट सिस्टम (CMS) है, जिसे शक्तिशाली Laravel फ्रेमवर्क पर बनाया गया है। यह अपनी सरलता, लचीलापन और डेवलपर-फ्रेंडली फीचर्स के कारण लोकप्रिय है। इस डॉक्युमेंट का उद्देश्य आपको यह बताना है कि कैसे आप ServBay—जो macOS के लिए डिज़ाइन किया गया एक ऑल-इन-वन लोकल वेब डेवेलपमेंट एन्वायरनमेंट है—में OctoberCMS को सफलतापूर्वक इंस्टॉल और कॉन्फ़िगर कर सकते हैं, ताकि आप OctoberCMS आधारित प्रोजेक्ट डेवेलपमेंट तुरंत शुरू कर सकें।

OctoberCMS क्या है?

OctoberCMS एक सहज बैकएंड इंटरफ़ेस और शक्तिशाली फ्रंटएंड डेवेलपमेंट क्षमताओं के साथ आता है। यह डेवलपर्स को Laravel की प्रतिष्ठित सुविधाओं (जैसे Eloquent ORM, Blade टेम्पलेट इंजन आदि) का उपयोग करके सरल ब्लॉग से लेकर जटिल एंटरप्राइज़ ऐप्लिकेशन तक हर प्रकार की वेबसाइट बनाने की आज़ादी देता है।

आवश्यक शर्तें

OctoberCMS इंस्टॉल करने से पहले, सुनिश्चित करें कि आपके पास ये चीज़ें मौजूद हैं:

1. आपके macOS सिस्टम पर ServBay इंस्टॉल और चालू है।
2. ServBay में PHP (सुझावित 7.4 या इससे अधिक) और MySQL/MariaDB पैकेज चालू एवं सक्षम हैं।
3. ServBay में Composer पैकेज सक्षम है।
4. आपको बेसिक कमांड लाइन संचालन का ज्ञान है।

OctoberCMS इंस्टॉलेशन की प्रक्रिया

नीचे दिए गए स्टेप्स ServBay में OctoberCMS को इंस्टॉल और सेटअप करने की विस्तृत विधि बताते हैं:

स्टेप 1: प्रोजेक्ट डायरेक्टरी बनाएं

सबसे पहले, ServBay के सुझाए गए वेब रूट डायरेक्टरी /Applications/ServBay/www में जाएं, और अपना नया OctoberCMS प्रोजेक्ट रखने के लिए एक नई डायरेक्टरी बनाएं।

cd /Applications/ServBay/www
mkdir servbay-octobercms-app
cd servbay-octobercms-app

स्टेप 2: Composer के साथ OctoberCMS इंस्टॉल करें

ServBay में Composer पहले से इंस्टॉल और कॉन्फ़िगर रहता है। सुनिश्चित करें कि आपने ServBay कंट्रोल पैनल में Composer पैकेज सक्षम किया है। अब, प्रोजेक्ट डायरेक्टरी में नीचे दिया गया Composer कमांड चलाएँ ताकि OctoberCMS की कोर फाइलें डाउनलोड और इंस्टॉल हो जाएं:

composer create-project october/october .

यह कमांड OctoberCMS का नवीनतम वर्शन ऑफिशियल रिपोजिटरी से वर्तमान डायरेक्ट्री (.) में डाउनलोड करेगी।

स्टेप 3: डेटाबेस और यूज़र बनाएं

OctoberCMS को डेटा (कंटेंट, यूज़र, सेटिंग्स आदि) स्टोर करने के लिए MySQL/MariaDB डेटाबेस चाहिए। हम ServBay द्वारा प्रदान किए गए phpMyAdmin टूल की मदद से नया डेटाबेस और यूज़र बनाएंगे।

1. ServBay के phpMyAdmin टूल को खोलें

   ब्राउज़र में ServBay लोकल डेवलपमेंट पैनल https://servbay.host/ खोलें। यहाँ से phpMyAdmin के लिंक (अक्सर https://servbay.host/phpmyadmin/) पर जाएं।

2. नया यूज़र बनाएं और डेटाबेस असाइन करें

   हर ऐप के लिए अलग यूज़र और डेटाबेस बनाना सिक्योरिटी के लिहाज से बेहतर है।

   1. यूज़र अकाउंट पेज खोलें

      phpMyAdmin के मुख्य पेज पर, ऊपर की मेनू बार में "यूज़र अकाउंट्स" पर क्लिक करें।

   2. नया यूज़र अकाउंट जोड़ें

      "Add user account" पर क्लिक करें। इन डिटेल्स के अनुसार फॉर्म भरें:

      • यूज़रनेम: OctoberCMS के लिए एक नाम चुनें, जैसे october_user।
      • होस्टनेम: localhost या 127.0.0.1 चुनें—यह दर्शाता है कि यूज़र सिर्फ लोकल से कनेक्ट कर सकता है।
      • पासवर्ड: एक मजबूत और यूनिक पासवर्ड बनाएं। डेमो पासवर्ड password123 को प्रोडक्शन में इस्तेमाल न करें।
      • रि-एंटर: वही पासवर्ड फिर से डालें।
      • "Database for user" सेक्शन में, "Create database with same name and grant all privileges" चुनें। इससे october_user नाम का नया डेटाबेस बनेगा और इसी यूज़र को सारे अधिकार मिलेंगे।
      • "Global privileges" के अंतर्गत "Grant all privileges" टिक रखना सुनिश्चित करें (अगर पिछले स्टेप में डेटाबेस और अधिकार असाइन किए हैं, तो यह अपने-आप पूरा हो सकता है)।
      • नीचे "Go" या "Apply" बटन पर क्लिक कर बनाएं।

स्टेप 4: वेब सर्वर कॉन्फ़िगर करें (ServBay में साइट जोड़ें)

ब्राउज़र से अपनी OctoberCMS ऐप एक्सेस करने के लिए, आपको ServBay में लोकल वेबसाइट जोड़नी होगी।

1. नई साइट जोड़ें

   ServBay कंट्रोल पैनल खोलें, बाएँ नेविगेशन में "वेबसाइट" (कुछ पुराने वर्शन में "होस्ट") टैब चुनें। "Add Website" बटन पर क्लिक करें।

   नीचे दिए गए डिटेल्स भरें:

   • नाम: एक आसानी से पहचानने वाला नाम दें, जैसे My OctoberCMS Site।
   • डोमेन: लोकल ऐक्सेस के लिए एक डोमेन चुनें, जैसे servbay-octobercms.local। .local एक्सटेंशन इस्तेमाल करें ताकि असली वेबसाइट्स से कोई टकराव न हो।
   • वेबसाइट टाइप: PHP चुनें।
   • PHP वर्शन: OctoberCMS के अनुकूल उसी वर्शन को चुनें जो ServBay में सक्षम है।
   • वेब रूट: ब्राउज़ बटन पर क्लिक कर के स्टेप 1 में बनाई गई डायरेक्टरी /Applications/ServBay/www/servbay-octobercms-app चुनें।

2. सेटिंग्स सेव कर के ServBay रीस्टार्ट करें

   सब बर्न करने के बाद, "Save" पर क्लिक करें। ServBay आपको ज़रूरी बदलाव लागू करने के लिए संबंधित सर्विसेज (जैसे Caddy या Nginx) और खुद को रीस्टार्ट करने का सुझाव देगा। ये करें और सुनिश्चित करें कि सब कुछ ठीक से लागू हो गया है। ServBay डोमेन servbay-octobercms.local को लोकल (127.0.0.1) पर प्वाइंट कर देगा।

स्टेप 5: OctoberCMS के एन्वायरनमेंट वेरिएबल्स कॉन्फ़िगर करें

OctoberCMS (Laravel बेस्ड होने के कारण) .env फाइल से ऐप्लिकेशन की सारी एन्वायरनमेंट सेटिंग्स (जैसे डेटाबेस डिटेल्स, ऐप की, आदि) मैनेज करता है।

1. एन्वायर्नमेंट कन्फिगरेशन फ़ाइल को कॉपी करें

   अपने प्रोजेक्ट की रूट डायरेक्टरी (/Applications/ServBay/www/servbay-octobercms-app) में .env.example फाइल को कॉपी करें और उसका नाम .env रखें:

   cd /Applications/ServBay/www/servbay-octobercms-app
   cp .env.example .env

2. .env फ़ाइल को एडिट करें

   अपनी पसंदीदा टेक्स्ट एडिटर में नई बनाई गई .env फाइल खोलें। डेटाबेस से जुड़ी सेटिंग्स को स्टेप 3 में बनाए गए यूज़र और डेटाबेस के अनुसार एडिट करें:

   # ... अन्य सेटिंग्स ...
   
   DB_CONNECTION=mysql
   DB_HOST=127.0.0.1
   DB_PORT=3306
   DB_DATABASE=october_user  # इसे अपने बनाए डेटाबेस नाम से बदलें
   DB_USERNAME=october_user  # इसे अपने बनाए यूज़र नाम से बदलें
   DB_PASSWORD=password123   # इसे सेट किए गए पासवर्ड से बदलें
   
   # ... अन्य सेटिंग्स ...

   महत्वपूर्ण: DB_DATABASE, DB_USERNAME, और DB_PASSWORD का मान अपने असली डेटाबेस डिटेल्स के अनुसार सही से भरें।

स्टेप 6: OctoberCMS इंस्टॉलर चलाएं

OctoberCMS एक वेब बेस्ड इंस्टॉलेशन विज़ार्ड देता है जिससे अंतिम सेटअप (जैसे डेटाबेस माइग्रेशन, एडमिन अकाउंट बनाना) पूरा कर सकते हैं।

1. इंस्टॉलर पेज पर जाएं

   ब्राउज़र में स्टेप 4 में दी गई लोकल डोमेन के साथ /install.php जोड़कर पेज खोलें:

   https://servbay-octobercms.local/install.php

   यहाँ आपको OctoberCMS का इंस्टॉलेशन विज़ार्ड दिखेगा।

2. डेटाबेस डिटेल्स भरें

   इंस्टॉलेशन विज़ार्ड में वही डेटाबेस जानकारी भरें जो .env फाइल में डाली है:

   • डेटाबेस टाइप: MySQL
   • होस्ट: localhost या 127.0.0.1
   • डेटाबेस नाम: october_user
   • यूज़र: october_user
   • पासवर्ड: password123

   (फिर याद दिलाएँ, असली पासवर्ड उपयोग करें)

3. एडमिन अकाउंट बनाएं

   पेज पर पूछी गई जानकारी भरें—जो एडमिन लॉगिन के लिए चाहिए (यूज़रनेम, पासवर्ड, ईमेल आदि)।

4. इंस्टॉल कंप्लीट करें

   विज़ार्ड पर "Install" या संबंधित बटन दबाएं। इंस्टॉलर डेटाबेस माइग्रेशन, एप्लिकेशन की जेनरेट आदि ऑटोमेटिक कर देगा। इंस्टॉलेशन पूरा होने दें।

स्टेप 7: प्लगिन और थीम इंस्टॉल करना (ऑप्शनल)

इंस्टॉलेशन के बाद आप OctoberCMS एडमिन पैनल (https://servbay-octobercms.local/backend) में लॉगिन कर सकते हैं।

1. प्लगिन इंस्टॉल करें

   "सिस्टम" → "अपडेट" → "प्लगिन" में जाएं। यहाँ आप Marketplace से अपनी ज़रूरत के प्लगिन ढूंढकर इंस्टॉल कर सकते हैं।

2. थीम इंस्टॉल करें

   "सिस्टम" → "अपडेट" → "थीम" में जाएं और अपने प्रोजेक्ट के हिसाब से कोई थीम इंस्टॉल करें।

इंस्टॉलेशन के बाद बेसिक सेटिंग्स और उपयोग

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

• फ्रंटेंड देखें: अपनी लोकल डोमेन https://servbay-octobercms.local/ खोलकर साइट का फ्रंट पेज देखें (आमतौर पर डिफ़ॉल्ट थीम)।
• एडमिन डैशबोर्ड: https://servbay-octobercms.local/backend पर जाएं और इंस्टॉल के समय बनाए गए एडमिन लॉगिन से साइन इन करें।
• पेज बनाएँ: एडमिन के "CMS" → "पेज" सेक्शन में जाकर नए वेबपेज बनाएँ और एडिट करें।
• कंटेंट ब्लॉक बनाएँ: "CMS" → "कंटेंट" में जाकर दोबारा इस्तेमाल किए जा सकने वाले कंटेंट ब्लॉक बनाएँ।
• थीम सेटिंग्‍स बदलें: "CMS" → "थीम" में जाकर सक्रिय थीम की सेटिंग, लेआउट, पार्ट्स आदि कस्टमाइज़ करें।
• यूज़र और परमिशन मैनेज करें: "सिस्टम" → "प्रबंधन" से एडमिन यूज़र और उनके अधिकार सेट करें।

सामान्य प्रश्न (FAQ)

• प्रश्न: servbay-octobercms.local खोलने पर ServBay की डिफ़ॉल्ट पेज या एरर दिखती है?

  • उत्तर: जांचें कि ServBay कंट्रोल पैनल में साइट (servbay-octobercms.local) जोड़ी गई है और वेब रूट /Applications/ServBay/www/servbay-octobercms-app ही है। सेव के बाद सभी बदलाव एक्टिवेट हो चुके हों, इसके लिए सर्विसेज और ServBay को रीस्टार्ट करें। Caddy/Nginx और PHP सर्विसेज चालू हों।

• प्रश्न: https://servbay-octobercms.local/install.php खोलने पर ब्लैंक पेज या एरर आता है?

  • उत्तर: यह अक्सर PHP एरर के कारण होता है। ServBay कंट्रोल पैनल में PHP की एरर लॉग देखिए। आम कारण: फाइल परमिशन गलती (सुनिश्चित करें कि storage, themes, plugins और उनकी सबडायरेक्टरीज़ वेब सर्वर यूज़र द्वारा लिखने योग्य हों), PHP वर्शन या एक्स्टेंशन की समस्या।

• प्रश्न: इंस्टॉलेशन के दौरान डेटाबेस कनेक्शन एरर आता है?

  • उत्तर: .env फाइल में भरी डेटाबेस जानकारी (DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAME, DB_PASSWORD) phpMyAdmin में बनाए गए डिटेल्स से मेल खाती हो, यह जांचें। साथ ही, ServBay में MySQL/MariaDB चालू है या नहीं, यह भी देखें।

• प्रश्न: composer create-project कमांड फेल हो रहा है?

  • उत्तर: सुनिश्चित करें कि ServBay कंट्रोल पैनल में Composer और PHP दोनों पैकेज चालू और सही वर्शन के हों। नेटवर्क कनेक्शन जांचें, क्योंकि Composer फाइल डाउनलोड करता है।

निष्कर्ष

ServBay की सहूलियतों के साथ आप macOS पर OctoberCMS को आसानी से जल्दी इंस्टॉल और कॉन्फ़िगर कर सकते हैं। इस गाइड के मुताबिक स्टेप्स फॉलो करके अपने अगले वेब प्रोजेक्ट के लिए एक शक्तिशाली, डेवलपर-फ्रेंडली लोकल डेवेलपमेंट प्लेटफॉर्म तैयार करें। अब आप OctoberCMS के फीचर्स एक्सप्लोर करना शुरू करें और शानदार वेबसाइट्स बनाएं!