ServBay वातावरण में Craft CMS इंस्टॉल और कॉन्फ़िगर करना

परिचय

Craft CMS एक शक्तिशाली कंटेंट मैनेजमेंट सिस्टम (CMS) है, जिसे इसकी लचीली कंटेंट मॉडलिंग, सहज यूज़र इंटरफ़ेस और डेवेलपर-फ्रेंडली फ़ीचर्स के कारण डेवेलपर्स द्वारा पसंद किया जाता है। यह जटिल और कस्टमाइज्ड वेबसाइट बनाने के लिए बहुत उपयुक्त है।

ServBay को अपने लोकल डेवेलपमेंट वातावरण के रूप में इस्तेमाल करने से कई फायदे होते हैं — इसमें प्री-कॉन्फ़िगर PHP, डेटाबेस (जैसे MySQL या PostgreSQL), वेब सर्वर (Caddy या Nginx), और बिल्ट-इन Composer एवं कमांडलाइन टूल्स शामिल हैं, जिससे इंस्टॉलेशन और कॉन्फ़िगरेशन की प्रक्रिया बहुत आसान हो जाती है।

यह गाइड बताएगी कि ServBay वातावरण में Craft CMS प्रोजेक्ट को कैसे इंस्टॉल और सेटअप किया जाए।

पूर्वापेक्षाएँ

शुरू करने से पहले, कृपया सुनिश्चित करें कि आपके पास निम्नलिखित चीज़ें उपलब्ध हैं:

1. ServBay इंस्टॉल और चालू है: सुनिश्चित करें कि आपने macOS पर सफलतापूर्वक ServBay इंस्टॉल कर लिया है, और आवश्यक PHP वर्शन (Craft CMS की आवश्यकताएँ देखने के लिए Craft CMS आधिकारिक दस्तावेज़ देखें) तथा डेटाबेस (आमतौर पर MySQL या PostgreSQL) पैकेज सक्रिय हैं। ServBay कई PHP वर्शन और डेटाबेस को सपोर्ट करता है, जिन्हें आप Craft CMS की ज़रूरतों के अनुसार आसानी से बदल और कॉन्फ़िगर कर सकते हैं।
2. बुनियादी कमांडलाइन संचालन का ज्ञान: आपको टर्मिनल में कुछ कमांड चलाने होंगे, जैसे डायरेक्टरी बनाना या Composer रन करना।
3. Composer का ज्ञान: Craft CMS अपनी निर्भरताओं के प्रबंधन के लिए Composer का इस्तेमाल करता है। ServBay में Composer पहले से शामिल है, लेकिन आपको composer create-project कमांड चलाना आना चाहिए।

Craft CMS इंस्टॉलेशन के चरण

नीचे दिए गए हैं ServBay वातावरण में Craft CMS को इंस्टॉल और कॉन्फ़िगर करने के विस्तृत चरण।

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

सबसे पहले, ServBay के डिफ़ॉल्ट वेबसाइट रूट डायरेक्टरी /Applications/ServBay/www में एक नई प्रोजेक्ट डायरेक्टरी बनाएं। ServBay इस डायरेक्टरी को वेब सर्वर के सर्विसिंग डायरेक्टरी के रूप में डिफ़ॉल्ट रूप से कॉन्फ़िगर करता है, जिससे आप सीधे अपने प्रोजेक्ट को एक्सेस कर सकते हैं।

टर्मिनल खोलें और निम्नलिखित कमांड चलाएँ:

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

यह /Applications/ServBay/www डायरेक्टरी के अंदर servbay-craft-app नाम का एक नया फोल्डर बनाएगा और उसी डायरेक्टरी में आपको ले जाएगा।

चरण 2: Composer द्वारा Craft CMS प्रोजेक्ट बनाएं

ServBay में Composer पहले से शामिल है, इसलिए आप प्रोजेक्ट डायरेक्टरी के भीतर Composer का उपयोग करके Craft CMS प्रोजेक्ट बना सकते हैं। Craft CMS की ऑफिसियल सलाह भी यही है।

servbay-craft-app डायरेक्टरी में, यह कमांड चलाएँ:

