ServBay वातावरण में Contao CMS की स्थापना और कॉन्फ़िगरेशन

Contao एक शक्तिशाली ओपन सोर्स कंटेंट मैनेजमेंट सिस्टम (CMS) है, जो खासतौर पर छोटे और मध्यम व्यवसायिक वेबसाइट, पोर्टल या जटिल वेब एप्लिकेशन विकसित करने के लिए उपयुक्त है। यह गाइड विस्तार से बताती है कि macOS के लिए सुविधाजनक ServBay लोकल वेब डेवलपमेंट वातावरण में Contao कैसे इंस्टॉल और सेटअप करें, ताकि आप Contao प्रोजेक्ट डेवेलपमेंट को तेज़ी से शुरू कर सकें।

ServBay एक ऑल-इन-वन एनवायरनमेंट प्रदान करता है, जिसमें PHP, Composer, डेटाबेस सेवाएं (जैसे MySQL/MariaDB, PostgreSQL) और वेब सर्वर (जैसे Caddy, Nginx, Apache) इंटीग्रेटेड हैं, जिससे लोकल डेवेलपमेंट सेटअप बेहद आसान हो जाता है। ServBay का उपयोग कर, आप आसानी से Contao की सभी आवश्यकताओं को पूरा कर सकते हैं।

Contao क्या है?

Contao एक ओपन सोर्स, PHP आधारित कंटेंट मैनेजमेंट सिस्टम (CMS) है, जिसे इसकी उपयोगकर्ता के अनुकूलता, उच्च लचीलापन और शक्तिशाली एडमिन इंटरफेस के लिए जाना जाता है। इसमें विस्तृत फीचर सेट है, जैसे परिष्कृत परमिशन मैनेजमेंट, वर्शन कंट्रोल, मल्टी-लैंग्वेज सपोर्ट, रिस्पॉन्सिव इमेज हैंडलिंग और मॉड्यूलर आर्किटेक्चर, जिससे आपको एक्सटेंशन के माध्यम से नई क्षमताएं जोड़ने की सुविधा मिलती है। Contao का मूल डिजाइन философी डेवलपर्स और डिज़ाइनर्स को कस्टम वेबसाइट बनाने के लिए एक मजबूत आधार देना है, जिससे उन्हें शुरुआत से सब कुछ बनाने की आवश्यकता नहीं होती।

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

Contao इंस्टॉल करने से पहले, कृपया निम्नलिखित शर्तों को सुनिश्चित करें:

1. ServBay इंस्टॉल और चालू हो: आपके macOS सिस्टम पर ServBay इंस्टॉल होना चाहिए। सुनिश्चित करें कि ServBay चल रहा है, आवश्यक PHP वर्शन (Contao के लिए आवश्यक PHP वर्शन के लिए Contao ऑफिशियल डाक्यूमेंटेशन देखें) और डेटाबेस सर्विस (जैसे MySQL या MariaDB) ServBay में सक्रिय हो।
2. Composer: ServBay में Composer पहले से ही इंटीग्रेटेड है। आपको अलग से इंस्टॉल करने की आवश्यकता नहीं।
3. टर्मिनल एक्सेस: Composer कमांड चलाने के लिए आपको टर्मिनल का उपयोग करना होगा।

Contao की स्थापना के चरण

यह अनुभाग ServBay में Contao को इंस्टॉल और सेटअप करने की विस्तार से गाइड करता है।

चरण 1: प्रोजेक्ट निर्देशिका बनाएँ

सबसे पहले, ServBay की डिफॉल्ट वेबसाइट रुट डायरेक्टरी /Applications/ServBay/www में जाएँ और अपने Contao प्रोजेक्ट के लिए एक नई सबडायरेक्टरी बनाएं।

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

हम Contao को servbay-contao-app फ़ोल्डर में इंस्टॉल करेंगे।

चरण 2: Composer के साथ Contao प्रोजेक्ट बनाएँ

Contao, Composer के माध्यम से इंस्टॉलेशन और प्रबंधन की सिफारिश करता है। ServBay में Composer पहले से ही है, इसलिए प्रोजेक्ट फोल्डर में नीचे दिया गया कमांड चलाएं:

composer create-project contao/managed-edition .

यह कमांड Contao Managed Edition का नवीनतम वर्शन और सभी आवश्यक डिपेंडेंसीज आपके वर्तमान डायरेक्टरी (.) में डाउनलोड कर देगा। यह प्रोसेस आपके इंटरनेट स्पीड के अनुसार थोड़ा समय ले सकता है।

Contao Managed Edition स्पष्टीकरण: contao/managed-edition Contao का ऑफिसियल डिस्ट्रीब्यूशन है, जिसमें Core और अनुशंसित डिपेंडेंसीज़ के साथ एक मानक प्रोजेक्ट संरचना शामिल है। ध्यान दें कि इस पद्धति से इंस्टॉल करते समय वेबसाइट की रुट डायरेक्टरी प्रोजेक्ट के अंदर web सबडायरेक्टरी होती है।

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

