Créer un livre d'or

Ce tutoriel explique comment mettre en œuvre une application PHP pour App Engine, un livre d'or simple qui permet aux utilisateurs de publier des messages sur une page publique.

Objectifs

  • Cloner le projet de tutoriel
  • Parcourir les exemples de code pour voir comment intégrer votre application aux comptes Google, gérer les formulaires Web et diffuser les fichiers statiques
  • Exécuter, tester et déployer le projet

Coûts

L'exécution de ce tutoriel n'engendre aucun coût. Cette application ne dépasse pas le quota gratuit.

Avant de commencer

  1. Créez un projet dans la console Google Cloud ou récupérez l'ID d'un projet existant à partir de la console Google Cloud :

    Accéder à la page Projets

    Conseil : Récupérez une liste d'ID de projets existants avec gcloud.

  2. Installez et initialisez gcloud CLI :
    Télécharger gcloud CLI

Cloner le projet à partir de GitHub

  1. Clonez le dépôt de l'application Guestbook sur votre ordinateur local :

    git clone https://github.com/GoogleCloudPlatform/appengine-php-guestbook.git

  2. Passez à la branche comportant la version finale de l'application :

    cd appengine-php-guestbook/
git fetch
git checkout phase3-staticfiles

Le projet cloné contient plusieurs branches. Dans ce tutoriel, nous ne traiterons que du projet dans la branche nommée phase3-staticfiles.

Créer l'application et l'exécuter localement

Pour créer et exécuter l'exemple en local, procédez comme suit :

  1. À partir du projet appengine-php-guestbook dans la branche phase3-staticfiles, appelez la commande suivante, en remplaçant /path/to/php-cgi par la valeur appropriée :

    python3 CLOUD_SDK_ROOT/bin/dev_appserver.py ./ --php_executable_path=/path/to/php-cgi

  2. Le serveur Web de développement est désormais en cours d'exécution. Accédez à http://localhost:8080.

  3. L'application diffuse une page vous invitant à vous connecter. Essayez de cliquer sur le lien Connexion, puis connectez-vous avec une adresse e-mail. Le serveur de développement utilise une émulation très élémentaire du processus de connexion de compte Google, à des fins de test seulement. Il accepte donc l'adresse e-mail que vous avez fournie, qu'elle soit valide ou non, et génère un objet utilisateur factice basé sur cette valeur fournie. Une fois déployé en production, ce même code requiert une adresse e-mail et un compte Google valides pour que la connexion fonctionne. Si tel est le cas, le code génère un objet utilisateur valide.

  4. Arrêtez le serveur de développement en appuyant sur Ctrl+C.

Comprendre le code

Pour parcourir le code d'application et voir comment il fonctionne, passez à la page suivante.