Implementazioni Protobuf

Avviso: a partire dal 31 marzo 2024, la libreria client dell'API Google Ads per PHP non supporterà più le versioni PHP precedenti alla 8.1. Per garantire il funzionamento ottimale, ti consigliamo vivamente di eseguire l'upgrade della versione PHP prima di questa data.

Per PHP sono disponibili due implementazioni:

1. C: utilizza l'estensione PHP Protobuf che offre prestazioni migliori.
2. PHP: utilizza il pacchetto PHP google/protobuf, che è più facile da implementare.

Consigliamo di utilizzare l'implementazione C, se possibile, ma in alcuni casi potrebbe essere necessario il PHP, ad esempio se limitato da vincoli di sicurezza o tecnici.

L'implementazione PHP viene installata automaticamente come qualsiasi altra dipendenza googleapis/gax-php in Composer, ma viene utilizzata in fase di runtime solo se l'implementazione C non è installata e configurata.

Implementazione C

Per installare e configurare l'estensione PHP Protobuf:

1. Esegui sudo pecl install protobuf dalla riga di comando.
2. Aggiungi una riga extension=protobuf.so al file php.ini.

Implementazione PHP

Assicurati che l'implementazione C sia disabilitata e che tutte le dipendenze della libreria googleapis/gax-php siano installate:

1. Commenta qualsiasi riga di extension=protobuf.so in php.ini.

2. Esegui composer install dalla directory che contiene il file composer.json del progetto su cui stai lavorando. composer.json deve specificare google-ads-php o qualsiasi progetto che lo richieda come dipendenza.

   Punto chiave: in genere, la versione protobuf su cui si basa questa libreria PHP è specificata in modo transitivo in composer.json di google/gax, che è una delle dipendenze principali. Tuttavia, per motivi di prestazioni o di compatibilità, potremmo specificare la versione protobuf direttamente nella libreria PHP composer.json.

Stabilire quale implementazione viene utilizzata

Esecuzione php -i | grep protobuf:

• Se non è vuoto, utilizzi l'implementazione C.
• In caso contrario, non utilizzi l'implementazione C e la libreria PHP dell'API Google Ads si baserà sull'implementazione PHP (se installata correttamente utilizzando Composer).