Contao को अपनी कंटेंट और सेटिंग्स स्टोर करने के लिए एक डेटाबेस की आवश्यकता होती है। ServBay में phpMyAdmin या Adminer जैसे डेटाबेस प्रबंधन टूल्स उपलब्ध हैं। यहाँ हम phpMyAdmin का उपयोग करेंगे:

1. ServBay का phpMyAdmin डेटाबेस टूल खोलें

   अपने ब्राउज़र में https://servbay.host/ खोलें, और वहां से phpMyAdmin के लिंक पर क्लिक करें।

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

   सुरक्षा की दृष्टि से, Contao के लिए एक अलग डेटाबेस यूजर बनाएं।

   a. यूज़र अकाउंट पेज पर जाएँ

   phpMyAdmin की मुख्य स्क्रीन में टॉप मेन्यू से "यूज़र अकाउंट्स" चुनें।
   

   b. नया यूज़र जोड़ें

   "यूज़र अकाउंट जोड़ें" पर क्लिक करें। फिर निम्न जानकारी भरें:
   
   *   **यूज़रनेम:** उदाहरण के लिए `contao_user`।
   *   **होस्टनेम:** `localhost` चुनें, ताकि यूज़र सिर्फ लोकली कनेक्ट कर सके – यह सुरक्षा बढ़ाता है।
   *   **पासवर्ड:** एक मजबूत पासवर्ड डालें (केवल उदाहरण के लिए `password123`, लेकिन प्रैक्टिकल में मजबूत पासवर्ड जेनरेट करें)।
   *   **री-एंटर:** पासवर्ड दोबारा डालें।
   
   "डेटाबेस फॉर यूज़र अकाउंट" सेक्शन में, सामान्यतः "यूज़रनेम के अनुसार नई डेटाबेस बनाएँ और सारे अधिकार दें" चुनें। इससे यूज़रनेम से ही मिलती-जुलती डेटाबेस और सभी परमिशन उसी यूज़र को मिल जाएंगी।
   
   *   "सभी अधिकार दें" जरूर टिक करें।
   *   पेज के नीचे "Go" या "एक्सीक्यूट" पर क्लिक कर प्रक्रिया पूरी करें।
   

चरण 4: ServBay में वेबसाइट सेटअप करें

अब आपको ServBay में एक वेबसाइट कॉन्फ़िगरेट करनी है, जिसमें आप Contao प्रोजेक्ट डायरेक्टरी को पॉइंट करेंगे।

1. ServBay खोलें और नई वेबसाइट जोड़ें

   ServBay ऐप का मुख्य इंटरफेस खोलें। बाएं नेविगेशन बार से "वेबसाइट्स" टैब चुनें और "जोड़ें" बटन पर क्लिक कर नई साइट बनाएँ।

2. वेबसाइट कन्फ़िगरेशन भरेँ

   • नाम: आपकी साइट के लिए कोई पहचानने योग्य नाम दें, जैसे My Contao Site।
   • डोमेन: लोकल डेवेलपमेंट के लिए कोई .local या .servbay.demo डोमेन चुनें, जैसे servbay-contao.local। ServBay इसे ऑटोमैटिकली लोकल से मैप कर देगा।
   • वेबसाइट टाइप: PHP चुनें।
   • PHP वर्शन: Contao के अनुकूल PHP वर्शन चुनें (जाँच लें – Contao ऑफिशियल डाक्यूमेंटेशन देखें)।
   • वेबसाइट रुट डायरेक्टरी: बहुत जरूरी! Composer contao/managed-edition से इंस्टॉल किए गए प्रोजेक्ट्स में पब्लिक फाइलें (index.php आदि) प्रोजेक्ट के web डायरेक्टरी में होती हैं। यहां web की पूर्ण पथ दें: /Applications/ServBay/www/servbay-contao-app/web

3. कन्फ़िगरेशन सेव करें

   सभी जानकारी भरने के बाद, ServBay इंटरफेस के नीचे "सेव" बटन दबाएँ। ServBay नई वेबसाइट कन्फिगरेशन पर काम शुरू कर देगा।

चरण 5: Contao वेब इंस्टॉलेशन विजार्ड चलाएँ

साइट कॉन्फ़िगरेशन के बाद आप अपने ब्राउज़र से Contao का इंस्टॉलेशन विजार्ड शुरू कर सकते हैं।

1. इंस्टॉलेशन पेज एक्सेस करें

   अपने ब्राउज़र में वह डोमेन खोलें, जो आपने ServBay में सेट किया है, और उसके बाद /contao/install जोड़ें। उदाहरण: https://servbay-contao.local/contao/install

   यदि सबकुछ सही है, तो आपको Contao इंस्टॉलेशन पेज दिखेगा।

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

   इंस्टॉलेशन विजार्ड आपसे डेटाबेस कनेक्शन के डिटेल पूछेगा। चरण 3 में जो क्रेडेंशियल्स बनाए थे, वे भरें:

   • डेटाबेस होस्ट: localhost
   • डेटाबेस नेम: contao_user (अगर phpMyAdmin में यूज़रनेम जैसा ही नाम दिया था)
   • यूज़रनेम: contao_user
   • पासवर्ड: स्टेप 3 में सेट किया गया पासवर्ड