composer create-project craftcms/craft .

यह कमांड Craft CMS का नवीनतम संस्करण और उसकी सारी निर्भरताएँ वर्तमान डायरेक्टरी (.) में डाउनलोड कर देगा। Composer डाउनलोड और इंस्टॉलेशन पूरा होने तक प्रतीक्षा करें।

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

Craft CMS को कंटेंट और कॉन्फ़िगरेशन जानकारी सहेजने के लिए एक डेटाबेस की ज़रूरत होती है। हम ServBay में शामिल phpMyAdmin या Adminer का उपयोग करेंगे। यहाँ उदाहरण के लिए हम phpMyAdmin का प्रयोग करेंगे।

1. ServBay का बिल्ट-इन डेटाबेस प्रबंधन टूल (phpMyAdmin) खोलें

   ब्राउज़र में ServBay का लोकल डैशबोर्ड खोलें: https://servbay.host/। वहाँ से "phpMyAdmin" लिंक पर क्लिक करें।

   टिप: ServBay में phpMyAdmin का डिफ़ॉल्ट यूज़र आमतौर पर root होता है, पासवर्ड है ServBay.dev। सुरक्षा के लिहाज से, कनेक्ट करने के बाद तुरंत root का पासवर्ड बदलें या नया एडमिन यूज़र बनाएं।

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

   भले ही आप root यूज़र से कनेक्ट कर सकते हैं, लेकिन हर ऐप के लिए अलग यूज़र बनाए रखना सुरक्षित और सुविधाजनक होता है।

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

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

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

      "यूज़र अकाउंट जोड़ें" पर क्लिक करें और यह जानकारी भरें:

      • यूज़रनेम: जैसे craft_user - यह Craft CMS के लिए उपयोग होने वाला यूज़रनेम है।
      • होस्टनेम: localhost या 'लोकल' चुनें, ताकि यह यूज़र सिर्फ लोकल कनेक्शन कर सके।
      • पासवर्ड: एक मजबूत पासवर्ड चुनें। उदाहरण के password123 का इस्तेमाल कभी न करें, वो भी प्रोडक्शन में नहीं। लोकल डेवेलपमेंट में आसान पासवर्ड चलेगा, फिर भी सुरक्षा ध्यान रखें।
      • री-एंटर: पासवर्ड की पुष्टि करें।
      • "यूज़र के लिए डेटाबेस बनाएं" सेक्शन में "यूज़रनेम के नाम से डेटाबेस बनाएं और सभी अधिकार दें" चुनें — इससे craft_user नामक एक डेटाबेस और उसे पूर्ण अधिकार मिल जाएंगे।
      • "सभी अधिकार दें" विकल्प जरूर चेक करें।
      • अंत में "एक्सिक्यूट" बटन दबाएं।

   अब आपके पास craft_user नामक एक डेटाबेस यूज़र और उसी नाम का डेटाबेस बन गया है, जिसपर उसे सभी अधिकार हैं।

चरण 4: वेब सर्वर कॉन्फ़िगर करें (ServBay में वेबसाइट बनाएं)

ServBay के वेब सर्वर (Caddy या Nginx) को आपके नए Craft CMS प्रोजेक्ट को सर्व करने के लिए, आपको ServBay में एक नया "वेबसाइट" कॉन्फ़िगरेशन जोड़ना होगा।

1. ServBay एप्लीकेशन खोलें

   ServBay ऐप शुरू करें।

