הטמעות של Protobuf

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

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

מומלץ להשתמש בהטמעה של C אם אפשר, אבל יכול להיות שתצטרכו להשתמש ב-PHP במקרים מסוימים (למשל, אם יש מגבלות אבטחה או מגבלות טכניות).

ההטמעה של PHP מותקנת אוטומטית כמו כל התלויות האחרות של googleapis/gax-php ב-Composer, אבל היא משמשת בזמן הריצה רק אם ההטמעה של C לא מותקנת ולא מוגדרת.

הטמעה של C

כדי להתקין ולהגדיר את תוסף ה-PHP של Protobuf:

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).