Usar a plataforma PHP do Elastic Beanstalk

O AWS Elastic Beanstalk fornece e suporta várias ramificações de plataforma para diferentes versões do PHP. As plataformas são compatíveis com aplicações web PHP que funcionam de forma independente ou sob o Composer. Consulte PHP no documento Plataformas do AWS Elastic Beanstalk para uma lista completa de ramificações de plataforma compatíveis.

O Elastic Beanstalk fornece opções de configuração que podem ser usadas para personalizar o software que é executado nas instâncias do Amazon EC2 no ambiente do Elastic Beanstalk. É possível configurar as variáveis de ambiente necessárias à sua aplicação, habilitar a alternância de log para o Amazon S3, mapear pastas na origem da aplicação que contenham arquivos estáticos para caminhos servidos pelo servidor de proxy e definir configurações de inicialização comuns do PHP.

As opções de configuração estão disponíveis no console do Elastic Beanstalk para modificar a configuração de um ambiente em execução. Para evitar a perda da configuração do ambiente quando você terminá-la, você pode usar configurações salvas para salvar as configurações e depois aplicá-las a outro ambiente.

Para salvar as configurações no código-fonte, você pode incluir arquivos de configuração. As definições em arquivos de configuração são aplicadas sempre que você cria um ambiente ou implementa a aplicação. Você também pode usar arquivos de configuração para instalar pacotes, executar scripts e realizar outras operações de personalização da instância em implantações.

Se você usa o Composer, pode incluir um arquivo composer.json em seu pacote de origem para instalar pacotes durante a implantação.

Para configuração avançada de PHP e definições de PHP que não são fornecidos como opções de configuração, é possível usar arquivos de configuração para fornecer um arquivo INIque pode estender e substituir as configurações padrão aplicadas pelo Elastic Beanstalk ou instalar extensões adicionais.

As configurações aplicadas no console do Elastic Beanstalk substituem as mesmas configurações em arquivos de configuração, caso elas existam. Isso permite que você tenha configurações padrão em arquivos de configuração e as substitua por configurações específicas de ambiente no console. Para obter mais informações sobre precedência e outros métodos de alteração das configurações, consulte Opções de configuração.

Para obter detalhes sobre as várias maneiras de estender uma plataforma do Elastic Beanstalk baseada em Linux, consulte Estender as plataformas Linux do Elastic Beanstalk.

Instalação do AWS SDK for PHP

Se você precisa gerenciar os recursos da AWS a partir de sua aplicação, instale o AWS SDK para PHP. Por exemplo, com o SDK for PHP, é possível usar o Amazon DynamoDB (DynamoDB) para armazenar informações de usuário e sessão sem criar um banco de dados relacional.

Para instalar o SDK for PHP com o Composer

$ composer require aws/aws-sdk-php

Para obter mais informações, consulte a página inicial do AWS SDK for PHP. Para obter instruções, consulte Instalar o AWS SDK for PHP.

Considerações sobre o PHP 8.1 no Amazon Linux 2

Leia esta seção se você estiver usando a ramificação da plataforma PHP 8.1 no Amazon Linux 2.

$rpm -i /opt/elasticbeanstalk/RPMS/php-debuginfo-8.1.8-1.amzn2.x86_64.rpm

$pecl install memcache

$pear install pecl/memcache

$pecl install redis

$pear install pecl/redis

Configurar seu ambiente PHP

É possível usar o console do Elastic Beanstalk para habilitar a alternância de logs para o Amazon S3, configurar variáveis que a aplicação pode ler no ambiente e alterar as configurações do PHP.

Configurações de PHP

Opções de log

A seção Log Options tem duas configurações:

Arquivos estáticos

Para melhorar a performance, você pode usar a seção Static files (Arquivos estáticos) para configurar o servidor proxy para servir arquivos estáticos (por exemplo, HTML ou imagens) de um conjunto de diretórios dentro da aplicação Web. Defina, para cada diretório, o caminho virtual para mapeamento de diretórios. Quando o servidor de proxy recebe uma solicitação para um arquivo no caminho especificado, ele atende o arquivo diretamente em vez de rotear solicitação para seu aplicativo.

Para ver detalhes sobre como configurar arquivos estáticos usando arquivos de configuração ou o console do Elastic Beanstalk, consulte Fornecer arquivos estáticos.

Propriedades de ambiente

A seção Environment Properties permite que você especifique definições de configuração do ambiente nas instâncias do Amazon EC2 que estão executando seu aplicativo. Essas definições são passadas para o aplicativo como pares de chave-valor.

Seu código de aplicativo pode acessar propriedades de ambiente usando $_SERVER ou a função get_cfg_var.

$endpoint = $_SERVER['API_ENDPOINT'];

Consulte Variáveis de ambiente e outras configurações de software para obter mais informações.

Namespaces para configuração

