La libreria client PHP semplifica le interazioni con l'API Google Ads con una configurazione minima da parte tua. Tuttavia, le prestazioni dipendono in larga misura da come viene utilizzata e integrata la libreria.
La maggior parte di queste best practice è applicabile a tutte le lingue. Questa guida illustra quelli specifici per PHP.
Implementazione di Protobuf
Protobuf viene utilizzato da gRPC e dall'API Google Ads per i messaggi di richiesta e risposta. Sono disponibili due implementazioni, anche se quella scritta in C offre prestazioni migliori.
Per saperne di più, consulta la guida a Protobuf.
Modalità di funzionamento dell'interprete PHP
PHP è un linguaggio di scripting versatile e ha molte modalità di funzionamento a seconda dell'utilizzo. PHP CGI (Common Gateway Interface) presenta un vantaggio notevole perché può condividere le risorse tra le esecuzioni.
Versione PHP
È buona prassi eseguire regolarmente l'upgrade a una versione di PHP più recente, in quanto in genere offre prestazioni complessive migliori. Elenco delle versioni di PHP supportate.
Versioni dell'API Google Ads inutilizzate
Tutte le versioni della libreria client supportano più versioni dell'API Google Ads. Per ogni versione dell'API Google Ads supportata dalla libreria client, esistono pacchetti dedicati alla versione.
I pacchetti dedicati alle versioni dell'API Google Ads che non vengono utilizzate possono essere rimossi in sicurezza dalla libreria client. Poiché può essere utile per velocizzare l'esecuzione o ridurre l'utilizzo della memoria, la libreria client fornisce utilità per eseguire questa operazione a livello di programmazione.
Esempio
Supponiamo che tu stia implementando la libreria client che utilizza solo l'ultima
versione dell'API: v21 e che tu voglia rimuovere il supporto per le versioni dell'API
non utilizzate: v20 e
v19.
Nel file composer.json del progetto, definisci uno script Composer (denominato
remove-google-ads-api-version-support) che sfrutta l'utilità fornita dalla
libreria client nella classe
ApiVersionSupport:
"scripts": {
"remove-google-ads-api-version-support": [
"Google\\Ads\\GoogleAds\\Util\\ApiVersionSupport::remove"
]
}
Quindi, utilizza lo script Composer con i numeri di versione come parametri e stampa alcuni messaggi di stato:
# 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
L'output di esecuzione di esempio riportato di seguito indica una riduzione delle dimensioni del file di 50 MB e
l'unica versione supportata rimanente è V21:
# 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
Sviluppo e produzione
PHP è un linguaggio interpretato in quanto compila prima le istruzioni prima di eseguirle. Di solito questo è vantaggioso perché durante lo sviluppo le origini cambiano spesso, mentre il tempo di esecuzione non è così cruciale. Tuttavia, il contrario è vero al momento della produzione, in quanto stabilità e prestazioni diventano le preoccupazioni principali.
Cache
La memorizzazione nella cache è comune e altamente consigliata perché migliora le prestazioni e aumenta la stabilità memorizzando le istruzioni dello script precompilato.
OPcache è la soluzione più utilizzata ed è disponibile per impostazione predefinita.
Caricamento automatico
Autoload è comune perché migliora le prestazioni e aumenta la stabilità caricando informazioni precompilate sulle classi.
La libreria client PHP è conforme a PSR-4 per
il caricamento automatico e fornisce la definizione come parte del
file composer.json. Le opzioni dedicate di Composer, ad esempio
--optimize-autoloader o --classmap-authoritative, possono quindi essere
utilizzate immediatamente.
Logging
L'impostazione dei logger su un livello elevato come ERROR può contribuire a ridurre l'overhead del tempo di esecuzione e il consumo di memoria.
Per ulteriori informazioni, consulta la guida alla registrazione.
Debug e profilazione
Ti consigliamo di disattivare gli strumenti di debug e profilazione, in quanto di solito comportano un overhead del tempo di esecuzione.
Precarica
A partire da PHP 7.4, il precaricamento di OPcache può essere utilizzato per precaricare gli script in memoria, andando oltre la normale memorizzazione nella cache.
Uno script deve essere progettato per sfruttare questa funzionalità, ma la libreria client PHP non lo fa perché non esiste un modo generico per implementare il precaricamento di OPcache e il compromesso tra utilizzo della memoria e miglioramento delle prestazioni è molto specifico per un determinato progetto ed esecuzione.