تستخدم Google تكنولوجيا الذكاء الاصطناعي لترجمة المحتوى إلى لغتك المفضّلة، وقد تتضمّن بعض الأخطاء.

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

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

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

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

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

تنفيذ C

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

ثبِّت الإضافة باستخدام PECL:
```
sudo pecl install protobuf
```
فعِّل الإضافة في ملف php.ini النشط (لكل من بيئات واجهة سطر الأوامر وخادم الويب، مثل PHP-FPM أو Apache، وشغِّل php --ini لتحديد موقع ملف إعداد واجهة سطر الأوامر):
```
extension=protobuf.so
```
ملاحظة: على نظام التشغيل Windows، أضِف extension=php_protobuf.dll إلى php.ini بدلاً من ذلك.

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

أشِر إلى أي سطر extension=protobuf.so (أو extension=php_protobuf.dll) باعتباره تعليقًا أو أزِله من ملفات php.ini.
شغِّل composer install من الدليل الذي يحتوي على ملف composer.json لمشروعك. يجب أن يحدّد ملف composer.json googleads/google-ads-php كعنصر تابع.

نقطة أساسية: عادةً ما يتم تحديد إصدار Protobuf الذي تعتمد عليه مكتبة PHP هذه بشكل متعدٍ في ملف composer.json الخاص بـ google/gax. لأسباب تتعلق بالأداء أو التوافق، قد يتم أيضًا تحديد الحد الأدنى لإصدار Protobuf مباشرةً في ملف composer.json الخاص بمكتبة برامج PHP.

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

php -i | grep protobuf

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