Guide de démarrage rapide PHP

Ce projet vous montre comment mettre en œuvre un élément Glassware simple qui démontre les principales fonctionnalités de l'API Google Mirror.

Pour voir une démonstration complète du projet à démarrage rapide, consultez la page https://glass-python-starter-demo.appspot.com. Sinon, poursuivez votre lecture pour découvrir comment déployer votre propre version.

Télécharger sur GitHub

Prérequis

• PHP 5.3.x ou version ultérieure
• Un serveur Web : vous avez besoin d'un emplacement pour héberger vos fichiers. Apache httpd et nginx fonctionnent très bien.
• Pour utiliser les abonnements, vous devez également disposer d'un environnement d'hébergement accessible à Internet avec un certificat SSL valide signé par une autorité de certification de confiance.

Remarque : Vous pouvez commencer à développer avec une instance localhost de votre serveur HTTP, mais vous devez disposer d'un hôte accessible par Internet pour utiliser les fonctionnalités d'abonnement de l'API.

Créer un projet dans la console d'API Google

Activez ensuite l'accès à l'API Google Mirror:

1. Accédez à la console des API Google et créez un projet d'API.
2. Cliquez sur Services et activez l'API Google Mirror pour votre nouveau projet.
3. Cliquez sur Accès API et créez un ID client OAuth 2.0 pour une application Web.
4. Indiquez le nom et l'icône de votre Glassware. Ces champs apparaissent sur l'écran d'authentification OAuth présenté à vos utilisateurs.
5. Sélectionnez Application Web, puis saisissez une valeur pour le nom d'hôte, par exemple localhost
6. Cliquez sur Modifier les paramètres pour l'ID client afin de spécifier les URI de redirection. Spécifiez les URL de rappel pour votre serveur Web de développement local, par exemple http://localhost:8080/oauth2callback, et pour votre serveur Web déployé, par exemple https://example.com/oauth2callback.
7. Notez l'ID client et le code secret dans la console d'API Google. Vous en aurez besoin pour configurer le projet de démarrage rapide.

Remarque:Vous avez également besoin de la clé API simple pour le projet de démarrage PHP.

Configurer le projet

Saisissez votre ID client, votre clé API simple et secrète, une URL de base ainsi qu'un emplacement où une base de données SQLite peut être créée dans config.php:

$api_client_id = "1234.apps.googleusercontent.com";
$api_client_secret = "ITS_A_SECRET_TO_EVERYBODY";
$api_simple_key = "AIzaSyCCbHcqDeb0oycQ9niV8P3n0F0qM";

$base_url = "http://example.com/starter-project";

$sqlite_database = "/tmp/database.sqlite";

Déployer le projet

Déployez le projet de démarrage rapide sur votre serveur hôte:

1. Copiez le répertoire de démarrage rapide PHP dans le répertoire de documents de votre serveur Web HTTP.

2. Selon la configuration de votre système, vous devrez peut-être précréer un fichier accessible en écriture pour la base de données SQLite:

   $ touch /tmp/database.sqlite
   $ chmod 777 /tmp/database.sqlite