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

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

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

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

استخدِم تطبيق 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.