הטמעות של Protobuf

יש שתי הטמעות זמינות ל-PHP:

  1. C: משתמשת בתוסף PHP של Protobuf שמספק ביצועים טובים יותר.
  2. PHP: משתמשים בחבילת PHP‏ google/protobuf, שקל יותר להטמיע.

מומלץ להשתמש בהטמעה של 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 או כל פרויקט שדורש אותו כיחסי תלות.

איך בודקים באיזו הטמעה נעשה שימוש

מריצים את php -i | grep protobuf:

  • אם השדה לא ריק, אתם משתמשים בהטמעה של C.
  • אחרת, לא משתמשים בהטמעה של C, וספריית ה-PHP של Google Ads API תסתמך על ההטמעה של PHP (אם היא הותקנה בצורה נכונה באמצעות Composer).