הטמעות של Protobuf

אזהרה: החל מהתאריך 31 במרץ 2024, ספריית הלקוח של Google Ads API ל-PHP תפסיק לתמוך בגרסאות PHP שקודמות לגרסה 8.1. כדי להבטיח פעולה חלקה, מומלץ מאוד לשדרג את גרסת ה-PHP לפני התאריך הזה.

יש שתי הטמעות שזמינות ל-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).