ServBay में थर्ड-पार्टी PHP एक्सटेंशन कैसे लोड करें

ServBay एक शक्तिशाली लोकल वेब डेवेलपमेंट पर्यावरण है जो कई सामान्य PHP एक्सटेंशन पहले से उपलब्ध करवाता है। आमतौर पर, उपयोगकर्ता ServBay के Packages (सॉफ़्टवेयर पैकेज) -> Languages (भाषाएँ) -> PHP Version (PHP संस्करण) -> Extensions (एक्सटेंशन) के भीतर एक्सटेंशन को कॉन्फ़िगर व सक्षम कर सकते हैं।

हालाँकि, कभी-कभी डेवेलपर्स को ऐसे थर्ड-पार्टी या खुद से कंपाइल किए गए PHP एक्सटेंशन की आवश्यकता होती है, जो ServBay में डिफ़ॉल्ट रूप में शामिल नहीं होते। यह लेख आपको बताता है कि विशेष PHP वर्शन के लिए ऐसे एक्सटेंशन ServBay में कैसे लोड करें, उदाहरण के लिए ionCube Loader के माध्यम से। यही प्रक्रिया अन्य Zend एक्सटेंशन या स्वयं द्वारा कंपाइल किए गए .so एक्सटेंशन फाइलों पर भी लागू होती है।

Zend एक्सटेंशन के लिए विशेष नोट: ionCube Loader एक Zend एक्सटेंशन है, जो PHP के Zend इंजन के साथ गहराई से इंटरैक्ट करता है। ऐसे एक्सटेंशन को सेटअप करते समय आपको zend_extension निर्देश का उपयोग करना चाहिए, न कि सामान्य एक्सटेंशन के लिए प्रयुक्त extension का। कृपया इसे सही से अलग व लागू करें।

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

• आपके सिस्टम पर macOS में ServBay इंस्टॉल और रन हो रहा है।
• आपके पास एडमिनिस्ट्रेटर एक्सेस है और सिस्टम फाइल्स व ServBay सेटिंग्स तक पहुँच है।
• आप macOS के Terminal ऐप का उपयोग करना जानते हैं।
• आपके पास लोड किए जाने वाले थर्ड-पार्टी PHP एक्सटेंशन की फाइल (आमतौर पर .so फाइल) उपलब्ध है, और यह फाइल ServBay में आवश्यक PHP वर्शन, आर्किटेक्चर (Intel या Apple Silicon), एवं कंपाइल ऑप्शन (जैसे NTS/ZTS) से पूरी तरह मेल खाती है।

ध्यान दें: आर्किटेक्चर कम्पैटिबिलिटी अति आवश्यक

ServBay Intel (x86_64) और Apple Silicon (ARM64, जैसे M1/M2/M3/M4 चिप) दोनों के लिए नेटिव आर्किटेक्चर PHP पैकेज प्रदान करता है। जब आप .so एक्सटेंशन फाइल लोड करें, तो बेहद जरूरी है कि जिस PHP पैकेज में जोड़ना चाहते हैं उसकी आर्किटेक्चर से .so फाइल की आर्किटेक्चर पूरी तरह मेल खाए।

अलग-अलग आर्किटेक्चर की फाइलें आपस में नहीं मिलाई जा सकती, असंगति के कारण PHP स्टार्ट नहीं होगा या क्रैश कर सकता है।

आप file कमांड का उपयोग करके किसी exe फाइल या .so फाइल की आर्किटेक्चर को जान सकते हैं:

1. ServBay में दिए PHP पैकेज की आर्किटेक्चर जानें (अपना PHP वर्शन 8.3 से बदलें):

   file /Applications/ServBay/package/php/8.3/current/bin/php

   संभावित आउटपुट:

   /Applications/ServBay/package/php/8.3/current/bin/php: Mach-O 64-bit executable arm64 # Apple Silicon ARM64 दर्शाता है

   या

   /Applications/ServBay/package/php/8.3/current/bin/php: Mach-O 64-bit executable x86_64 # Intel x86_64 दर्शाता है

