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

   נקודת מפתח: בדרך כלל, גרסת ה-protobuf שספריית ה-PHP הזו מסתמכת עליה מצוינה באופן טרנזיטיבי ב-composer.json של google/gax, שהיא אחת מהתלות הבסיסיות. עם זאת, מסיבות של ביצועים או תאימות, יכול להיות שנציין את גרסת ה-protobuf ישירות ב-composer.json של ספריית ה-PHP.

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

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

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