Implementasi protobuf

Peringatan: Mulai 31 Maret 2024, library klien Google Ads API untuk PHP tidak lagi mendukung versi PHP di bawah 8.1. Untuk memastikan operasi yang lancar, sebaiknya upgrade versi PHP Anda sebelum tanggal ini.

Ada dua implementasi yang tersedia untuk PHP:

1. C: Menggunakan ekstensi PHP Protobuf yang memberikan performa yang lebih baik.
2. PHP: Menggunakan paket google/protobuf PHP yang lebih mudah diimplementasikan.

Sebaiknya gunakan implementasi C jika memungkinkan, tetapi PHP mungkin diperlukan dalam beberapa kasus (misalnya saat dibatasi oleh batasan keamanan atau teknis).

Implementasi PHP otomatis diinstal seperti dependensi googleapis/gax-php lainnya di Composer, tetapi digunakan pada runtime hanya jika implementasi C tidak diinstal dan dikonfigurasi.

Implementasi C

Untuk menginstal dan mengonfigurasi ekstensi Protobuf PHP:

1. Jalankan sudo pecl install protobuf dari command line.
2. Tambahkan baris extension=protobuf.so ke file php.ini.

Implementasi PHP

Pastikan implementasi C dinonaktifkan dan semua dependensi library googleapis/gax-php diinstal:

1. Jadikan baris extension=protobuf.so sebagai komentar di php.ini.

2. Jalankan composer install dari direktori yang berisi file composer.json project yang sedang dikerjakan. composer.json harus menentukan google-ads-php atau project apa pun yang memerlukannya sebagai dependensi.

   Poin Penting: Biasanya, versi protobuf yang diandalkan library PHP ini ditentukan secara transitif dalam composer.json dari google/gax, yang merupakan salah satu dependensi inti. Namun, karena alasan performa atau kompatibilitas, kami mungkin menentukan versi protobuf langsung di library PHP composer.json.

Menentukan implementasi yang sedang digunakan

Jalankan php -i | grep protobuf:

• Jika tidak kosong, berarti Anda menggunakan implementasi C.
• Jika tidak, Anda tidak menggunakan implementasi C dan library PHP Google Ads API akan mengandalkan implementasi PHP (jika diinstal dengan benar menggunakan Composer).