2. डाउनलोड/कंपाइल की गई एक्सटेंशन फाइल की आर्किटेक्चर जानें (xdebug.so को अपने एक्सटेंशन नाम से बदलें):

   file xdebug.so

   संभावित आउटपुट:

   xdebug.so: Mach-O 64-bit bundle arm64 # Apple Silicon ARM64 दर्शाता है

   या

   xdebug.so: Mach-O 64-bit bundle x86_64 # Intel x86_64 दर्शाता है

   दोनों स्टेप (1 और 2) में आर्किटेक्चर की जानकारी पूरी तरह मेल खाना जरूरी है।

स्टेप-बाय-स्टेप प्रोसेस

स्टेप 1: थर्ड-पार्टी एक्सटेंशन फाइल डाउनलोड करें (यहाँ उदाहरण के लिए ionCube Loader)

1. ionCube Loader के ऑफिसियल डाउनलोड पेज पर जाएँ। अपनी macOS आर्किटेक्चर के अनुरूप सही वर्शन चुनें। macOS ARM64 (Apple Silicon M सीरीज) के लिए Darwin ARM64 वर्शन डाउनलोड करें। (नवीनतम वर्शन ऑफिसियल साइट पर देखना न भूलें, नीचे लिंक केवल उदाहरण के लिए है):
   https://downloads.ioncube.com/loader_downloads/ioncube_loaders_dar_arm64.tar.gz
2. डाउनलोड के बाद आपको .tar.gz नामक फाइल मिलेगी, उदाहरण के लिए ioncube_loaders_dar_arm64.tar.gz।

स्टेप 2: टार्गेट PHP वर्शन एवं ServBay में एक्सटेंशन डाइरेक्ट्री का पता लगाएँ

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

2. बाईं साइड नेविगेशन में Packages (सॉफ़्टवेयर पैकेज) से Languages (भाषाएँ) पर क्लिक करें।

3. दाईं लिस्ट में उस PHP वर्शन को ढूँढें, जिसमें आप ionCube Loader जोड़ना चाहते हैं (उदाहरण: PHP 8.3)। इस वर्शन नंबर को नोट कर लें।

4. ServBay में उक्त PHP वर्शन के एक्सटेंशन इंस्टॉलेशन डाइरेक्ट्री (extension_dir) का पता लगाएँ। आम तौर पर, यह वह फोल्डर है जहाँ .so फाइलें रखी जाती हैं। यह पथ ServBay की इंस्टॉलेशन लोकेशन, PHP वर्शन और कंपाइल ऑप्शन पर निर्भर करता है।

   सबसे अच्छा तरीका है टर्मिनल कमांड का इस्तेमाल करें:

   Terminal खोलें और यह कमांड चलाएँ (/Applications/ServBay/package/php/8.3/current/bin/php को अपने PHP वर्शन के सही पथ से बदलें):

   /Applications/ServBay/package/php/8.3/current/bin/php -i | grep extension_dir

   आउटपुट सामान्यतः ऐसा दिखेगा:

   extension_dir => /Applications/ServBay/package/php/8.3/8.3.16/lib/php/extensions/no-debug-non-zts-20230831

   इस पथ को कहीं लिख लें, आगे की स्टेप्स में इसकी आवश्यकता होगी।

स्टेप 3: Loader फाइल को अनज़िप कर स्थानांतरित करें

1. Terminal खोलें।

2. cd कमांड से डाउनलोड किए गये .tar.gz फाइल की डाइरेक्ट्री में जाएँ (आम तौर पर ~/Downloads):

   cd ~/Downloads

3. डाउनलोड की फाइल को अनज़िप करें:

   tar -zxvf ioncube_loaders_dar_arm64.tar.gz

   यह कमांड उसी डायरेक्ट्री में ioncube नाम का एक फोल्डर बनाएगी।

4. ioncube फोल्डर में जाएँ:

   cd ioncube

5. यहाँ आपको अलग-अलग PHP वर्शन के लिए .so फाइल मिलेंगी, जैसे ioncube_loader_dar_8.3.so। उस वर्शन से मेल खाती फाइल चुनें जिसे आपने स्टेप 2 में निर्धारित किया था।

