La biblioteca cliente de PHP facilita las interacciones con la API de Google Ads con una configuración mínima de tu parte. Sin embargo, el rendimiento depende significativamente de cómo se use y se integre la biblioteca.
La mayoría de las prácticas recomendadas generales se aplican a todos los idiomas. En esta guía, se abordan las optimizaciones del rendimiento específicas de PHP.
Implementaciones de Protobuf y gRPC
Protobuf se usa en gRPC y en la API de Google Ads para los mensajes de solicitud y respuesta. Hay dos implementaciones disponibles (PHP puro y una extensión en C), y las extensiones en C para protobuf y grpc proporcionan un rendimiento de serialización y de red significativamente mejor.
Consulta la guía de Protobuf y la guía de transporte para obtener más información.
Modo de operación del intérprete de PHP
PHP es un lenguaje de secuencias de comandos versátil que tiene varios modos de operación según el uso. PHP-FPM (FastCGI Process Manager) o los servidores de aplicaciones persistentes tienen una ventaja notable sobre CGI estándar, ya que los procesos de trabajo persistentes pueden reutilizar el bytecode almacenado en caché (a través de OPcache) y los recursos en las solicitudes.
Versión de PHP
Actualiza periódicamente a una versión más reciente de PHP para aprovechar las mejoras en el rendimiento del tiempo de ejecución. Consulta la lista de versiones de PHP compatibles.
Versiones de la API de Google Ads que no se usan
Todas las versiones de la biblioteca cliente admiten varias versiones de la API de Google Ads. Para cada versión de la API de Google Ads compatible con la biblioteca cliente, existen paquetes específicos para esa versión.
Los paquetes dedicados a las versiones de la API de Google Ads que no usa tu aplicación se pueden quitar de forma segura de la biblioteca cliente. Para reducir el espacio de memoria y acelerar la ejecución, la biblioteca cliente proporciona una utilidad para quitar las versiones de la API que no se usan de forma programática.
Ejemplo
Supongamos que implementas una aplicación cliente que solo usa la versión de API más reciente (v25) y deseas quitar la compatibilidad con las versiones de API no utilizadas (v22, v23 y v24).
En el archivo composer.json de tu proyecto, define una secuencia de comandos de Composer (llamada remove-google-ads-api-version-support) que aproveche la utilidad proporcionada por la biblioteca cliente en ApiVersionSupport:
"scripts": {
"remove-google-ads-api-version-support": [
"Google\\Ads\\GoogleAds\\Util\\ApiVersionSupport::remove"
]
}
Luego, ejecuta la secuencia de comandos de Composer con los números de versión como parámetros y muestra mensajes de estado:
# 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 unused Google Ads API versions.
echo "# Supported Google Ads API versions:"
find ./vendor/googleads/google-ads-php/src/Google/Ads/GoogleAds/V* \
-maxdepth 0 | grep -oE 'V[0-9]+$'
echo "# Vendor folder size:"
du -sh ./vendor
# Use the Composer script to remove the unused versions
# v22, v23, and
# v24 of the Google Ads API.
echo "# Removing support..."
composer run-script remove-google-ads-api-version-support -- \
22 \
23 \
24
# Output the vendor folder size and the list of Google Ads API versions that are
# supported after removing support for unused Google Ads API versions.
echo "# Supported Google Ads API versions:"
find ./vendor/googleads/google-ads-php/src/Google/Ads/GoogleAds/V* \
-maxdepth 0 | grep -oE 'V[0-9]+$'
echo "# Vendor folder size:"
du -sh ./vendor
En el siguiente resultado de la ejecución de ejemplo, se muestra la reducción del tamaño del archivo, con V25 como la única versión compatible restante:
# Supported Google Ads API versions:
V22
V23
V24
V25
# Vendor folder size:
135M ./vendor
# Removing support...
> Google\Ads\GoogleAds\Util\ApiVersionSupport::remove
Removing support for the version 22 of Google Ads API...
Done
Removing support for the version 23 of Google Ads API...
Done
Removing support for the version 24 of Google Ads API...
Done
# Supported Google Ads API versions:
V25
# Vendor folder size:
60M ./vendor
Desarrollo versus producción
PHP es un lenguaje interpretado que compila instrucciones antes de ejecutarlas. Esto es ventajoso durante el desarrollo, cuando los archivos fuente cambian con frecuencia y el tiempo de ejecución es menos crítico. En los entornos de producción, la estabilidad y el rendimiento se convierten en las principales preocupaciones.
Caché
Se recomienda el almacenamiento en caché porque mejora el rendimiento y aumenta la estabilidad, ya que almacena el bytecode del script precompilado en la memoria compartida.
OPcache es la solución estándar y se incluye con PHP de forma predeterminada.
Carga automática
La carga automática mejora el rendimiento y la estabilidad, ya que carga información precompilada del mapa de clases.
La biblioteca cliente de PHP cumple con PSR-4 para la carga automática y proporciona la definición como parte de su archivo composer.json. Luego, se pueden usar las opciones de la CLI de Composer específicas, como --optimize-autoloader o --classmap-authoritative, de inmediato en las compilaciones de producción.
Logging
Establecer registradores en un umbral más alto, como ERROR o WARNING en producción, ayuda a reducir la sobrecarga de E/S y el consumo de memoria.
Consulta la guía de registro para obtener más información.
Depuración y generación de perfiles
Inhabilita las extensiones de depurador y generador de perfiles (como Xdebug) en producción, ya que introducen una sobrecarga de ejecución considerable.
Precargar
Desde PHP 7.4, se puede usar la precarga de OPcache para precargar secuencias de comandos en la memoria al inicio del servidor, lo que va un paso más allá del almacenamiento en caché estándar de OPcache.
Una secuencia de comandos de carga previa debe diseñarse específicamente para tu aplicación. La biblioteca cliente de PHP no proporciona una secuencia de comandos de carga previa genérica porque la compensación entre el uso de memoria y la mejora del rendimiento es específica para cada proyecto y entorno de implementación.