Implementaciones de Protobuf

Advertencia: A partir del 31 de marzo de 2024, la biblioteca cliente de la API de Google Ads para PHP ya no admitirá versiones de PHP anteriores a 8.1. Para garantizar un funcionamiento óptimo, te recomendamos que actualices tu versión de PHP antes de esa fecha.

Hay dos implementaciones disponibles para PHP:

1. C: Usa la extensión de Protobuf para PHP, que brinda un mejor rendimiento.
2. PHP: Usa el paquete google/protobuf de PHP, que es más fácil de implementar.

Si puedes, recomendamos usar la implementación de C, pero es posible que se necesite PHP en algunos casos (por ejemplo, cuando está limitado por restricciones técnicas o de seguridad).

La implementación de PHP se instala de forma automática como cualquier otra dependencia de googleapis/gax-php en Composer, pero se usa en el entorno de ejecución solo si la implementación de C no está instalada ni configurada.

Implementación en C

Para instalar y configurar la extensión de Protobuf para PHP, sigue estos pasos:

1. Ejecuta sudo pecl install protobuf desde la línea de comandos.
2. Agrega una línea extension=protobuf.so al archivo php.ini.

Implementación en PHP

Asegúrate de que la implementación de C esté inhabilitada y que estén instaladas todas las dependencias de la biblioteca googleapis/gax-php:

1. Marca como comentario cualquier línea extension=protobuf.so en php.ini.

2. Ejecuta composer install desde el directorio que contiene el archivo composer.json del proyecto en el que trabajas. composer.json debe especificar google-ads-php o cualquier proyecto que lo requiera como dependencia.

   Punto clave: Por lo general, la versión de protobuf de la que se basa esta biblioteca PHP se especifica de forma transitiva en composer.json de google/gax, que es una de las dependencias principales. Sin embargo, por razones de rendimiento o compatibilidad, podemos especificar la versión de protobuf directamente en el composer.json de la biblioteca de PHP.

Determinar qué implementación se está usando

Ejecuta php -i | grep protobuf:

• Si el campo no está vacío, estás usando la implementación de C.
• De lo contrario, no estarás usando la implementación de C, y la biblioteca PHP de la API de Google Ads se basará en la implementación de PHP (si se instaló correctamente con Composer).