יש שתי הטמעות שזמינות ל-PHP:
- C: משתמש בתוסף ה-PHP של Protobuf שנותן ביצועים טובים יותר.
- PHP: משתמש בחבילת ה-PHP של
google/protobuf
שקל יותר להטמיע.
מומלץ להשתמש בהטמעת C אם אפשר, אבל יכול להיות שיהיה צורך ב-PHP במקרים מסוימים (למשל, כאשר הוא מוגבל על ידי אבטחה או אילוצים טכניים).
הטמעת ה-PHP מותקנת אוטומטית כמו כל יחסי תלות אחרים של googleapis/gax-php
ב-Composer, אבל משתמשים בה בזמן ריצה רק אם הטמעת C לא מותקנת ומוגדרת.
הטמעת C
כדי להתקין ולהגדיר את התוסף Protobuf PHP:
- מריצים את הפקודה
sudo pecl install protobuf
משורת הפקודה. - מוסיפים את השורה
extension=protobuf.so
לקובץphp.ini
.
הטמעת PHP
מוודאים שהטמעת C מושבתת ושכל יחסי התלות של ספריית googleapis/gax-php
מותקנות:
- מוסיפים הערה על כל שורה של
extension=protobuf.so
ב-php.ini
. מריצים את הפקודה
composer install
מהספרייה שמכילה את הקובץcomposer.json
של הפרויקט שעליו עובדים. השדהcomposer.json
צריך לציין את הערךgoogle-ads-php
או כל פרויקט שדורש את התלות הזאת.
בודקים באיזו הטמעה נעשה שימוש
מריצים את php -i | grep protobuf
:
- אם השדה לא ריק, אתם משתמשים בהטמעה של C.
- אחרת, אתם לא משתמשים בהטמעת C, וספריית ה-PHP של Google Ads API תסתמך על הטמעת ה-PHP (אם היא הותקנה נכון באמצעות Composer).