6. चुनी हुई .so फाइल को PHP एक्सटेंशन डायरेक्ट्री (extension_dir) में कॉपी करें। उदाहरण (अगर टार्गेट डायरेक्ट्री /Applications/ServBay/package/php/8.3/8.3.16/lib/php/extensions/no-debug-non-zts-20230831/ है और PHP 8.3 इंस्टॉल करना है):

   cp ioncube_loader_dar_8.3.so /Applications/ServBay/package/php/8.3/8.3.16/lib/php/extensions/no-debug-non-zts-20230831/

   • यहाँ टार्गेट पथ /Applications/ServBay/.../no-debug-non-zts-20230831/ को उस पथ से बदलें जो आपने स्टेप 2 में php -i के जरिये पाया।
   • चेक करें कि आपने सही PHP वर्शन और आर्किटेक्चर की .so फाइल ही कॉपी की है (पूर्वशर्त में बताई गई आर्किटेक्चर जांच दोहराएँ)।

स्टेप 4: ServBay में PHP सेटिंग करें

1. ServBay इंटरफ़ेस में वापस जाएँ।

2. बाईं ओर Languages (भाषाएँ) चुनें, फिर दाईं लिस्ट से अपना PHP वर्शन (जैसे PHP 8.3) चुनें।

3. दाईं ओर खुलने वाली सेटिंग में PHP टैब चुनें।

4. नीचे स्क्रॉल करें, Additional Parameters (अतिरिक्त पैरामीटर) टेक्स्ट बॉक्स खोजें।

5. उसमें नीचे दी गई लाइन जोड़ें, एक्सटेंशन फाइल का नाम दें:

   zend_extension = ioncube_loader_dar_8.3.so

   • महत्वपूर्ण: ioncube_loader_dar_8.3.so को सही फाइल नाम से बदलें जिसे आपने एक्सटेंशन डाइरेक्ट्री में कॉपी किया।
   • चूँकि यह Zend एक्सटेंशन है, हमेशा zend_extension ही लिखें, न कि extension।
   • यदि आपने फाइल extension_dir में रखी है, तो सिर्फ फाइल नाम लिखना पर्याप्त है; फुल पाथ की आवश्यकता नहीं।
   • अगर पहले से पैरामीटर मौजूद हैं, तो नई लाइन में यह जोड़ें।

   (स्क्रीनशॉट सिर्फ उदाहरण है; वास्तविक इंटरफ़ेस वर्शन के अनुसार थोड़ा अलग हो सकता है)

6. दाएँ नीचे दिए Save बटन पर क्लिक कर सेटिंग सेव करें।

स्टेप 5: PHP सर्विस पुनः आरंभ करें

ServBay में Save पर क्लिक करने के बाद, ServBay कॉन्फ़िगरेशन में बदलाव पहचान लेता है और संबंधित सेवाओं (PHP समेत) को ऑटोमैटिक स्मूद रीस्टार्ट करता है। आमतौर पर आपको मैन्युअल रूप से कुछ और नहीं करना पड़ता।

स्टेप 6: लोडिंग सत्यापित करें

ionCube Loader के सफलतापूर्वक लोड होने की दो आम विधियाँ हैं:

1. कमांड लाइन से सत्यापन:

   • टर्मिनल खोलें।

   • यह कमांड चलाएँ (और अपने PHP वर्शन की फुल पाथ डालें):

     /Applications/ServBay/package/php/8.3/current/bin/php -m | grep -i ioncube

     यदि इंस्टॉल सफल रहा, तो आउटपुट में ionCube Loader दिखेगा।

   • आप php -v भी चला सकते हैं, जिसमें अगर Loader लोड हो गया, तो वर्शन डिटेल में show होगा:

     /Applications/ServBay/package/php/8.3/current/bin/php -v

     सफलतापूर्वक लोड का आउटपुट उदाहरण (वर्शन आपके सिस्टम पर अलग हो सकता है):

     PHP 8.3.16 (cli) (built: Jan 31 2025 15:09:39) (NTS)
     Copyright (c) The PHP Group
     Zend Engine v4.3.16, Copyright (c) Zend Technologies
         with the ionCube PHP Loader v14.4.0, Copyright (c) 2002-2024, by ionCube Ltd.

     यहाँ with the ionCube PHP Loader ... वाली लाइन देखें।