3. एडमिनिस्ट्रेटर जानकारी

   आगे के पेज पर Contao के बैकएंड एडमिन का यूज़रनेम, पासवर्ड, ईमेल ईत्यादि सेट करें। एक मजबूत पासवर्ड रखें।

4. इंस्टॉलेशन पूरा करें

   इंस्टॉलेशन प्रोसेस के बाकी निर्देशों का पालन करें, साधारणतः डेटाबेस टेबल के सेटअप के साथ। "इंस्टॉल" या "फिनिश" जैसे बटन दबाकर प्रक्रिया पूरी करें।

चरण 6: इंस्टॉलेशन की पुष्टि और बैकएंड लॉगिन करें

इंस्टॉलेशन के बाद आप देख सकते हैं कि Contao सही से चल रहा है और बैकएंड में लॉगिन कर सकते हैं।

1. फ्रंटएंड वेबसाइट देखें

   ब्राउज़र में अपनी लोकल डोमेन खोलें जैसे https://servbay-contao.local/। या तो Contao की वेलकम स्क्रीन या डिफ़ॉल्ट होमपेज दिखेगा (यह डिफॉल्ट सेटिंग के अनुसार निर्भर करता है)। इसका मतलब साइट कॉन्फ़िग्रेशन सही है।

2. Contao एडमिन बैकएंड खोलें

   एडमिन लॉगिन आमतौर पर https://servbay-contao.local/contao पर मिलेगा।

   जो एडमिन क्रेडेंशियल्स आपने स्टेप 5 में दिए थे, वे डालिए और लॉगिन करें। सफलतापूर्वक लॉगिन पर आप Contao के एडमिन पैनल में कंटेंट, एक्सटेंशन इंस्टॉल तथा वेबसाइट सेटअप कर सकते हैं।

सामान्य समस्याएँ (FAQ)

प्रश्न: https://servbay-contao.local/ या https://servbay-contao.local/contao/install खोलने में एरर आ रहा है, क्या करें?

उत्तर:

• ServBay चालू है? – चेक करें कि ServBay, PHP और वेब सर्वर (Caddy या Nginx) चालू हैं।
• ServBay साइट की कन्फ़िगरेशन चेक करें: दुबारा देखें कि साइट के डोमेन, वेबसाइट टाइप, PHP वर्शन और वेबसाइट रुट डायरेक्टरी सही हैं (Contao के लिए यह प्रोजेक्ट के web सबफ़ोल्डर में होनी चाहिए)।
• डोमेन रिज़ॉल्विंग: ServBay .local डोमेन की मैपिंग ऑटो करता है। अगर दूसरा डोमेन या कोई समस्या, तो ServBay या पूरे सिस्टम को रिस्टार्ट करें, या hosts फाइल चेक करें (आमतौर पर जरूरत नहीं)।
• वेब सर्वर लॉग्स देखें: Caddy या Nginx लॉग्स में विस्तृत एरर डिटेल देखने के लिए ServBay इंटरफेस चेक करें।

प्रश्न: डेटाबेस कनेक्शन फेल हो गया, क्या करें?

उत्तर:

• डेटाबेस सर्विस: MySQL/MariaDB या PostgreSQL सर्विस का ServBay में चालू होना चेक करें।
• क्रेडेंशियल्स: Contao इंस्टॉलेशन के दौरान डाले गए होस्ट, डेटाबेस नेम, यूज़रनेम और पासवर्ड बिलकुल सही से भरे हैं, यह जांचें।
• युज़र परमिशन: जिस डेटाबेस यूज़र को बनाया है, उसको सभी अधिकार मिले या नहीं – चेक करें।

प्रश्न: इंस्टॉलेशन के दौरान फाइल परमिशन की त्रुटि?

उत्तर: इंस्टॉलेशन के लिए Contao को कुछ डायरेक्टोरीज पर लिखने की अनुमति चाहिए। सामान्यतः ServBay में सब सही रहता है, लेकिन यदि समस्या हो, तो टर्मिनल में नीचे दिए गए कमांड चला सकते हैं:

cd /Applications/ServBay/www/servbay-contao-app
sudo chown -R your_username:staff . # your_username को अपने macOS यूजरनेम से बदलें
sudo chmod -R 755 .
sudo chmod -R 777 var/ cache/ system/config/ # Contao को इन फोल्डर में लिखने की ज़रूरत हो सकती है

chmod 777 का इस्तेमाल संभलकर करें – प्रोडक्शन में यह असुरक्षित होता है, लेकिन लोकल डेवलेपमेंट में अस्थायी तौर पर स्वीकार्य है।

संक्षिप्त पुनरावलोकन

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

Contao के और उपयोग और फीचर्स के बारे में विस्तार से जानने के लिए, Contao आधिकारिक डाक्यूमेंटेशन देखें।