Library klien PHP memudahkan interaksi dengan Google Ads API dengan konfigurasi minimal dari pihak Anda. Namun, performa sangat bergantung pada cara library digunakan dan diintegrasikan.
Sebagian besar praktik terbaik ini dapat diterapkan ke semua bahasa. Panduan ini membahas salah satu fungsi yang spesifik untuk PHP.
Penerapan Protobuf
Protobuf digunakan oleh gRPC dan Google Ads API untuk pesan permintaan dan respons. Ada dua implementasi yang tersedia, meskipun yang ditulis dalam C memiliki performa yang lebih baik.
Lihat Panduan Protobuf untuk informasi selengkapnya.
Mode operasi penafsir PHP
PHP adalah pembuatan skrip bahasa dan memiliki banyak operasi yang berbeda bergantung pada penggunaannya. PHP CGI (Common Gateway Interface) memiliki keunggulan yang signifikan karena dapat berbagi resource antar-eksekusi.
Versi PHP
Sebaiknya upgrade ke versi PHP yang lebih baru secara rutin karena biasanya PHP versi tersebut memiliki performa yang lebih baik secara keseluruhan. 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 didedikasikan untuk versi Google Ads API yang tidak digunakan dapat dihapus dengan aman dari library klien. Karena dapat berguna untuk mempercepat eksekusi atau mengurangi jejak memori, library klien menyediakan utilitas untuk melakukannya secara terprogram.
Contoh
Misalkan Anda menerapkan library klien yang hanya menggunakan versi API terbaru: v18, dan Anda ingin menghapus dukungan untuk versi API yang tidak digunakan: v17 dan v16.
Dalam file composer.json project, tentukan skrip Composer (bernama
remove-google-ads-api-version-support) yang memanfaatkan utilitas yang disediakan oleh
library klien, di 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 v16 and v17 of the Google Ads API.
echo "# Removing support..."
composer run-script remove-google-ads-api-version-support -- 16 17
# 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 menunjukkan pengurangan ukuran file sebesar 50 M dan
satu-satunya versi yang tersisa yang didukung adalah V18:
# Supported Google Ads API versions:
V16
V17
V18
# Vendor folder size:
110M ./vendor
# Removing support...
> Google\Ads\GoogleAds\Util\ApiVersionSupport::remove
Removing support for the version 16 of Google Ads API...
Done
Removing support for the version 17 of Google Ads API...
Done
# Supported Google Ads API versions:
V18
# Vendor folder size:
60M ./vendor
Pengembangan versus produksi
PHP adalah bahasa penafsiran di mana LLM terlebih dahulu mengompilasi instruksi sebelum mengeksekusinya. Hal ini biasanya menguntungkan karena selama waktu pengembangan, sumber sering berubah, sedangkan waktu eksekusi tidak terlalu penting. Namun, kebalikannya berlaku pada waktu produksi karena stabilitas dan kinerja menjadi masalah utama.
Cache
Menyimpan data ke cache adalah hal yang umum dan sangat direkomendasikan karena 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 umum dilakukan karena dapat meningkatkan performa sekaligus stabilitas dengan memuat informasi yang telah dikompilasi sebelumnya tentang class.
Library klien PHP sesuai dengan PSR-4 untuk
pemuatan otomatis serta memberikan definisi sebagai bagian dari
composer.json
. Opsi khusus Composer, seperti
--optimize-autoloader atau --classmap-authoritative misalnya, kemudian dapat
digunakan secara langsung.
Logging
Menyetel logger ke tingkat tinggi seperti ERROR dapat membantu mengurangi overhead waktu eksekusi dan konsumsi memori.
Lihat Panduan logging untuk mengetahui informasi selengkapnya.
Proses debug & pembuatan profil
Sebaiknya nonaktifkan alat debugger dan profiler seperti biasanya beberapa {i>overhead<i} waktu eksekusi.
Pramuat
Mulai PHP 7.4, pramuat OPcache dapat digunakan untuk memuat skrip di memori, yang lebih baik daripada cache biasa.
Sebuah skrip harus dirancang untuk memanfaatkan fitur ini, tetapi tidak dilakukan library klien karena tidak ada cara umum untuk mengimplementasikan OPcache pramuat, dan kompromi antara penggunaan memori dan peningkatan kinerja yang sangat spesifik untuk proyek dan pelaksanaan tertentu.