2. phpinfo() फंक्शन द्वारा सत्यापन:

   • वेबसाइट रूट (जैसे /Applications/ServBay/www/servbay.demo/ या आपकी सेटिंग्स के अनुसार) में एक नया PHP फाइल बनाएं - उदाहरण के लिए info.php।
   • उसमें केवल यह कंटेंट डालें:

     <?php
     phpinfo();
     ?>

   • ब्राउज़र से उस फाइल को ओपन करें (जैसे http://servbay.demo/info.php, अपनी लोकल वेबसाइट का डोमेन डालें)।
   • खुले हुए पेज में "ionCube" सर्च करें (Cmd + F या Ctrl + F)। यदि लोड हुआ है, तो पेज में ionCube Loader सम्बंधित सेक्शन व विवरण दिखाई देगा।

यदि ऊपर दोनों तरीकों में से कोई भी Loader की जानकारी दिखाए, तो एक्सटेंशन सफलतापूर्वक लोड हो गया है।

सामान्य समस्याएँ व समाधान

• PHP स्टार्ट नहीं होता या क्रैश हो जाता है: ज्यादातर कारण एक्सटेंशन फाइल की आर्किटेक्चर और PHP पैकेज की आर्किटेक्चर का मेल न होना है। पूर्वशर्त में दिए स्टेप्स फिर से ध्यान से जांचें। PHP वर्शन या कंपाइल ऑप्शन की असंगति भी परेशानियाँ दे सकती हैं।
• extension_dir पथ त्रुटि: सुनिश्चित करें कि .so फाइल उसी PHP वर्शन के ServBay के वास्तविक extension_dir में रखी गई है। php -i | grep extension_dir द्वारा पाया गया पथ ही सही है।
• कॉनफिगरेशन निर्देश की गलती: ServBay के Additional Parameters में लिखा गया निर्देश सही है या नहीं देखें। Zend एक्सटेंशन के लिए zend_extension = filename.so ही हों; सामान्य के लिए extension = filename.so। फाइल नाम संवेदनशील (case-sensitive) है।
• फाइल परमिशन समस्या: सुनिश्चित करें कि ServBay रन कर रहे macOS यूजर के पास उस .so फाइल और उसकी डायरेक्ट्री को पढ़ने की परमिशन है। आम तौर पर ServBay के पैकेज डायरेक्ट्री में कॉपी से ऐसी कोई समस्या नहीं आती, पर यदि मैन्युअली परमिशन बदली हैं तो पुनः जाँचें।
• ServBay पुनः प्रारंभ नहीं हुआ: सर्वत्र अपने आप रीस्टार्ट हो जाता है, फिर भी यदि सेटिंग लागू नहीं हो तो सर्विस को खुद सेवबाय इंटरफेस से स्टॉप-स्टार्ट करें या ऐप को रीस्टार्ट दें।
• phpinfo() में Loader विवरण नहीं: चेक करें कि जिस PHP वर्शन व साइट के लिए एक्सटेंशन सेटअप किया, उसी environment में phpinfo() चला रहे। यदि मल्टीपल वर्शन/साइट्स हैं, तो ठीक से पुष्टि करें।

निष्कर्ष

इन विस्तृत स्टेप्स का पालन करके, आप निश्चित ही ServBay में मैनेज्ड PHP वर्शन के लिए ionCube Loader या अन्य थर्ड-पार्टी .so फॉर्मेट PHP एक्सटेंशन सफलतापूर्वक लोड कर सकते हैं। सबसे जरूरी है—टार्गेट PHP वर्शन की सही पहचान, एक्सटेंशन डाइरेक्ट्री (extension_dir) की जानकारी, संगत एक्सटेंशन फाइल को वहां रखना और ServBay के Additional Parameters में उचित कॉन्फ़िगरेशन (zend_extension या extension) देना। यदि कोई दिक्कत आए, तो ट्रबलशूटिंग सेक्शन के हर स्टेप पर विशेष ध्यान दें, विशेषकर आर्किटेक्चर कम्पैटिबिलिटी और पथ संबंधी चूकों पर।