Guide de démarrage rapide pour PHP 7 dans l'environnement standard

ID de région

Le REGION_ID est un code abrégé que Google attribue en fonction de la région que vous sélectionnez lors de la création de votre application. Le code ne correspond pas à un pays ou une province, même si certains ID de région peuvent ressembler aux codes de pays et de province couramment utilisés. L'ajout de REGION_ID.r dans les URL App Engine est facultatif pour les applications existantes. Il sera bientôt obligatoire pour toutes les applications nouvelles.

Pour assurer une transition en douceur, nous mettons lentement à jour App Engine afin d'utiliser les ID de région. Si nous n'avons pas encore mis à jour votre projet Google Cloud, vous ne verrez pas d'ID de région pour votre application. Étant donné que l'ID est facultatif pour les applications existantes, vous n'avez pas besoin de mettre à jour les URL ni d'effectuer d'autres modifications une fois l'ID de région disponible pour vos applications existantes.

En savoir plus sur les ID de région

OK

Python 2.7/3 |Java 8/11 |PHP 5/7 |Ruby |Go 1.11/1.12+ |Node.js

Dans cette page, vous allez apprendre à déployer une application de base App Engine qui affiche un message court. Pour une présentation plus détaillée de PHP sur App Engine, consultez la page Créer une application.

La plate-forme App Engine est-elle l'option de calcul la plus adaptée à vos besoins ? Découvrez d'autres options pour héberger votre application sur Google Cloud.

Coûts

Les procédures de ce guide n'engendrent aucun coût. L'exécution seule de cet exemple d'application ne dépasse pas votre quota gratuit.

Avant de commencer

Avant d'exécuter et de déployer ce guide de démarrage rapide, installez le SDK Cloud, puis configurez un projet Cloud pour App Engine :

1. Téléchargez et installez le SDK Cloud :

   Télécharger le SDK

   Remarque : Si le SDK Cloud est déjà installé, mettez-le à jour en exécutant la commande suivante :

   gcloud components update
   

2. Créez un projet :

   gcloud projects create [YOUR_PROJECT_ID] --set-as-default
   

   Remplacez [YOUR_PROJECT_ID] par une chaîne de caractères qui identifie votre projet de manière unique. Exemple : my-project-24.

   L'option --set-as-default définit votre nouveau projet comme projet par défaut utilisé par gcloud.

   Vérifiez que le projet a été créé :

   gcloud projects describe [YOUR_PROJECT_ID]
   

   Vous voyez alors les informations relatives au projet qui peuvent se présenter sous la forme suivante :

   createTime: year-month-hour
   lifecycleState: ACTIVE
   name: project-name
   parent:
     id: '433637338589'
     type: organization
   projectId: project-name-id
   projectNumber: 499227785679
   

3. Initialisez votre application App Engine avec votre projet, puis choisissez sa région :

   gcloud app create --project=[YOUR_PROJECT_ID]
   

   Lorsque vous y êtes invité, sélectionnez la région dans laquelle vous souhaitez déployer votre application App Engine.

   Attention : Une fois la région d'une application définie, vous ne pouvez plus la modifier.

4. Assurez-vous que la facturation est activée pour votre projet. Un compte de facturation doit être associé à votre projet pour que l'application puisse être déployée dans App Engine.

   Activer la facturation

   Remarque : L'exécution de cet exemple d'application n'entraîne pas le dépassement de votre quota gratuit.

5. Installez les composants requis suivants :

   • Téléchargez et installez Git.
   • Installez une version de PHP 7 qui est compatible avec l'environnement d'exécution PHP 7.

   • Pour gérer les dépendances, téléchargez Composer et assurez-vous que son exécutable est installé globalement.

Emplacements App Engine

App Engine est régional, ce qui signifie que l'infrastructure qui exécute vos applications est située dans une région spécifique, et que Google la gère de sorte qu'elle soit disponible de manière redondante dans toutes les zones de cette région.

