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

هناك طريقتان لتنفيذ PHP:

1. ‫C: يستخدم امتداد Protobuf PHP الذي يحقّق أداءً أفضل.
2. PHP: يستخدم google/protobuf حزمة PHP التي يسهل تنفيذها.

ننصحك باستخدام لغة C إذا أمكن، ولكن قد تكون PHP مطلوبة في بعض الحالات (مثلاً عندما تكون محدودة بسبب قيود الأمان أو القيود الفنية).

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

تنفيذ C

لتثبيت إضافة Protobuf PHP وضبطها:

1. تشغيل sudo pecl install protobuf من سطر الأوامر
2. أضِف سطر extension=protobuf.so إلى الملف php.ini.

تنفيذ PHP

تأكَّد من إيقاف تنفيذ C ومن تثبيت كل التبعيات ل مكتبة googleapis/gax-php:

1. أضِف تعليقًا على أي سطر extension=protobuf.so في php.ini.

2. شغِّل composer install من الدليل الذي يحتوي على ملف composer.json للمشروع الذي يتم العمل عليه. يجب أن يحدِّد composer.json google-ads-php أو أي مشروع يتطلّب ذلك كأحد الموارد المُستخدَمة.

   ملاحظة مهمة: عادةً ما يتم تحديد إصدار protobuf الذي تعتمد عليه مكتبة PHP بشكل تبادلي في composer.json من google/gax، وهو أحد التبعيات الأساسية. ولكن لأسباب تتعلّق بالأداء أو التوافق، قد نحدّد إصدار protobuf مباشرةً فيملف composer.json الخاص بمكتبة PHP.

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

الإجراء php -i | grep protobuf:

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