2. नई वेबसाइट जोड़ें

   ServBay विंडो की बाईं ओर "वेबसाइट्स" टैब पर क्लिक करें (पुराने वर्शन में "होस्ट्स" भी हो सकता है)। नीचे "+" बटन या दाएँ "वेबसाइट जोड़ें" बटन पर क्लिक करें।

   अब ये जानकारी भरें:

   • नाम (Name): जैसे My Craft Site — अपनी वेबसाइट का कोई भी पहचानने योग्य नाम दें।
   • डोमेन (Domains): जैसे servbay-craft.local — आप यहाँ वह लोकल डोमेन डालें जिस पर आप साइट एक्सेस करना चाहते हैं। ServBay आपके लिए लोकल DNS सेट कर देता है।
   • वेबसाइट टाइप (Type): PHP चुनें।
   • PHP वर्शन (PHP Version): वह वर्शन चुनें, जो ऊपर 'पूर्वापेक्षा' में चेक किया था और Craft CMS से कम्पेटिबल है। ServBay में एक साथ कई PHP वर्शन रह सकते हैं।
   • वेबसाइट रूट डायरेक्टरी (Website Root): यह बहुत महत्वपूर्ण है। Craft CMS के पब्लिक एक्सेसिबल फाइल (जैसे index.php) प्रोजेक्ट की web सब-डायरेक्टरी में होते हैं। इसलिए वेब सर्वर की रूट डायरेक्टरी को उसी web फोल्डर पर सेट करें, पूरे प्रोजेक्ट फोल्डर पर नहीं। भरें: /Applications/ServBay/www/servbay-craft-app/web सुनिश्चित करें कि पथ सही है और आपके प्रोजेक्ट के web फोल्डर को पॉइंट कर रहा है।

3. सेव करें

   सारी जानकारी भरने के बाद "सेव" बटन दबाएँ। ServBay वेब सर्वर कॉन्फ़िगरेशन को फिर से लोड करेगा और नया वेबसाइट सेटअप एक्टिव हो जाएगा। अब "वेबसाइट्स" लिस्ट में आपको servbay-craft.local दिखाई देगा।

चरण 5: Craft CMS इंस्टॉलर चलाएँ

अब आप अपने ब्राउज़र के ज़रिये अपने दिए गए डोमेन पर जाकर Craft CMS वेब इंस्टॉलर चला सकते हैं।

1. इंस्टॉलेशन पेज खोलें

   ब्राउज़र में वह लोकल डोमेन खोलें, जो आपने ऊपर सेट किया थाः https://servbay-craft.local/। Craft CMS देखेगा कि इंस्टॉल नहीं है और आपको अपने आप इंस्टॉलेशन पेज (अक्सर https://servbay-craft.local/index.php?p=admin/install) पर रीडायरेक्ट कर देगा।

2. डेटाबेस जानकारी भरें

   Craft CMS इंस्टॉलेशन के दौरान, नीचे बताई गई जानकारी भरें — जो आपने ऊपर डेटाबेस/यूज़र बनाते समय नोट की थी:

   • डेटाबेस सर्वर (Database Server): localhost
   • डेटाबेस नाम (Database Name): craft_user (या जो नाम आपने चुना)
   • यूज़रनेम (Username): craft_user (या चुना हुआ)
   • पासवर्ड (Password): जो भी पासवर्ड आपने craft_user के लिए चुना

   आगे बढ़ें। Craft CMS डेटाबेस से कनेक्ट करने की कोशिश करेगा। कनेक्शन सफल हुआ तो अगला स्टेप खुलेगा।

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

   ऑनस्क्रीन निर्देशों के अनुसार अपना एडमिन यूज़रनेम, पासवर्ड और ई-मेल भरें। एक मजबूत पासवर्ड ज़रूर चुनें।

   आगे बढ़ें।

4. साइट सेटिंग्स

   अपने साइट का नाम आदि बुनियादी जानकारी भरें।

   अब "फिनिश अप (Finish Up)" बटन क्लिक करें। Craft CMS अंतिम सेटअप कम्पलीट करेगा — डेटाबेस टेबल बना देगा, व कॉन्फ़िगरेशन फाइल जनरेट कर देगा।

   इंस्टॉल होने के बाद, आपको Craft CMS के एडमिन लॉगिन पेज पर रीडायरेक्ट कर दिया जाएगा।

चरण 6: बेसिक सेटिंग्स और खोजबीन

Craft CMS एडमिन पैनल में लॉगिन करने के बाद, आप शुरुआती कॉन्फ़िगरेशन और एक्सप्लोरेशन कर सकते हैं:

