Migra de PHP 5.5 al entorno de ejecución de PHP más reciente

En esta página, se abordan las instrucciones para migrar de los entornos de ejecución de PHP de primera generación a la segunda. Si quieres actualizar tu app de segunda generación para usar la última versión compatible de PHP, consulta Actualiza una aplicación existente.

PHP 5 alcanzó el fin de la asistencia el 30 de enero de 2024. Tus aplicaciones existentes de PHP 5 seguirán ejecutándose y recibiendo tráfico. Sin embargo, App Engine podría bloquear la reimplementación de aplicaciones que usan entornos de ejecución después de la fecha de finalización de la asistencia. Te recomendamos que migres al entorno de ejecución de PHP del entorno de ejecución compatible más reciente usando los lineamientos de esta página.

La migración a un entorno de ejecución de PHP de segunda generación compatible te permite usar funciones de lenguaje actualizadas y compilar apps que sean más portátiles, con código idiomático.

Problemas de compatibilidad entre los entornos de ejecución de PHP 5.5 y PHP de segunda generación

La documentación oficial de PHP proporciona información sobre cómo migrar desde diferentes versiones de PHP:

Diferencias clave entre los entornos de ejecución de PHP 5.5 y PHP de segunda generación

A continuación, se presenta un resumen de las diferencias entre los entornos de ejecución de PHP 5.5 y de segunda generación en el entorno estándar de App Engine:

Diferencias en el uso de memoria

Los entornos de ejecución de segunda generación ven un modelo de referencia de uso de memoria más alto en comparación con los entornos de ejecución de primera generación. Esto se debe a varios factores, como las diferentes versiones de imagen base, y las diferencias en la forma en que las dos generaciones calculan el uso de memoria.

Los entornos de ejecución de segunda generación calculan el uso de memoria de las instancias como la suma de lo que usa un proceso de la aplicación y la cantidad de archivos de la aplicación almacenados en caché de forma dinámica en la memoria. Para evitar que las aplicaciones con uso intensivo de memoria experimenten apagados de instancias debido a que se excedieron los límites de memoria, actualiza a una clase de instancia más grande con más memoria.

Diferencias en el uso de CPU

Los entornos de ejecución de segunda generación pueden ver un modelo de referencia de uso de CPU más alto cuando se inicia en frío en la instancia. Según la configuración de escalamiento de una aplicación, esto puede tener efectos secundarios no deseados, como un recuento de instancias más alto de lo previsto si una aplicación está configurada para escalar en función del uso de CPU. Para evitar este problema, revisa y prueba las configuraciones de escalamiento de la aplicación para asegurarte de que la cantidad de instancias sea aceptable.

Diferencias en el encabezado de la solicitud

Los entornos de ejecución de primera generación permiten que los encabezados de la solicitud con guiones bajos (p.ej., X-Test-Foo_bar) se reenvíen a la aplicación. Los entornos de ejecución de segunda generación ingresan Nginx en la arquitectura del host. Como resultado de este cambio, los entornos de ejecución de segunda generación están configurados para quitar de forma automática los encabezados con guiones bajos (_). Para evitar problemas con la aplicación, evita usar guiones bajos en los encabezados de la solicitud de la aplicación.

Migra el archivo app.yaml

Debes colocar un controlador frontal para que gestione todos los enrutamientos de tu aplicación. Para obtener más información, consulta Inicio de la aplicación.

Los entornos de ejecución de PHP de segunda generación no permiten que se personalice el elemento controlador script. El único valor que se admite es auto, ya que todo el tráfico se entrega mediante el comando entrypoint. Todos los controladores de URL no estática deben incluir script: auto para que la implementación se realice de manera correcta.

Se modificó el comportamiento de algunos elementos del archivo de configuración app.yaml:

ElementoTipo de cambioDescripción
entrypointAgregado De manera opcional, usa este campo para especificar el comando que se ejecutará cuando se inicie la app.
threadsafeObsoletoSe supone que todas las aplicaciones son seguras para los subprocesos, por lo que una instancia puede manejar varias solicitudes al mismo tiempo.
api_versionObsoletoAntes era obligatorio, pero en los entornos de ejecución de PHP de segunda generación no es necesario.
application_readableObsoleto
builtinsObsoleto
librariesObsoletoSe pueden instalar dependencias arbitrarias de terceros mediante un archivo de metadatos composer.json.
handlersModificado
  • El campo script es opcional, y el único valor aceptado es auto. Usa un framework web (como Laravel, Symfony, Slim o una opción similar) con enrutamiento incorporado en la app para ejecutar una secuencia de comandos cuando una solicitud alcanza una ruta específica.
  • No se admite el campo login. Usa la Administración de identidades y accesos (IAM) para la administración de usuarios.

Si usas alguno de los campos obsoletos, la implementación de la app fallará.

Para obtener más información, consulta la referencia app.yaml.

Restricciones de entorno de ejecución reducidas

Los entornos de ejecución de PHP de segunda generación tienen menos restricciones en comparación con el entorno de ejecución de PHP 5.5.

Para obtener más información, consulta el entorno de ejecución de PHP.

Migra desde el SDK de PHP de App Engine

Para reducir el esfuerzo y la complejidad de la migración del entorno de ejecución, el entorno estándar de App Engine te permite acceder a muchos de los servicios agrupados en paquetes y APIs heredados en el entorno de ejecución de PHP segunda generación, como Memcache. Tu app de PHP de segunda generación puede llamar a las APIs de servicios agrupados en paquetes a través del SDK de App Engine, y acceder a las mismas funcionalidades que en el entorno de ejecución de PHP 5. No todos los servicios agrupados en paquetes heredados disponibles en PHP 5 tienen un servicio correspondiente en los entornos de ejecución de PHP de segunda generación. Para ver la lista completa de las APIs de servicios agrupados en paquetes heredados disponibles para los entornos de ejecución de PHP de segunda generación, consulta la documentación de referencia de la API de servicios agrupados en paquetes heredados.

También tienes la opción de usar productos de Google Cloud que ofrecen funciones similares a las de los servicios agrupados en paquetes heredados. Estos productos de Google Cloud proporcionan una biblioteca cliente de Google Cloud CLI. Para los servicios agrupados en paquetes heredados que no están disponibles como productos independientes en Google Cloud, como la búsqueda, puedes usar proveedores de terceros u otras soluciones alternativas. Para obtener más información sobre la migración a servicios sin agrupar, consulta Migra desde servicios en paquetes.

Ejecuta la aplicación de manera local

Para probar tu aplicación y ejecutarla de manera local, haz lo siguiente:

  1. Instala de forma local una versión de PHP que corresponda a un entorno de ejecución de PHP de segunda generación disponible en el entorno estándar de App Engine.

  2. Instala un servidor web y úsalo para entregar tu app de forma local.

Por ejemplo, ejecuta el siguiente comando para iniciar el servidor HTTP:

php -S localhost:8080

Luego, visita http://localhost:8080 para ver la aplicación en el navegador web.