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

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

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

ใช้การติดตั้งใช้งาน 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 และติดตั้งการขึ้นต่อกันทั้งหมดของ 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 โดยอัตโนมัติ