Remarque: Au cours des prochains mois, nous allons réorganiser le site de documentation App Engine afin de faciliter la recherche de contenu et de mieux s'aligner avec les autres produits Google Cloud. Le même contenu sera disponible, mais la navigation correspondra désormais au reste des produits Cloud.

Utiliser les bibliothèques PHP

Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Vous pouvez déclarer des dépendances pour PHP dans un fichier composer.json standard. Exemple :

{
    "require": {
        "google/cloud": "^0.72"
    }
}

Vous pouvez utiliser n'importe quel package PHP compatible avec Linux dans App Engine. L'environnement d'exécution recherche un fichier composer.json dans le répertoire source de votre application et, avant de démarrer cette dernière, utilise composer pour installer les dépendances.

Pour en savoir plus sur les versions PHP compatibles avec cet environnement d'exécution, consultez la page Environnement d'exécution PHP.

Installer et exécuter en local

Installez vos dépendances en local à l'aide de Composer.

composer install

Pour épingler les dépendances à leur version actuelle, validez le fichier composer.lock dans votre application.

Vous pouvez tester votre application à l'aide du serveur Web de votre choix. L'environnement flexible App Engine utilise NGINX en production. Vous pouvez exécuter rapidement votre application à l'aide du serveur Web intégré de PHP.

Installer un framework Web

Par défaut, NGINX est configuré pour diffuser toutes les requêtes via index.php. Un framework n'est pas obligatoire, mais recommandé. Vous pouvez utiliser n'importe quel framework Web avec les environnements flexibles App Engine, par exemple :

Pour utiliser un framework Web particulier, il vous suffit de l'ajouter au fichier composer.json :

{
    "require": {
        "symfony/symfony": " ^3.0"
    }
}

Installer la bibliothèque cliente Google Cloud

La bibliothèque cliente Google Cloud pour PHP permet d'accéder facilement aux services Google Cloud. De ce fait, la quantité de code récurrent que vous devez développer est réduite. Cette bibliothèque fournit des abstractions d'API de haut niveau, faciles à comprendre. Elle accepte les idiomes de PHP, fonctionne correctement avec la bibliothèque standard et s'intègre mieux à votre codebase. Vous pouvez donc consacrer plus de temps à développer du code qui vous est réellement utile.

Pour installer la bibliothèque en local :

composer require google/cloud

Vous pouvez gérer l'authentification localement à l'aide de Google Cloud CLI. Si vous souhaitez que votre application locale utilise temporairement vos propres identifiants pour accéder à l'API, exécutez la commande suivante :

gcloud auth application-default login

Pour gérer manuellement l'authentification ou obtenir davantage d'informations, consultez la section Fournir des identifiants à votre application.

Utiliser des dépôts privés

Pour utiliser des bibliothèques dans des dépôts privés, procédez comme suit :

  • Configurez le dépôt.
  • Donnez à composer le secret permettant d'accéder au dépôt privé.

L'exemple suivant montre comment accéder à un dépôt privé dans GitHub.

  1. Configurez le dépôt dans composer.json en définissant le type sur vcs :

    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/username/private_package"
        }
    ]
    
  2. Créez un fichier nommé auth.json dans le répertoire racine de votre projet :

    {
        "github-oauth": {
            "github.com": "<your-github-auth-token>"
        }
    }
    

Vous pouvez obtenir le jeton d'authentification GitHub à partir de l'interface utilisateur d'administration de GitHub.

Voici un autre exemple illustrant comment accéder à un dépôt privé pour Bitbucket.

  1. Configurez le dépôt dans composer.json en définissant le type sur vcs :

    "repositories": [
        {
            "type": "vcs",
            "url":  "https://bitbucket.org/username/private_git"
        }
    ]
    
  2. Créez un fichier nommé auth.json dans le répertoire racine de votre projet :

    {
        "bitbucket-oauth": {
            "bitbucket.org": {
                "consumer-key": "<your-oauth-consumer-key>",
                "consumer-secret": "<your-oauth-consumer-secret>"
            }
        }
    }