PHP istemci kitaplığı, Google Ads API ile etkileşimi kolaylaştırır ve sizin tarafınızda minimum yapılandırma gerektirir. Ancak performans, kitaplığın nasıl kullanıldığına ve entegre edildiğine büyük ölçüde bağlıdır.
Bu en iyi uygulamaların çoğu tüm diller için geçerlidir. Bu kılavuzda, PHP'ye özel olanlar ele alınmaktadır.
Protobuf uygulaması
Protobuf, istek ve yanıt mesajları için gRPC ve Google Ads API tarafından kullanılır. İki uygulama mevcuttur ancak C ile yazılan uygulama daha iyi performans gösterir.
Daha fazla bilgi için Protobuf kılavuzuna bakın.
PHP yorumlayıcısının çalışma modu
PHP, çok yönlü bir komut dosyası dilidir ve kullanıma bağlı olarak birçok işlem moduna sahiptir. PHP CGI (Common Gateway Interface), yürütmeler arasında kaynak paylaşabildiği için önemli bir avantaja sahiptir.
PHP sürümü
Genellikle daha iyi genel performans sunduğu için düzenli olarak daha yeni bir PHP sürümüne yükseltmek iyi bir uygulamadır. Desteklenen PHP sürümlerinin listesi.
Kullanılmayan Google Ads API sürümleri
İstemci kitaplığının tüm sürümleri, birden fazla Google Ads API sürümünü destekler. İstemci kitaplığı tarafından desteklenen Google Ads API'nin her sürümü için sürüme özel paketler bulunur.
Google Ads API'nin kullanılmayan sürümlerine ayrılmış paketler, istemci kitaplığından güvenli bir şekilde kaldırılabilir. İstemci kitaplığı, yürütmeyi hızlandırmak veya bellekte kaplanan yeri azaltmak için yararlı olabileceğinden bunu programatik olarak yapmaya yönelik yardımcı programlar sağlar.
Örnek
Yalnızca en son API sürümü olan v24'yı kullanan istemci kitaplığını uyguladığınızı ve kullanılmayan API sürümleri olan v23 ile v22 için desteği kaldırmak istediğinizi varsayalım.
Projenin composer.json dosyasında, ApiVersionSupport sınıfında, istemci kitaplığı tarafından sağlanan yardımcı programdan yararlanan bir Composer komut dosyası (remove-google-ads-api-version-support adlı) tanımlayın:
"scripts": {
"remove-google-ads-api-version-support": [
"Google\\Ads\\GoogleAds\\Util\\ApiVersionSupport::remove"
]
}
Ardından, Composer komut dosyasını parametre olarak sürüm numaralarıyla kullanın ve bazı durum mesajlarını yazdırın:
# 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 v22 and v23 of the Google Ads API.
echo "# Removing support..."
composer run-script remove-google-ads-api-version-support -- 22 23
# 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
Aşağıdaki örnek yürütme çıktısı, dosya boyutunda 50 MB'lık bir azalma olduğunu ve desteklenen tek sürümün V24 olduğunu gösteriyor:
# Supported Google Ads API versions:
V22
V23
V24
# Vendor folder size:
110M ./vendor
# Removing support...
> Google\Ads\GoogleAds\Util\ApiVersionSupport::remove
Removing support for the version 22 of Google Ads API...
Done
Removing support for the version 23 of Google Ads API...
Done
# Supported Google Ads API versions:
V24
# Vendor folder size:
60M ./vendor
Geliştirme ve üretim
PHP, talimatları yürütmeden önce derlediği için yorumlanmış bir dildir. Geliştirme sırasında kaynaklar genellikle değiştiği için bu durum genellikle avantajlıdır. Yürütme süresi ise o kadar önemli değildir. Ancak kararlılık ve performansın asıl önemli olduğu üretim zamanında bunun tam tersi geçerlidir.
Önbellek
Önceden derlenmiş komut dosyası talimatlarını depolayarak hem performansı artırdığı hem de kararlılığı yükselttiği için önbelleğe alma yaygın olarak kullanılır ve şiddetle tavsiye edilir.
OPcache en çok tercih edilen çözümdür ve varsayılan olarak kullanılabilir.
Otomatik yükleme
Otomatik yükleme, sınıflarla ilgili önceden derlenmiş bilgileri yükleyerek hem performansı artırdığı hem de kararlılığı yükselttiği için yaygın olarak kullanılır.
PHP istemci kitaplığı, otomatik yükleme için PSR-4'e uygundur ve tanımı composer.json dosyasının bir parçası olarak sağlar. Composer'ın --optimize-autoloader veya --classmap-authoritative gibi özel seçenekleri
hemen kullanılabilir.
Günlük Kaydı
Günlükçüleri ERROR gibi yüksek bir düzeye ayarlamak, yürütme süresi ek yükünü ve bellek tüketimini azaltmaya yardımcı olabilir.
Daha fazla bilgi için Günlük kılavuzuna bakın.
Hata ayıklama ve profil oluşturma
Genellikle bir miktar yürütme süresi ek yükü getirdiklerinden hata ayıklayıcı ve profil oluşturucu araçlarını devre dışı bırakmanızı öneririz.
Önceden Yükle
PHP 7.4'ten itibaren, normal önbelleğe almanın bir adım ötesine geçerek komut dosyalarını belleğe önceden yüklemek için OPcache önceden yükleme özelliği kullanılabilir.
Bu özellikten yararlanmak için bir komut dosyası tasarlanması gerekir ancak PHP istemci kitaplığı, OPcache ön yüklemesini uygulamanın genel bir yolu olmadığından ve bellek kullanımı ile performans artışı arasındaki denge belirli bir proje ve yürütmeye özgü olduğundan bu özelliği desteklemez.