La biblioteca cliente de PHP facilita las interacciones con la API de Google Ads con un mínimo configuración por tu parte. Sin embargo, el rendimiento depende en gran medida de cómo biblioteca de Kubernetes.
La mayoría de estas prácticas recomendadas se aplican a todos los idiomas. En esta guía, se explican las que son específicas de PHP.
Implementación de protobuf
gRPC usa Protobuf. y la API de Google Ads para mensajes de solicitud y respuesta. Hay dos implementaciones disponible, aunque el que está escrito en C tiene el mejor rendimiento.
Consulta la guía de Protobuf para obtener más información.
Modo de operación del intérprete de PHP
PHP es una plataforma de secuencias de comandos lenguaje y tiene muchas operaciones modos según el uso. PHP La interfaz de puerta de enlace común (Common Gateway Interface) tiene una ventaja notable porque puede compartir recursos entre ejecuciones.
Versión de PHP
Es recomendable actualizar con regularidad a una versión más reciente de PHP, ya que, en general, incluye un mejor rendimiento general. Lista de PHP compatible versiones.
Versiones sin usar de la API de Google Ads
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 que admite la biblioteca cliente, hay paquetes exclusivos para la versión.
Los paquetes dedicados a las versiones de la API de Google Ads que no se utilizan se pueden de la biblioteca cliente. Como puede ser útil acelerar la ejecución o reducir el uso de memoria, la biblioteca cliente proporciona utilidades para hacerlo de forma programática.
Ejemplo
Supongamos que estás implementando una biblioteca cliente que solo usa la última versión
Versión de la API: v17, y quieres quitar la compatibilidad con la API
Versiones de la API: v16 y
v15
En el archivo composer.json del proyecto, define una secuencia de comandos de Composer (llamada
remove-google-ads-api-version-support) que aproveche la utilidad que proporciona
la biblioteca cliente, en la clase
ApiVersionSupport:
"scripts": {
"remove-google-ads-api-version-support": [
"Google\\Ads\\GoogleAds\\Util\\ApiVersionSupport::remove"
]
}
Luego, usa la secuencia de comandos de Composer con los números de versión como parámetros y, luego, imprime algunos 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 Google Ads API versions.
echo "# Supported Google Ads API versions:"
find ./vendor/googleads/google-ads-php/src/Google/Ads/GoogleAds/V* -maxdepth 0 | grep -o '..$'
echo "# Vendor folder size:"
du -sh ./vendor
# Use the Composer script to remove the unused versions v15 and v16 of the Google Ads API.
echo "# Removing support..."
composer run-script remove-google-ads-api-version-support -- 15 16
# Output the vendor folder size and the list of Google Ads API versions that are
# supported after removing support for Google Ads API versions.
echo "# Supported Google Ads API versions:"
find ./vendor/googleads/google-ads-php/src/Google/Ads/GoogleAds/V* -maxdepth 0 | grep -o '..$'
echo "# Vendor folder size:"
du -sh ./vendor
El resultado de la ejecución de muestra a continuación indica una reducción del tamaño del archivo de 50 millones y el
La única versión compatible restante es V17:
# Supported Google Ads API versions:
V15
V16
V17
# Vendor folder size:
110M ./vendor
# Removing support...
> Google\Ads\GoogleAds\Util\ApiVersionSupport::remove
Removing support for the version 15 of Google Ads API...
Done
Removing support for the version 16 of Google Ads API...
Done
# Supported Google Ads API versions:
V17
# Vendor folder size:
60M ./vendor
Desarrollo versus producción
PHP es un lenguaje interpretado ya que primero compila instrucciones antes de ejecutarlas. Por lo general, ventajoso, ya que durante el tiempo de desarrollo, las fuentes suelen cambiar mientras se ejecutan el tiempo no es tan crucial. Sin embargo, ocurre lo contrario en el momento de la producción, ya que la estabilidad y el rendimiento se convierten en las principales preocupaciones.
Caché
El almacenamiento en caché es común y se recomienda porque ambos mejoran el rendimiento y aumenta la estabilidad mediante el almacenamiento de instrucciones de secuencias de comandos precompiladas.
OPcache es el archivo que se usa con mayor frecuencia y está disponible de forma predeterminada.
Carga automática
La carga automática es común. porque mejora el rendimiento y aumenta la estabilidad mediante la carga información precompilada sobre clases.
La biblioteca cliente de PHP cumple con PSR-4 para
de carga automática y brinda la definición como parte del
composer.json
. Opciones dedicadas de Composer, como
Por ejemplo, --optimize-autoloader o --classmap-authoritative, pueden ser
usar de inmediato.
Logging
Establecer los registradores en un nivel alto como ERROR puede ayudar a reducir el tiempo de ejecución
y el consumo de memoria.
Consulta la guía de Logging para obtener más información.
Depuración y generación de perfiles
Te recomendamos inhabilitar las herramientas de depuración y generador de perfiles, ya que generalmente vienen con cierta sobrecarga del tiempo de ejecución.
Precargar
Desde PHP 7.4, OPcache precarga pueden usarse para precargar secuencias de comandos en la memoria, lo que va un paso más allá de lo normal el almacenamiento en caché.
La secuencia de comandos debe diseñarse para aprovechar esta función, pero la interfaz de no lo hace la biblioteca cliente, ya que no existe una forma genérica de implementar OPcache. la precarga y la compensación entre el uso de memoria y la ganancia de rendimiento muy específicos de un proyecto y una ejecución determinados.