Guia de início rápido para PHP 7 no ambiente padrão

ID da região

O REGION_ID é um código abreviado que o Google atribui com base na região que você selecionou ao criar o aplicativo. O código não corresponde a um país ou estado, ainda que alguns IDs de região sejam semelhantes aos códigos de país e estado geralmente usados. A inclusão de REGION_ID.r em URLs do App Engine é opcional para aplicativos atuais. Em breve, será necessária para todos os aplicativos novos.

Para garantir uma transição tranquila, estamos atualizando o App Engine gradativamente para usar IDs de região. Se ainda não tivermos atualizado seu projeto do Google Cloud, você não verá um ID da região para o app. Como o ID é opcional para os apps atuais, não é necessário atualizar os URLs ou fazer outras alterações quando o ID da região está disponível para eles.

Saiba mais sobre IDs de região.

Nesta página, você aprenderá a implantar um aplicativo básico do App Engine que exibe uma mensagem curta. Para ver uma introdução mais detalhada sobre o PHP no App Engine, consulte Como criar um aplicativo.

O App Engine é a opção de computação certa para você? Veja outras opções para hospedar seu aplicativo no Google Cloud.

Custos

Não há custos associados à execução deste guia. A execução deste aplicativo de amostra não excede sua cota gratuita.

Antes de começar

Antes de executar e implantar este guia de início rápido, instale o SDK do Cloud e configure um projeto do Cloud para o App Engine:

Faça o download e instale o SDK do Cloud:
Fazer o download do SDK
Observação: se o SDK do Cloud já estiver instalado, atualize-o executando o comando a seguir:
```
gcloud components update
```
Crie um novo projeto:
```
gcloud projects create [YOUR_PROJECT_ID] --set-as-default
```
Substitua [YOUR_PROJECT_ID] por uma string de caracteres que identifique seu projeto de maneira exclusiva. Por exemplo, my-project-24.

A sinalização --set-as-default define o novo projeto como o padrão usado por gcloud.

Verifique se o projeto foi criado:
```
gcloud projects describe [YOUR_PROJECT_ID]
```
Você verá detalhes do projeto parecidos com o seguinte:
```
createTime: year-month-hour
lifecycleState: ACTIVE
name: project-name
parent:
  id: '433637338589'
  type: organization
projectId: project-name-id
projectNumber: 499227785679
```
Inicialize seu aplicativo do App Engine com o projeto e escolha a região:
```
gcloud app create --project=[YOUR_PROJECT_ID]
```
Quando solicitado, selecione a região em que o aplicativo do App Engine estará localizado.

Cuidado: não é possível alterar a região de um aplicativo depois de defini-la.
Verifique se o faturamento está ativado no projeto. Uma conta de faturamento precisa estar vinculada ao projeto para que o aplicativo seja implantado no App Engine.

Ativar faturamento

Observação: a execução desse aplicativo de amostra não excede a cota gratuita.
Instale os seguintes pré-requisitos:
- Fazer o download e instalar o Git.
- Instale uma versão do PHP 7 que seja compatível com o ambiente de execução do PHP 7.
- Para gerenciar dependências, faça o download do Composer. Em seguida, verifique se o executável dele foi instalado globalmente.

Locais do App Engine

O App Engine é regional. Isso significa que a infraestrutura que executa os aplicativos está em uma determinada região que é gerenciada pelo Google para estar disponível de modo redundante em todas as zonas dessa região.

Atender aos requisitos de latência, disponibilidade ou durabilidade são os principais fatores para selecionar a região de execução dos aplicativos. Geralmente, é possível selecionar a região mais próxima dos usuários do aplicativo, mas considere os locais em que o App Engine está disponível, bem como os locais dos outros produtos e serviços do Google Cloud usados pelo app. O uso de serviços em vários locais pode afetar a latência e o preço do aplicativo.

Não é possível alterar a região de um aplicativo depois de defini-la.

Se você já criou um aplicativo do App Engine, será possível ver a região dele com um dos seguintes procedimentos:

Execute o comando gcloud app describe.
Abra o Painel do App Engine no Console do Cloud. A região aparece perto do topo da página.

Este guia de início rápido parte do princípio de que você já conhece a linguagem de programação PHP.

Fazer o download do app Hello World

Criamos um aplicativo Hello World para PHP. Com ele, você tem uma ideia rápida da implantação de um aplicativo no Google Cloud Platform. Siga estas etapas para fazer o download do Hello World na máquina local.

Clone o repositório do app de amostra Hello World na máquina local.
```
git clone https://github.com/GoogleCloudPlatform/php-docs-samples.git
```
Se preferir, faça o download da amostra como um arquivo zip e o extraia.
Acesse o diretório que contém o código de amostra.
```
cd php-docs-samples/appengine/standard/helloworld
```

Como implantar o Hello World no App Engine

Implante o aplicativo Hello World no App Engine executando o seguinte comando no diretório php-docs-samples/appengine/standard/helloworld:
```
gcloud app deploy
```
Veja o aplicativo ativo em https://PROJECT_ID.REGION_ID.r.appspot.com:
```
gcloud app browse
```

Agora a mensagem Hello, world! será enviada por um servidor da Web executado em uma instância do App Engine.

Parabéns! Você acabou de implantar um serviço da Web do PHP no App Engine!

Limpeza

Se você quiser continuar aprendendo sobre o App Engine, armazene seu projeto do Cloud e acompanhe Como criar um aplicativo.

Como alternativa, é possível excluir seu projeto do Cloud para interromper o faturamento de todos os recursos usados nesse projeto.

No Console do Cloud, acesse a página Gerenciar recursos:
Acessar "Gerenciar recursos"
Na lista de projetos, selecione o projeto que você quer excluir e clique em Excluir .
Na caixa de diálogo, digite o ID do projeto e clique em Encerrar para excluí-lo.

A seguir

Agora que você já sabe implantar um serviço da Web no App Engine, consulte Como criar um aplicativo para ver uma introdução mais detalhada sobre o PHP no App Engine.