As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# QuickStart: Implante um aplicativo PHP no Elastic Beanstalk
<a name="php-quickstart"></a>

No tutorial a seguir, você aprenderá a criar e implantar um aplicativo PHP de amostra em um AWS Elastic Beanstalk ambiente usando o EB CLI.

**Não é para uso em produção**  
Os exemplos são destinados apenas para demonstração. Não use aplicações de exemplo na produção.

**Topics**
+ [Sua AWS conta](#php-quickstart-aws-account)
+ [Pré-requisitos](#php-quickstart-prereq)
+ [Etapa 1: criar uma aplicação PHP](#php-quickstart-create-app)
+ [Etapa 2: executar a aplicação localmente](#php-quickstart-run-local)
+ [Etapa 3: inicializar e implantar sua aplicação PHP](#php-quickstart-deploy)
+ [Etapa 4: navegar pela sua aplicação em nuvem](#php-quickstart-run-eb-ap)
+ [Etapa 5: atualizar e reimplantar seu aplicativo](#php-quickstart-run-eb-ap)
+ [Limpeza](#php-quickstart-cleanup)
+ [Próximas etapas](#php-quickstart-next-steps)

## Sua AWS conta
<a name="php-quickstart-aws-account"></a>

Se você ainda não é AWS cliente, precisa criar uma AWS conta para usar o Elastic Beanstalk.

### Crie uma AWS conta
<a name="php-quickstart-aws-account-procedure"></a>

#### Inscreva-se para um Conta da AWS
<a name="sign-up-for-aws"></a>

Se você não tiver um Conta da AWS, conclua as etapas a seguir para criar um.

**Para se inscrever em um Conta da AWS**

1. Abra a [https://portal.aws.amazon.com/billing/inscrição.](https://portal.aws.amazon.com/billing/signup)

1. Siga as instruções online.

   Parte do procedimento de inscrição envolve receber uma chamada telefônica ou uma mensagem de texto e inserir um código de verificação pelo teclado do telefone.

   Quando você se inscreve em um Conta da AWS, um *Usuário raiz da conta da AWS*é criado. O usuário-raiz tem acesso a todos os Serviços da AWS e recursos na conta. Como prática recomendada de segurança, atribua o acesso administrativo a um usuário e use somente o usuário-raiz para executar [tarefas que exigem acesso de usuário-raiz](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_root-user.html#root-user-tasks).

AWS envia um e-mail de confirmação após a conclusão do processo de inscrição. A qualquer momento, você pode visualizar a atividade atual da sua conta e gerenciar sua conta acessando [https://aws.amazon.com/e](https://aws.amazon.com/) escolhendo **Minha conta**.

#### Criar um usuário com acesso administrativo
<a name="create-an-admin"></a>

Depois de se inscrever em um Conta da AWS, proteja seu Usuário raiz da conta da AWS Centro de Identidade do AWS IAM, habilite e crie um usuário administrativo para que você não use o usuário root nas tarefas diárias.

**Proteja seu Usuário raiz da conta da AWS**

1.  Faça login [Console de gerenciamento da AWS](https://console.aws.amazon.com/)como proprietário da conta escolhendo **Usuário raiz** e inserindo seu endereço de Conta da AWS e-mail. Na próxima página, insira a senha.

   Para obter ajuda ao fazer login usando o usuário-raiz, consulte [Fazer login como usuário-raiz](https://docs.aws.amazon.com/signin/latest/userguide/console-sign-in-tutorials.html#introduction-to-root-user-sign-in-tutorial) no *Guia do usuário do Início de Sessão da AWS *.

1. Habilite a autenticação multifator (MFA) para o usuário-raiz.

   Para obter instruções, consulte [Habilitar um dispositivo de MFA virtual para seu usuário Conta da AWS raiz (console) no Guia](https://docs.aws.amazon.com/IAM/latest/UserGuide/enable-virt-mfa-for-root.html) do *usuário do IAM*.

**Criar um usuário com acesso administrativo**

1. Habilita o Centro de Identidade do IAM.

   Para obter instruções, consulte [Habilitar o Centro de Identidade do AWS IAM](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-set-up-for-idc.html) no *Guia do usuário do Centro de Identidade do AWS IAM *.

1. No Centro de Identidade do IAM, conceda o acesso administrativo a um usuário.

   Para ver um tutorial sobre como usar o Diretório do Centro de Identidade do IAM como fonte de identidade, consulte [Configurar o acesso do usuário com o padrão Diretório do Centro de Identidade do IAM](https://docs.aws.amazon.com//singlesignon/latest/userguide/quick-start-default-idc.html) no *Guia Centro de Identidade do AWS IAM do usuário*.

**Iniciar sessão como o usuário com acesso administrativo**
+ Para fazer login com o seu usuário do Centro de Identidade do IAM, use o URL de login enviado ao seu endereço de e-mail quando o usuário do Centro de Identidade do IAM foi criado.

  Para obter ajuda para fazer login usando um usuário do IAM Identity Center, consulte Como [fazer login no portal de AWS acesso](https://docs.aws.amazon.com/signin/latest/userguide/iam-id-center-sign-in-tutorial.html) no *Guia Início de Sessão da AWS do usuário*.

**Atribuir acesso a usuários adicionais**

1. No Centro de Identidade do IAM, crie um conjunto de permissões que siga as práticas recomendadas de aplicação de permissões com privilégio mínimo.

   Para obter instruções, consulte [Criar um conjunto de permissões](https://docs.aws.amazon.com//singlesignon/latest/userguide/get-started-create-a-permission-set.html) no *Guia do usuário do Centro de Identidade do AWS IAM *.

1. Atribua usuários a um grupo e, em seguida, atribua o acesso de logon único ao grupo.

   Para obter instruções, consulte [Adicionar grupos](https://docs.aws.amazon.com//singlesignon/latest/userguide/addgroups.html) no *Guia do usuário do Centro de Identidade do AWS IAM *.

## Pré-requisitos
<a name="php-quickstart-prereq"></a>
+ Interface de linha de comando do Elastic Beanstalk - Para instalação, consulte [Instalar a EB CLI com script de configuração (recomendado)](eb-cli3.md#eb-cli3-install).
+ PHP: instale o PHP na sua máquina local seguindo estas instruções de [Instalação e configuração](https://www.php.net/manual/en/install.php) no site do PHP.

## Etapa 1: criar uma aplicação PHP
<a name="php-quickstart-create-app"></a>

Para esse início rápido, você criará uma aplicação PHP *Hello World*.

Crie um diretório do projeto.

```
~$ mkdir eb-php
~$ cd eb-php
```

Em seguida, crie um arquivo `index.php` no diretório do projeto e adicione o seguinte código.

**Example `index.php`**  

```
<?php
  echo "Hello from a PHP application running in Elastic Beanstalk!";
?>
```

## Etapa 2: executar a aplicação localmente
<a name="php-quickstart-run-local"></a>

Use o seguinte comando para executar sua aplicação localmente.

```
~$ php -S localhost:5000
```

Abra um navegador para [http://localhost:5000](http://localhost:5000).

Você deve ver sua mensagem de saudação no navegador e as mensagens de log no terminal.

Pare o servidor local inserindo `Control+c`, para que você possa implantar o Elastic Beanstalk.

## Etapa 3: inicializar e implantar sua aplicação PHP
<a name="php-quickstart-deploy"></a>

Em seguida, você implantará sua aplicação em um *ambiente* usando o console do Elastic Beanstalk ou a EB CLI. Neste tutorial, você usará a EB CLI com a opção interativa para inicializar um ambiente. 

**Para inicializar o ambiente e criar um ambiente**

1. Execute o seguinte comando **init**.

   ```
   ~$ eb init -i
   ```

   O comando init cria uma aplicação de maneira interativa. O nome da aplicação será padronizado para a pasta local, que é `eb-php`.

   Para todos os prompts, exceto o acesso via SSH, aceite os padrões para criar um ambiente com a versão mais recente da plataforma PHP. Para solucionar problemas de instâncias, você pode configurar o acesso SSH executando novamente o comando `eb init -i` mais tarde ou pode conectar-se usando o Amazon EC2 Instance Connect ou o Session Manager.

1. Criar um ambiente se implantar seu aplicativo

   Execute o seguinte comando para criar um ambiente chamado `blue-env`.

   ```
   ~$ eb create blue-env
   ```

   Quando o comando **eb create** é executado pela primeira vez, o Elastic Beanstalk cria automaticamente um arquivo zip da sua aplicação, chamado de *pacote de origem*. Em seguida, o Elastic Beanstalk cria um ambiente com uma ou mais instâncias do Amazon EC2 e, em seguida, implanta a aplicação no ambiente.

   A implantação do sua aplicação no Elastic Beanstalk pode levar até cinco minutos.

## Etapa 4: navegar pela sua aplicação em nuvem
<a name="php-quickstart-run-eb-ap"></a>

Quando o processo de criação do ambiente for concluído, a aplicação deverá estar em execução e recepcionando solicitações na porta 5000. Conecte-se à sua aplicação com o seguinte comando:

```
~$ eb open
```

O comando `eb open` abre uma guia do navegador para um subdomínio personalizado criado para a aplicação.

## Etapa 5: atualizar e reimplantar seu aplicativo
<a name="php-quickstart-run-eb-ap"></a>

Depois de criar uma aplicação e implantá-la em um ambiente, você pode realizar a implantação de uma nova versão da aplicação ou de uma aplicação diferente a qualquer momento. A implantação de uma nova versão da aplicação é mais rápida, pois não é necessário provisionar nem reiniciar as instâncias do Amazon EC2.

Atualize seu código PHP para incluir o valor REQUEST\$1TIME do ambiente do servidor:

```
<?php
  echo "Hello from a PHP application running in Elastic Beanstalk!";
  
  $timestamp = $_SERVER['REQUEST_TIME'];
  echo '<br/>Request time: ' . date('Y/m/d H:i:s', $timestamp);
?>
```

Reimplante seu código PHP no Elastic Beanstalk com este comando:

```
~$ eb deploy
```

Quando você executa **eb deploy**, a EB CLI empacota o conteúdo do diretório do projeto e implanta-o em seu ambiente.

Após a conclusão da implantação, atualize a página ou reconecte-se à sua aplicação com `eb open`. Você verá suas atualizações. Caso contrário, solucione o problema executando seu servidor local novamente para verificar suas alterações.

****Parabéns\$1****  
Você criou, realizou a implantação e atualizou uma aplicação PHP com o Elastic Beanstalk\$1

## Limpeza
<a name="php-quickstart-cleanup"></a>

Depois de terminar de trabalhar com o código de demonstração, você pode encerrar seu ambiente. [O Elastic Beanstalk exclui AWS todos os recursos relacionados, como instâncias do [Amazon EC2, instâncias de banco de dados, balanceadores](using-features.managing.ec2.md)[de carga, grupos](using-features.managing.db.md) de segurança e [alarmes](using-features.managing.elb.md).](using-features.alarms.md#using-features.alarms.title) 

Como a remoção de recursos não exclui a aplicação Elastic Beanstalk, é possível criar ambientes para a aplicação a qualquer momento.

**Para encerrar seu ambiente Elastic Beanstalk do console**

1. Abra o console do [Elastic](https://console.aws.amazon.com/elasticbeanstalk) Beanstalk e, **na** lista Regiões, selecione sua. Região da AWS

1. No painel de navegação, selecione **Ambientes** e selecione o nome do ambiente na lista.

1. Escolha **Actions** (Ações) e depois **Terminate Environment** (Encerrar ambiente).

1. Use a caixa de diálogo na tela para confirmar o encerramento do ambiente.

Outra alternativa é encerrar seu ambiente com a EB CLI com o seguinte comando:

```
~$ eb terminate
```

## Próximas etapas
<a name="php-quickstart-next-steps"></a>

Você pode explorar seu ambiente de aplicação usando o console do Elastic Beanstalk. Para obter mais informações, consulte [Explorar seu ambiente](GettingStarted.md#GettingStarted.Explore).

Para exemplos avançados usando PHP, consulte [Exemplos avançados de PHP no Elastic Beanstalk](php-samples.md).