1. .env फाइल चेक करें: Craft CMS अपनी सेटिंग्स के लिए .env फाइल का इस्तेमाल करता है — जैसे डेटाबेस जानकारी। इंस्टॉलर एक नई .env फाइल बनाता है, जो आपको प्रोजेक्ट रूट (servbay-craft-app/) में मिलेगी। आप इसमें बदलाव कर सकते हैं — मसलन, CRAFT_ENVIRONMENT को dev सेट करना।
2. प्लगइन्स इंस्टॉल करें: एडमिन पैनल में "प्लगइन्स" पर क्लिक करके Craft CMS के लिए प्लगइन्स ब्राउज़, इंस्टॉल और मैनेज कर सकते हैं।
3. कंटेंट स्ट्रक्चर बनाएं: "सेटिंग्स" सेक्शन में जाकर अपने फ़ील्ड्स, सेक्शन्स, कैटेगरीज व टैग्स जैसी कंटेंट स्ट्रक्चर डिज़ाइन करें।
4. ईमेल सेटअप करें: यदि आप लोकल पर ईमेल टेस्ट करना चाहते हैं, तो Craft CMS को ServBay के Mailpit या Mailhog से कनेक्ट करें। .env फाइल या एडमिन मेल सेटिंग्स में SMTP मोड चुनें, सर्वर - localhost, पोर्ट Mailpit/Mailhog का SMTP पोर्ट (ServBay पैनल में देखा जा सकता है) रखें।

अक्सर पूछे जाने वाले सवाल (FAQ)

• प्रश्न: इंस्टॉलेशन के दौरान डेटाबेस कनेक्शन एरर आता है, क्या करें?
  • उत्तर: चेक करें कि Craft CMS इंस्टॉलर में भरी गई डेटाबेस जानकारी (सर्वर एड्रेस, नाम, यूज़रनेम, पासवर्ड) phpMyAdmin में बनायी जानकारी से मेल खाती है या नहीं। साथ ही, ServBay का डेटाबेस सर्वर (MySQL या PostgreSQL) चालू हो।
• प्रश्न: servbay-craft.local खोलने पर 404 या ब्लैंक पेज दिखता है?
  • उत्तर:
    • चेक करें, ServBay में वेबसाइट बनाते समय "वेबसाइट रूट डायरेक्टरी" बिल्कुल सही /Applications/ServBay/www/servbay-craft-app/web है या नहीं — यह सबसे आम गलती है।
    • सुनिश्चित करें, ServBay का वेब सर्वर (Caddy या Nginx) और PHP सर्विस चल रही है।
    • ServBay वेबसाइट लिस्ट में servbay-craft.local वेबसाइट एक्टिव है या नहीं।
• प्रश्न: Composer से Craft CMS इंस्टॉल करने में बहुत समय लगता है या फेल हो जाता है?
  • उत्तर: यह नेटवर्क या Composer मिरर की वजह से हो सकता है। आप चीन के मिरर, जैसे अलीयुन या Packagist China सेट करके ट्राई करें।
• प्रश्न: इंस्टॉल के बाद एडमिन या फ्रंटेंड पेज की CSS वगैरह गायब दिखती है या इमेज लोड नहीं होती?
  • उत्तर: यह अक्सर फाइल परमिशन की समस्या होती है। चेक करें, ServBay के यूज़र को storage और web/cpresources फ़ोल्डर पर लिखने की अनुमति है या नहीं। ServBay ज्यादातर परमिशन अपने-आप सेट करता है, लेकिन जरूरत पड़े तो खुद भी चेक कर सकते हैं या रिस्टोर कर सकते हैं।

निष्कर्ष

इन चरणों का पालन करके, आप ServBay लोकल डेवेलपमेंट वातावरण में Craft CMS को सफलतापूर्वक इंस्टॉल और कॉन्फ़िगर कर सकते हैं। ServBay के समेकित वातावरण से PHP वर्शन प्रबंधन, डेटाबेस सेटअप और वेब सर्वर सेटिंग बहुत आसान हो जाती हैं, जिससे आप Craft CMS की एप्लिकेशन डेवेलपमेंट पर फोकस कर सकते हैं। अब आप Craft CMS की शक्तिशाली कंटेंट मॉडलिंग क्षमताओं से अपनी वेबसाइट या एप्लिकेशन बनाना शुरू कर सकते हैं।