Especificar dependências

Pode declarar dependências para PHP num ficheiro composer.json padrão. Por exemplo:

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

Pode usar qualquer pacote PHP compatível com Linux no App Engine. O tempo de execução procura um ficheiro composer.json no diretório de origem da sua aplicação e usa composer para instalar todas as dependências antes de iniciar a aplicação.

Para obter informações sobre as versões do PHP suportadas neste tempo de execução, consulte O tempo de execução do PHP.

Instalar e executar localmente

Use o composer para instalar as suas dependências localmente:

composer install

Para fixar as dependências à respetiva versão atual, confirme o ficheiro composer.lock na sua aplicação.

Pode testar a sua aplicação através do servidor Web à sua escolha. O ambiente flexível do App Engine usa o NGINX na produção. Para executar rapidamente a sua aplicação, pode usar o servidor Web integrado do PHP.

Instalar uma framework Web

Por predefinição, o NGINX está configurado para publicar todos os pedidos através de index.php. Não é necessário um framework, mas é recomendado. Pode usar qualquer framework Web com os ambientes flexíveis do App Engine, incluindo o seguinte:

Para usar uma framework Web específica, basta adicioná-la a composer.json:

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

Instalar as bibliotecas de cliente da Google Cloud

A biblioteca cliente da Google Cloud para PHP é uma biblioteca cliente para aceder a serviços que reduz o código repetitivo que tem de escrever. Google Cloud A biblioteca oferece abstrações de API de alto nível e fáceis de compreender. Adota expressões idiomáticas do PHP, funciona bem com a biblioteca padrão e tem uma integração mais estreita com a sua base de código. Tudo isto significa que passa mais tempo a criar código que é importante para si.

  1. Instale a biblioteca localmente:

    composer require google/cloud

  2. Pode processar a autenticação localmente através da CLI do Google Cloud. Se quiser que a sua aplicação local use temporariamente as suas próprias credenciais de utilizador para acesso à API, execute o seguinte comando:

    gcloud auth application-default login

    Para ver detalhes sobre a configuração das bibliotecas cliente do Google Cloud para PHP para processar a autenticação automaticamente, consulte o artigo Autentique-se nos serviços Google Cloud através de bibliotecas cliente.

Usar repositórios privados

Para usar bibliotecas em repositórios privados, tem de concluir as seguintes tarefas:

  • Configure o repositório.
  • Dê a composer o segredo para aceder ao repositório privado.

O exemplo seguinte ilustra como aceder a um repositório privado no GitHub.

  1. Configure o repositório no composer.json através de vcs para o tipo:

    "repositories": [
    {
        "type": "vcs",
        "url": "https://github.com/username/private_package"
    }
]

  2. Crie um ficheiro com o nome auth.json no diretório raiz do projeto:

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

Pode obter o token de autorização do GitHub na IU administrativa do GitHub.

Segue-se outro exemplo que ilustra como aceder a um repositório privado para o Bitbucket.

  1. Configure o repositório no composer.json através de vcs para o tipo:

    "repositories": [
    {
        "type": "vcs",
        "url":  "https://bitbucket.org/username/private_git"
    }
]

  2. Crie um ficheiro com o nome auth.json no diretório raiz do projeto:

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