Como usar bibliotecas PHP

É possível declarar dependências do PHP em um arquivo composer.json (em inglês) padrão. Por exemplo:

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

Use qualquer pacote PHP compatível com o Linux no App Engine. O ambiente de execução procura um arquivo composer.json no diretório de origem do aplicativo e usa o composer (ambos em inglês) para instalar as dependências antes de iniciar o aplicativo.

Para informações sobre as versões do PHP que são compatíveis com este ambiente de execução, consulte O ambiente de execução do PHP.

Como instalar e executar no local

Use o Composer para instalar as dependências no local.

composer install

Para fixar as dependências na versão atual, confirme o arquivo composer.lock (em inglês) no aplicativo.

Teste o aplicativo usando o servidor da Web da sua preferência. O ambiente flexível do App Engine usa NGINX (em inglês) na produção. Para executar o aplicativo com rapidez, use o servidor da Web integrado do PHP (em inglês).

Como instalar um framework da Web

Por padrão, o NGINX está configurado para veicular todas as solicitações por meio do index.php. Ter uma estrutura não é obrigatório, mas é recomendado. Você pode usar qualquer estrutura da Web com os ambientes flexíveis do App Engine. Isso inclui:

Para usar um framework web específico, basta adicioná-lo a composer.json:

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

Como instalar a biblioteca de cliente do Google Cloud

A biblioteca de cliente do Google Cloud para PHP é uma biblioteca de cliente para acessar serviços do Google Cloud que reduzem o código boilerplate que você precisa escrever. A biblioteca fornece abstrações detalhadas de API fáceis de entender. Ela abrange os termos de PHP, funciona bem com a biblioteca padrão e oferece mais integração com sua base de código. Assim, você passa mais tempo criando o código necessário.

Para instalar a biblioteca no local:

composer require google/cloud

Também é possível processar a autenticação localmente usando o SDK do Google Cloud. Se você quiser que seu aplicativo local use temporariamente suas próprias credenciais de usuário para acesso à API, execute:

gcloud auth application-default login

Para processar manualmente a autenticação ou ver mais informações, consulte a seção Como fornecer credenciais para um aplicativo.

Como usar repositórios privados

Para usar bibliotecas nos repositórios privados, realize as seguintes tarefas:

  • Configure o repositório.
  • Forneça ao composer o segredo para acessar o repositório particular.

O exemplo a seguir mostra como acessar um repositório particular no GitHub.

  1. Configure o repositório em composer.json usando vcs para o tipo:

    "repositories": [
        {
            "type": "vcs",
            "url": "https://github.com/username/private_package"
        }
    ]
    
  2. Crie um arquivo chamado auth.json no diretório-raiz do seu projeto:

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

Você consegue o token de autenticação do GitHub na IU administrativa dele.

Veja outro exemplo que mostra como acessar um repositório particular do Bitbucket.

  1. Configure o repositório em composer.json usando vcs para o tipo:

    "repositories": [
        {
            "type": "vcs",
            "url":  "https://bitbucket.org/username/private_git"
        }
    ]
    
  2. Crie um arquivo chamado auth.json no diretório-raiz do seu projeto:

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