Implémentations de tampons de protocole

Avertissement:À compter du 31 mars 2024, la bibliothèque cliente de l'API Google Ads pour PHP ne sera plus compatible avec les versions de PHP antérieures à la version 8.1. Pour assurer un fonctionnement fluide, nous vous recommandons vivement de mettre à niveau votre version de PHP avant cette date.

Deux implémentations sont disponibles pour PHP:

1. C: utilise l'extension PHP Protobuf qui améliore les performances.
2. PHP: utilise le package PHP google/protobuf, qui est plus facile à implémenter.

Nous vous recommandons d'utiliser l'implémentation C dans la mesure du possible. Toutefois, PHP peut être nécessaire dans certains cas (par exemple, lorsque des contraintes de sécurité ou techniques sont limitées).

L'implémentation PHP est automatiquement installée comme toutes les autres dépendances googleapis/gax-php dans Composer, mais elle n'est utilisée au moment de l'exécution que si l'implémentation C n'est pas installée et configurée.

Implémentation C

Pour installer et configurer l'extension PHP Protobuf:

1. Exécutez sudo pecl install protobuf à partir de la ligne de commande.
2. Ajoutez une ligne extension=protobuf.so au fichier php.ini.

Implémentation PHP

Assurez-vous que l'implémentation C est désactivée et que toutes les dépendances de la bibliothèque googleapis/gax-php sont installées:

1. Mettez en commentaire une ligne extension=protobuf.so dans php.ini.

2. Exécutez composer install à partir du répertoire contenant le fichier composer.json du projet en cours de traitement. composer.json doit spécifier google-ads-php ou tout projet qui l'exige comme dépendance.

   Important :Généralement, la version du tampon de protocole sur laquelle repose cette bibliothèque PHP est spécifiée de manière transitoire dans composer.json de google/gax, qui est l'une des dépendances principales. Toutefois, pour des raisons de performances ou de compatibilité, nous pouvons spécifier la version du tampon de protocole directement dans le fichier composer.json de la bibliothèque PHP.

Déterminer l'implémentation utilisée

Exécutez php -i | grep protobuf :

• Si le champ n'est pas vide, cela signifie que vous utilisez l'implémentation C.
• Sinon, vous n'utilisez pas l'implémentation C. La bibliothèque PHP de l'API Google Ads s'appuiera sur l'implémentation PHP (si elle est installée correctement à l'aide de Composer).