Lors de la sélection d'une région dans laquelle exécuter vos applications, vous devez tout d'abord considérer vos exigences en matière de latence, de disponibilité et de durabilité. Vous pouvez généralement sélectionner la région la plus proche des utilisateurs de votre application, mais pensez aussi aux emplacements où App Engine est disponible ainsi qu'aux emplacements des autres produits et services Google Cloud que votre application utilise. L'utilisation de services situés dans des emplacements différents peut avoir des répercussions sur la latence de votre application, ainsi que sur les tarifs.

Remarque : Deux emplacements, appelés europe-west et us-central dans les commandes App Engine et dans Google Cloud Console, sont respectivement appelés europe-west1 et us-central1 dans les autres documentations de Google.

Une fois que vous avez défini la région d'une application, vous ne pouvez plus la modifier.

Si vous avez déjà créé une application App Engine, vous pouvez afficher sa région en effectuant l'une des opérations suivantes :

• Exécutez la commande gcloud app describe.

• Ouvrez le tableau de bord App Engine dans Cloud Console. La région apparaît en haut de la page.

OK

Dans ce guide de démarrage rapide, nous partons du principe que vous connaissez le langage de programmation PHP.

Télécharger l'application Hello World

Nous avons créé une application Hello World simple pour PHP afin de vous aider à comprendre rapidement comment déployer une application sur Google Cloud Platform. Pour télécharger Hello World sur votre ordinateur local :

1. Clonez le dépôt de l'exemple d'application Hello World sur votre ordinateur.

   git clone https://github.com/GoogleCloudPlatform/php-docs-samples.git
   

   Vous pouvez également télécharger l'exemple en tant que fichier ZIP et l'extraire.

2. Accédez au répertoire qui contient l'exemple de code.

   cd php-docs-samples/appengine/standard/helloworld
   

Déployer Hello World sur App Engine

1. Pour déployer l'application Hello World sur App Engine, exécutez la commande suivante depuis le répertoire php-docs-samples/appengine/standard/helloworld :

   gcloud app deploy
   

2. Affichez l'application en direct à l'adresse https://PROJECT_ID.REGION_ID.r.appspot.com :

   gcloud app browse
   

Le message Hello, world! est maintenant diffusé par un serveur Web s'exécutant sur une instance App Engine.

Félicitations ! Vous venez de déployer un service Web PHP sur App Engine.

Effectuer un nettoyage

Si vous souhaitez continuer à vous familiariser avec App Engine, vous pouvez conserver votre projet Cloud et suivre les étapes de la page Créer une application.

Vous pouvez également supprimer votre projet Cloud. La facturation de toutes les ressources qu'il utilise sera ainsi interrompue.

Attention : La suppression d'un projet aura les effets suivants :
• Tout le contenu du projet est supprimé. Si vous avez utilisé un projet existant pour ce tutoriel et que vous le supprimez, vous supprimerez également tout autre travail effectué dans le projet.
• Les ID de projets personnalisés sont perdus. Lorsque vous avez créé ce projet, vous avez peut-être créé un ID de projet personnalisé que vous souhaitez utiliser à l'avenir. Pour conserver les URL qui utilisent l'ID de projet, telle qu'une URL appspot.com, supprimez les ressources sélectionnées dans le projet au lieu de supprimer l'ensemble du projet.
1. Dans Cloud Console, accédez à la page Gérer les ressources.

   Accéder à la page Gérer les ressources

2. Dans la liste des projets, sélectionnez le projet que vous souhaitez supprimer, puis cliquez sur Supprimer.
3. Dans la boîte de dialogue, saisissez l'ID du projet, puis cliquez sur Arrêter pour supprimer le projet.

Étape suivante

Maintenant que vous savez déployer un service Web sur App Engine, accédez à une présentation plus détaillée de PHP sur App Engine en consultant la page Créer une application.