Performa

Library klien PHP memudahkan interaksi dengan Google Ads API dengan konfigurasi minimal. Namun, performa sangat bergantung pada cara library digunakan dan terintegrasi.

Sebagian besar praktik terbaik ini berlaku untuk semua bahasa. Panduan ini membahas panduan yang khusus untuk PHP.

Penerapan protobuf

Protobuf digunakan oleh gRPC dan Google Ads API untuk pesan permintaan dan respons. Dua implementasi tersedia, meskipun implementasi yang ditulis di C memiliki performa lebih baik.

Lihat Panduan Protobuf untuk informasi selengkapnya.

Mode operasi penafsir PHP

PHP adalah bahasa skrip serbaguna dan memiliki banyak mode operasi bergantung pada penggunaan. PHP CGI (Common Gateway Interface) memiliki keunggulan penting karena dapat berbagi resource antar-eksekusi.

Versi PHP

Sebaiknya Anda mengupgrade ke versi PHP yang lebih baru secara rutin karena performa biasanya lebih baik. Daftar versi PHP yang didukung.

Versi Google Ads API yang tidak digunakan

Semua versi library klien mendukung beberapa versi Google Ads API. Untuk setiap versi Google Ads API yang didukung oleh library klien, ada paket khusus untuk versi tersebut.

Paket yang dikhususkan untuk versi Google Ads API yang tidak digunakan dapat dihapus dengan aman dari library klien. Karena dapat bermanfaat untuk mempercepat eksekusi atau mengurangi jejak memori, library klien menyediakan utilitas untuk melakukannya secara terprogram.

Contoh

Misalkan Anda mengimplementasikan library klien yang hanya menggunakan versi API terbaru: v11, dan Anda ingin menghapus dukungan untuk versi API yang tidak digunakan: v10 dan v9.

Pada file composer.json project, tentukan skrip Composer (bernama remove-google-ads-api-version-support) yang memanfaatkan utilitas yang disediakan oleh library klien, dalam class ApiVersionSupport:

"scripts": {
  "remove-google-ads-api-version-support": [
    "Google\\Ads\\GoogleAds\\Util\\ApiVersionSupport::remove"
  ]
}

Kemudian, gunakan skrip Composer dengan nomor versi sebagai parameter dan cetak beberapa pesan status:

# Change the current directory to the project directory.
cd /path/to/the/project

# Install the project.
composer install

# Output the vendor folder size and the list of Google Ads API versions that are
# supported before removing support for Google Ads API versions.
echo "# Supported Google Ads API versions:"
find ./vendor/googleads/google-ads-php/src/Google/Ads/GoogleAds/V* -maxdepth 0 | grep -o '..$'
echo "# Vendor folder size:"
du -sh ./vendor

# Use the Composer script to remove the unused versions v9 and v10 of the Google Ads API.
echo "# Removing support..."
composer run-script remove-google-ads-api-version-support -- 9 10

# Output the vendor folder size and the list of Google Ads API versions that are
# supported after removing support for Google Ads API versions.
echo "# Supported Google Ads API versions:"
find ./vendor/googleads/google-ads-php/src/Google/Ads/GoogleAds/V* -maxdepth 0 | grep -o '..$'
echo "# Vendor folder size:"
du -sh ./vendor

Contoh output eksekusi di bawah ini menunjukkan pengurangan ukuran file sebesar 50 juta dan satu-satunya versi yang didukung lainnya adalah V11:

# Supported Google Ads API versions:
V9
V10
V11
# Vendor folder size:
110M    ./vendor
# Removing support...
> Google\Ads\GoogleAds\Util\ApiVersionSupport::remove
Removing support for the version 9 of Google Ads API...
Done
Removing support for the version 10 of Google Ads API...
Done
# Supported Google Ads API versions:
V11
# Vendor folder size:
60M     ./vendor

Pengembangan versus produksi

PHP adalah bahasa yang ditafsirkan karena pertama kali mengompilasi petunjuk sebelum menjalankannya. Hal ini biasanya menguntungkan karena selama waktu pengembangan, sumber sering kali berubah sementara waktu eksekusi tidak terlalu penting. Namun, sebaliknya pada waktu produksi karena stabilitas dan performa menjadi perhatian utama.

Cache

Menyimpan ke cache adalah hal yang umum dan sangat direkomendasikan karena keduanya akan meningkatkan performa dan meningkatkan stabilitas dengan menyimpan petunjuk skrip yang telah dikompilasi sebelumnya.

OPcache adalah solusi yang paling umum digunakan dan tersedia secara default.

Penambahan saldo otomatis

Pemuatan otomatis adalah hal yang umum karena meningkatkan performa dan meningkatkan stabilitas dengan memuat informasi yang telah dikompilasi sebelumnya tentang class.

Library klien PHP sesuai dengan PSR-4 untuk pemuatan otomatis dan memberikan definisi sebagai bagian dari file composer.json. Opsi khusus Composer, seperti misalnya --optimize-autoloader atau --classmap-authoritative, kemudian dapat digunakan secara langsung.

Logging

Menyetel pencatat log ke tingkat tinggi seperti ERROR dapat membantu mengurangi waktu overhead dan penggunaan memori.

Lihat Panduan logging untuk mengetahui informasi selengkapnya.

Proses debug & pembuatan profil

Sebaiknya nonaktifkan alat debugger dan profiler karena biasanya ada beberapa overhead waktu eksekusi.

Pramuat

Sejak PHP 7.4, prapemuatan OPcache dapat digunakan untuk melakukan pramuat skrip dalam memori, selangkah lebih maju dari cache biasa.

Skrip harus dirancang untuk memanfaatkan fitur ini, tetapi library klien PHP tidak melakukannya karena tidak ada cara umum untuk mengimplementasikan pramuat OPcache, dan keseimbangan antara penggunaan memori dan perolehan performa sangat spesifik untuk project dan eksekusi tertentu.