การติดตั้งใช้งาน Protobuf

การติดตั้งใช้งาน Protobuf สำหรับ PHP มี 2 แบบ ได้แก่

  1. C: ใช้ส่วนขยาย Protobuf PHP C ซึ่งให้ประสิทธิภาพรันไทม์ที่ดีขึ้นอย่างมาก
  2. PHP: ใช้แพ็กเกจ PHP google/protobuf ซึ่งไม่จำเป็นต้องมีส่วนขยายระบบเพิ่มเติม

ใช้การติดตั้งใช้งาน C หากเป็นไปได้ แม้ว่าจะใช้การติดตั้งใช้งาน PHP แบบล้วนๆ ได้เมื่อข้อจำกัดด้านความปลอดภัยหรือสภาพแวดล้อมทำให้ติดตั้งส่วนขยาย C ไม่ได้

การติดตั้งใช้งาน PHP จะติดตั้งโดยอัตโนมัติเป็นทรัพยากร Dependency ของ googleapis/gax-php ใน Composer และจะใช้ที่รันไทม์ก็ต่อเมื่อไม่ได้ติดตั้งและเปิดใช้การติดตั้งใช้งาน C

การติดตั้งใช้งานใน C

วิธีติดตั้งและกำหนดค่าส่วนขยาย Protobuf PHP C

  1. ติดตั้งส่วนขยายโดยใช้ PECL:

    sudo pecl install protobuf

  2. เปิดใช้ส่วนขยายในไฟล์ php.ini ที่ใช้งานอยู่ (สำหรับทั้งสภาพแวดล้อม CLI และเว็บเซิร์ฟเวอร์ เช่น PHP-FPM หรือ Apache ให้เรียกใช้ php --ini เพื่อค้นหาไฟล์การกำหนดค่า CLI)

    extension=protobuf.so

การติดตั้งใช้งานใน PHP

หากต้องการใช้การติดตั้งใช้งาน PHP แบบล้วนๆ ให้ตรวจสอบว่าได้ปิดใช้การติดตั้งใช้งาน C และติดตั้งทรัพยากร Dependency ทั้งหมดของ googleapis/gax-php แล้ว

  1. ทำเครื่องหมายเป็นความคิดเห็นหรือนำบรรทัด extension=protobuf.so (หรือ extension=php_protobuf.dll) ออกในไฟล์ php.ini

  2. เรียกใช้ composer install จากไดเรกทอรีที่มีไฟล์ composer.json ของโปรเจ็กต์ ไฟล์ composer.json ควรระบุ googleads/google-ads-php เป็นทรัพยากร Dependency

ตรวจสอบว่ามีการใช้การติดตั้งใช้งานใดอยู่

เรียกใช้คำสั่งต่อไปนี้ในเทอร์มินัลเพื่อตรวจสอบว่าส่วนขยาย C เปิดใช้อยู่ในสภาพแวดล้อม PHP CLI หรือไม่

php -i | grep protobuf
  • หากเอาต์พุตไม่ว่างเปล่า (เช่น protobuf support => enabled) แสดงว่าคุณใช้การติดตั้งใช้งาน C
  • ไม่เช่นนั้น คุณจะไม่ได้ใช้การติดตั้งใช้งาน C และไลบรารี PHP ของ Google Ads API จะเปลี่ยนกลับไปใช้การติดตั้งใช้งาน PHP แบบล้วนที่ติดตั้งโดย Composer โดยอัตโนมัติ