Implémentations de tampons de protocole

Deux implémentations Protobuf sont disponibles pour PHP :

1. C : utilise l'extension Protobuf PHP C, qui offre des performances d'exécution nettement supérieures.
2. PHP : utilise le package PHP google/protobuf, qui ne nécessite aucune extension système supplémentaire.

Utilisez l'implémentation C lorsque cela est possible, bien que l'implémentation PHP pure puisse être utilisée lorsque des contraintes de sécurité ou d'environnement empêchent l'installation d'extensions C.

L'implémentation PHP est automatiquement installée en tant que dépendance de googleapis/gax-php dans Composer et n'est utilisée au moment de l'exécution que si l'implémentation C n'est pas installée et activée.

Implémentation en C

Pour installer et configurer l'extension Protobuf PHP C, procédez comme suit :

1. Installez l'extension à l'aide de PECL :

   sudo pecl install protobuf
   

2. Activez l'extension dans votre fichier php.ini actif (pour les environnements de CLI et de serveur Web tels que PHP-FPM ou Apache ; exécutez php --ini pour localiser le fichier de configuration de la CLI) :

   extension=protobuf.so
   

   Remarque : Sous Windows, ajoutez plutôt extension=php_protobuf.dll à php.ini.

Implémentation PHP

Pour utiliser l'implémentation PHP pure, assurez-vous que l'implémentation C est désactivée et que toutes les dépendances de googleapis/gax-php sont installées :

1. Mettez en commentaire ou supprimez toute ligne extension=protobuf.so (ou extension=php_protobuf.dll) de vos fichiers php.ini.

2. Exécutez composer install à partir du répertoire contenant le fichier composer.json de votre projet. Le fichier composer.json doit spécifier googleads/google-ads-php en tant que dépendance.

   Point clé : En règle générale, la version de Protobuf sur laquelle repose cette bibliothèque PHP est spécifiée de manière transitive dans le fichier composer.json de google/gax. Pour des raisons de performances ou de compatibilité, une version minimale de Protobuf peut également être spécifiée directement dans le fichier composer.json de la bibliothèque cliente PHP.

Déterminer l'implémentation utilisée

Exécutez la commande suivante dans votre terminal pour vérifier si l'extension C est activée dans votre environnement PHP CLI :

php -i | grep protobuf

• Si le résultat n'est pas vide (par exemple, protobuf support => enabled), vous utilisez l'implémentation C.
• Sinon, vous n'utilisez pas l'implémentation C, et la bibliothèque PHP de l'API Google Ads revient automatiquement à l'implémentation PHP pure installée par Composer.