Différences entre PHP 5.5 et PHP 7/8

Remarque : PHP 5 ne sera plus pris en charge à partir du 30 janvier 2024. Après cette date, vos applications PHP 5 existantes continueront à fonctionner et à recevoir du trafic. Toutefois, vous ne pourrez pas déployer de nouvelles applications ou mettre à jour celles que vous possédez déjà qui utilisent des environnements d'exécution après leur date de fin de prise en charge. Nous vous recommandons de migrer vers la dernière version compatible de PHP en suivant les instructions de cette page.

Cette page explique comment migrer votre application PHP 5.5 vers l'environnement d'exécution PHP 7/8 dans l'environnement standard App Engine.

Problèmes de compatibilité entre PHP 5.5 et PHP 7/8

La documentation officielle de PHP fournit des informations sur les migrations à partir de différentes versions de PHP :

• Migration de PHP 5.5.x vers PHP 5.6.x
• Migration de PHP 5.6.x vers PHP 7.0.x
• Migration de PHP 7.0.x vers PHP 7.1.x
• Migration de PHP 7.1.x vers PHP 7.2.x
• Migration de PHP 7.2.x vers PHP 7.3.x
• Migration de PHP 7.3.x vers PHP 7.4.x
• Migration de PHP 7.4.x vers PHP 8.0.x
• Migration de PHP 8.0.x vers PHP 8.1.x

Migrer votre fichier app.yaml

Vous devez placer un contrôleur frontal pour gérer tout le routage de votre application. Pour en savoir plus, consultez la section Démarrage de l'application.

Les environnements d'exécution PHP 7/8 ne permettent pas de personnaliser l'élément de gestionnaire script. La seule valeur valide est auto, car l'intégralité du trafic est diffusée à l'aide de la commande "entrypoint". Tous les gestionnaires d'URL non statiques doivent inclure script: auto pour se déployer correctement.

Le comportement de certains éléments du fichier de configuration app.yaml a été modifié :

Élément	Type de modification	Description
entrypoint	Ajouts	Facultatif. Utilisez ce champ pour spécifier la commande à exécuter au démarrage de votre application.
threadsafe	Obsolète	Toutes les applications sont supposées être "threadsafe", ce qui signifie qu'une instance peut gérer plusieurs requêtes en même temps.
api_version	Obsolète	Auparavant obligatoire, mais non requis dans l'environnement d'exécution PHP 7/8.
application_readable	Obsolète
builtins	Obsolète
libraries	Obsolète	Les dépendances tierces arbitraires peuvent être installées à l'aide d'un fichier de métadonnées composer.json.
handlers	Modifié	Le champ script est facultatif et la seule valeur acceptée est auto. Utilisez un framework Web (tel que Laravel, Symfony, Slim ou une option semblable) avec un routage intégré pour exécuter un script lorsqu'une requête survient sur une route spécifique. Le champ login n'est pas disponible. Utilisez Identity and Access Management (IAM) pour la gestion des utilisateurs.

Si vous utilisez l'un des champs obsolètes, une erreur se produira lors du déploiement de l'application.

Pour en savoir plus, consultez la documentation de référence sur app.yaml.

Restrictions d'environnement d'exécution réduites

Les environnements d'exécution PHP 7/8 présentent moins de restrictions que l'environnement d'exécution PHP 5.5.

• Vous pouvez installer des dépendances tierces.
• L'environnement d'exécution comprend un système de fichiers complet.
• Vous pouvez créer des processus ou des threads en arrière-plan qui existent au-delà du champ d'application de la requête pendant l'exécution de l'instance.
• Utilisez la bibliothèque cliente Google Cloud pour PHP afin d'intégrer des applications à d'autres services Google Cloud. Pour en savoir plus, consultez la page Installer la bibliothèque cliente Google Cloud.

Pour en savoir plus, consultez la documentation concernant l'environnement d'exécution PHP 7/8.

Effectuer une migration à partir du SDK PHP App Engine

Pour réduire la complexité et les efforts de migration de l'environnement d'exécution, l'environnement standard App Engine vous permet d'accéder à de nombreux anciens services et API groupés dans l'environnement d'exécution PHP 7/8, tels que Memcache. Votre application PHP 7/8 peut appeler les API de services groupés via le SDK App Engine pour PHP 7/8 et accéder à la plupart des fonctionnalités de l'environnement d'exécution PHP 5. Les anciens services groupés disponibles pour PHP 5 ne disposent pas tous d'un service correspondant dans PHP 7/8. Pour obtenir la liste complète des anciennes API de services groupés disponibles pour PHP 7/8, consultez la documentation de référence des API des anciens services groupés.

Vous avez également la possibilité d'utiliser des produits Google Cloud qui offrent des fonctionnalités similaires aux anciens services groupés. Ces produits Google Cloud fournissent une bibliothèque cliente Google Cloud CLI idiomatique. Pour les anciens services groupés qui ne sont pas disponibles en tant que produits distincts dans Google Cloud, tels que la recherche, vous pouvez faire appel à des fournisseurs tiers ou à d'autres solutions. Pour en savoir plus sur la migration vers des services non groupés, consultez la page Effectuer la migration à partir de services groupés.

Exécuter votre application en local

Pour tester votre application et l'exécuter localement, procédez comme suit :

1. Installez localement une version de PHP correspondant à l'un des environnements d'exécution PHP 7/8 disponibles dans l'environnement standard App Engine.
2. Installez un serveur Web et utilisez-le pour diffuser votre application en local.

Par exemple, démarrez le serveur HTTP en exécutant la commande suivante :

php -S localhost:8080

Affichez ensuite votre application dans le navigateur Web à l'adresse http://localhost:8080.