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

هناك نوعان من عمليات تنفيذ Protobuf المتاحة لـ PHP:

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

استخدِم تنفيذ 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 كعنصر تابع.

تحديد طريقة التنفيذ المستخدَمة

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

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