יש שתי הטמעות שזמינות ל-PHP:
- C: משתמש בתוסף Protobuf PHP שמניב ביצועים טובים יותר.
- PHP: משתמש ב
google/protobuf
חבילת PHP שקל יותר להטמיע.
מומלץ להשתמש בהטמעה של C אם אפשר, אבל יכול להיות שתצטרכו להשתמש ב-PHP במקרים מסוימים (למשל, אם יש מגבלות אבטחה או מגבלות טכניות).
ההטמעה של PHP מותקנת אוטומטית כמו כל התלויות האחרות של googleapis/gax-php
ב-Composer, אבל היא משמשת בזמן הריצה רק אם ההטמעה של C לא מותקנת ולא מוגדרת.
הטמעה של C
כדי להתקין ולהגדיר את תוסף ה-PHP של Protobuf:
- מריצים את הפקודה
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).