PHP istemci kitaplığı, Google Ads API ile etkileşimleri 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.
Kullanılmayan Google Ads API 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 bellek ayak izini 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ünü (v21) kullanan istemci kitaplığını uyguladığınızı ve kullanılmayan API sürümleri (v20 ve v19) 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 v19 and v20 of the Google Ads API.
echo "# Removing support..."
composer run-script remove-google-ads-api-version-support -- 19 20
# 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 V21 olduğunu gösterir:
# Supported Google Ads API versions:
V19
V20
V21
# Vendor folder size:
110M ./vendor
# Removing support...
> Google\Ads\GoogleAds\Util\ApiVersionSupport::remove
Removing support for the version 19 of Google Ads API...
Done
Removing support for the version 20 of Google Ads API...
Done
# Supported Google Ads API versions:
V21
# 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üresinde 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 ön plana çıktığı ü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 sık kullanılan çö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 özel seçenekleri (ör. --optimize-autoloader veya --classmap-authoritative) 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 kaydı 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, OPcache önceden yükleme, normal önbelleğe almanın bir adım ötesine geçerek komut dosyalarını belleğe önceden yüklemek için 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ığı ve bellek kullanımı ile performans artışı arasındaki denge belirli bir proje ve yürütmeye özgü olduğu için bu özelliği desteklemez.