عمليات تنفيذ Protobuf

يتوفّر إصداران من Protobuf للغة PHP:

1. C: تستخدم إضافة Protobuf PHP C التي توفّر أداءً أفضل بكثير في وقت التشغيل.
2. PHP: تستخدم حزمة google/protobuf PHP، التي لا تتطلّب أي إضافات أخرى للنظام.

استخدِم تطبيق C عندما يكون ذلك ممكنًا، على الرغم من أنّه يمكن استخدام تطبيق PHP النقي عندما تمنع قيود الأمان أو البيئة تثبيت إضافات C.

يتم تثبيت تنفيذ PHP تلقائيًا كاعتمادية لـ googleapis/gax-php في Composer، ويتم استخدامه في وقت التشغيل فقط إذا لم يتم تثبيت تنفيذ C وتفعيله.

تنفيذ C

لتثبيت إضافة Protobuf PHP C وضبطها، اتّبِع الخطوات التالية:

1. ثبِّت الإضافة باستخدام PECL:

   sudo pecl install protobuf
   

2. فعِّل الإضافة في ملف php.ini النشط (لكل من بيئات واجهة سطر الأوامر وخادم الويب، مثل PHP-FPM أو Apache، شغِّل php --ini لتحديد موقع ملف إعداد واجهة سطر الأوامر):

   extension=protobuf.so
   

تنفيذ PHP

لاستخدام تنفيذ PHP فقط، تأكَّد من إيقاف تنفيذ C وتثبيت جميع التبعيات الخاصة بـ googleapis/gax-php:

1. علِّق على أي سطر extension=protobuf.so (أو extension=php_protobuf.dll) في ملفات php.ini أو أزِله.

2. نفِّذ الأمر composer install من الدليل الذي يحتوي على ملف composer.json الخاص بمشروعك. يجب أن يحدّد ملف composer.json googleads/google-ads-php كعنصر تابع.

   لمكتبة برامج PHP.

تحديد عملية التنفيذ المستخدَمة

نفِّذ الأمر التالي في الوحدة الطرفية للتحقّق مما إذا كانت إضافة C مفعَّلة في بيئة PHP CLI:

php -i | grep protobuf

• إذا كانت النتيجة غير فارغة (على سبيل المثال، protobuf support => enabled)، يعني ذلك أنّك تستخدم عملية التنفيذ بلغة C.
• في ما عدا ذلك، يعني هذا أنّك لا تستخدم عملية التنفيذ بلغة C، وأنّ مكتبة PHP الخاصة بواجهة برمجة التطبيقات Google Ads API ستعود تلقائيًا إلى عملية التنفيذ بلغة PHP البحتة التي تم تثبيتها بواسطة Composer.