प्रोटोबफ़ को लागू करना

PHP के लिए, दो Protobuf इंप्लिमेंटेशन उपलब्ध हैं:

1. C: यह Protobuf PHP C एक्सटेंशन का इस्तेमाल करता है. इससे रनटाइम की परफ़ॉर्मेंस काफ़ी बेहतर होती है.
2. PHP: यह google/protobuf PHP पैकेज का इस्तेमाल करता है. इसके लिए, सिस्टम के किसी अन्य एक्सटेंशन की ज़रूरत नहीं होती.

जब भी संभव हो, C इंप्लिमेंटेशन का इस्तेमाल करें. हालांकि, जब सुरक्षा या एनवायरमेंट से जुड़ी पाबंदियों की वजह से C एक्सटेंशन इंस्टॉल नहीं किए जा सकते, तब प्योर PHP इंप्लिमेंटेशन का इस्तेमाल किया जा सकता है.

PHP इंप्लिमेंटेशन, Composer में googleapis/gax-php की डिपेंडेंसी के तौर पर अपने-आप इंस्टॉल हो जाता है. साथ ही, इसका इस्तेमाल रनटाइम के दौरान सिर्फ़ तब किया जाता है, जब C इंप्लिमेंटेशन इंस्टॉल और चालू न हो.

C प्रोग्रामिंग लैंग्वेज में लागू करना

Protobuf PHP C एक्सटेंशन को इंस्टॉल और कॉन्फ़िगर करने के लिए:

1. PECL का इस्तेमाल करके एक्सटेंशन इंस्टॉल करें:

   sudo pecl install protobuf
   

2. अपनी चालू php.ini फ़ाइल में एक्सटेंशन चालू करें. यह सीएलआई और वेब सर्वर एनवायरमेंट, दोनों के लिए ज़रूरी है. जैसे, PHP-FPM या Apache. सीएलआई कॉन्फ़िगरेशन फ़ाइल का पता लगाने के लिए, php --ini चलाएं:

   extension=protobuf.so
   

   ध्यान दें: Windows पर, php.ini के बजाय extension=php_protobuf.dll जोड़ें.

PHP लागू करना

प्योर PHP इंप्लिमेंटेशन का इस्तेमाल करने के लिए, पक्का करें कि C इंप्लिमेंटेशन बंद हो और googleapis/gax-php की सभी डिपेंडेंसी इंस्टॉल हों:

1. अपनी php.ini फ़ाइलों में मौजूद किसी भी extension=protobuf.so (या extension=php_protobuf.dll) लाइन को टिप्पणी के तौर पर मार्क करें या हटाएं.

2. उस डायरेक्ट्री से composer install चलाएं जिसमें आपके प्रोजेक्ट की composer.json फ़ाइल मौजूद है. composer.json फ़ाइल में, googleads/google-ads-php को डिपेंडेंसी के तौर पर शामिल किया जाना चाहिए.

   अहम जानकारी: आम तौर पर, यह PHP लाइब्रेरी जिस Protobuf वर्शन पर निर्भर करती है उसकी जानकारी, google/gax की composer.json फ़ाइल में ट्रांज़िटिव तरीके से दी जाती है. परफ़ॉर्मेंस या साथ काम करने की वजहों से, Protobuf का कम से कम वर्शन, सीधे PHP क्लाइंट लाइब्रेरी के composer.json में भी बताया जा सकता है.

यह पता लगाना कि किस तरीके का इस्तेमाल किया जा रहा है

अपने टर्मिनल में यह कमांड चलाकर देखें कि आपके PHP सीएलआई एनवायरमेंट में C एक्सटेंशन चालू है या नहीं:

php -i | grep protobuf

• अगर आउटपुट खाली नहीं है (उदाहरण के लिए, protobuf support => enabled), तो इसका मतलब है कि C इंप्लिमेंटेशन का इस्तेमाल किया जा रहा है.
• अगर ऐसा नहीं है, तो इसका मतलब है कि C इंप्लिमेंटेशन का इस्तेमाल नहीं किया जा रहा है. ऐसे में, Google Ads API PHP लाइब्रेरी, Composer से इंस्टॉल किए गए प्योर PHP इंप्लिमेंटेशन पर अपने-आप वापस चली जाती है.