Você pode usar um arquivo de configuração para definir opções de configuração e executar outras tarefas de configuração de instância durante implantações. Opções de configuração podem ser específicas da plataforma ou aplicáveis a todas as plataformas no serviço Elastic Beanstalk como um todo. As opções de configuração são organizadas em namespaces.

Os namespaces a seguir configuram seu serviço de proxy e opções específicas do PHP:

O exemplo de arquivo de configuração a seguir especifica uma opção de arquivos estáticos que mapeia um diretório chamado staticimages para o caminho /images, e mostra as configurações para cada uma das opções disponíveis no namespace aws:elasticbeanstalk:container:php:phpini:

option_settings:
  aws:elasticbeanstalk:environment:proxy:
    ProxyServer: apache
  aws:elasticbeanstalk:environment:proxy:staticfiles:
    /images: staticimages
  aws:elasticbeanstalk:container:php:phpini:
    document_root: /public
    memory_limit: 128M
    zlib.output_compression: "Off"
    allow_url_fopen: "On"
    display_errors: "Off"
    max_execution_time: 60
    composer_options: vendor/package

O Elastic Beanstalk oferece muitas opções de configuração para personalizar o ambiente. Além de arquivos de configuração, você também pode definir opções de configuração usando o console, configurações salvas, a EB CLI ou a AWS CLI. Consulte Opções de configuração para obter mais informações.

Instalar dependências da aplicação PHP do Elastic Beanstalk

Este tópico descreve como configurar a aplicação para instalar outros pacotes PHP necessários. Seu aplicativo pode ter dependências em outros pacotes PHP. É possível configurar a aplicação para instalar essas dependências nas instâncias do Amazon Elastic Compute Cloud (Amazon EC2) do ambiente. Como alternativa, você pode incluir as dependências do aplicativo no pacote de origem e implantá-las com o aplicativo. A seção a seguir discute cada uma dessas maneiras.

Usar um arquivo do Composer para instalar dependências em instâncias

Use um arquivo composer.json na raiz da origem de seu projeto para usar o Composer para instalar os pacotes exigidos pela aplicação nas instâncias do Amazon EC2 do ambiente.

{
    "require": {
        "monolog/monolog": "1.0.*"
    }
}

Quando um arquivo composer.json está presente, o Elastic Beanstalk executa composer.phar install para instalar dependências. Você pode adicionar opções para acrescentar ao comando definindo a opção composer_options no namespace aws:elasticbeanstalk:container:php:phpini.

Incluir dependências no pacote de origem

Se o seu aplicativo tiver um grande número de dependências, sua instalação poderá demorar muito tempo. Isso pode aumentar a implantação e as operações de escalabilidade, porque as dependências são instaladas em cada nova instância.

Para evitar o impacto negativo no momento da implantação, use o Composer em seu ambiente de desenvolvimento para resolver dependências e instalá-las na pasta vendor.

Quando o Elastic Beanstalk encontra uma pasta vendor na instância, ele ignora o arquivo composer.json (mesmo se ele existir). O aplicativo usa as dependências da pasta vendor.

Atualizar o Composer no Elastic Beanstalk

Este tópico descreve como configurar o Elastic Beanstalk para manter o Composer atualizado. Talvez seja necessário atualizar o Composer se você vir um erro ao tentar instalar pacotes com um arquivo do Composer ou se não conseguir usar a versão mais recente da plataforma. Entre as atualizações da plataforma, você pode atualizar o Composer em suas instâncias de ambiente por meio do uso de arquivos de configuração na pasta .ebextensions.

É possível atualizar o Composer com a seguinte configuração.

commands:
  01updateComposer:
    command: /usr/bin/composer.phar self-update 2.7.0

A configuração de opção a seguir define a variável de ambiente COMPOSER_HOME, que configura o local do cache do Composer.

option_settings:
  - namespace: aws:elasticbeanstalk:application:environment
    option_name: COMPOSER_HOME
    value: /home/webapp/composer-home

É possível combinar ambos no mesmo arquivo de configuração da pasta .ebextensions.

commands:
  01updateComposer:
    command: /usr/bin/composer.phar self-update 2.7.0
    
option_settings:
  - namespace: aws:elasticbeanstalk:application:environment
    option_name: COMPOSER_HOME
    value: /home/webapp/composer-home

Para obter mais informações sobre as Plataformas PHP do Elastic Beanstalk, incluindo a versão do Composer, consulte Versões da plataformas PHP no documento AWS Elastic Beanstalk Platforms (Plataformas do Elastic Beanstalk.

Estender php.ini na sua configuração do Elastic Beanstalk

Use um arquivo de configuração com um bloco files para adicionar um arquivo .ini em /etc/php.d/ nas instâncias em seu ambiente. O arquivo de configuração principal, php.ini, obtém configurações de arquivos nesta pasta em ordem alfabética. Muitas extensões são habilitadas por padrão pelos arquivos nessa pasta.

files:
  "/etc/php.d/99mongo.ini":
    mode: "000755"
    owner: root
    group: root
    content: |
      extension=mongo.so