Usar a plataforma PHP do Elastic Beanstalk - AWS Elastic Beanstalk
Considerações sobre o PHP 8.1 no Amazon Linux 2Configurar seu ambiente PHPO namespace aws:elasticbeanstalk:container:php:phpini

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á.

Usar a plataforma PHP do Elastic Beanstalk

AWS Elastic Beanstalk suporta várias plataformas para diferentes versões da linguagem de programação PHP. Essas plataformas oferecem suporte a aplicativos web em PHP que podem ser executados sozinhos ou sob o Composer. Saiba mais em PHP no documento Plataformas doAWS Elastic Beanstalk .

O Elastic Beanstalk fornece opções de configuração que podem ser usadas para personalizar o software que é executado nas instâncias do 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.

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.

nota

As informações neste tópico somente são aplicáveis a ramificações de plataforma com base na Amazon Linux AMI (AL1). Não se aplica às ramificações da plataforma PHP com base no AL2023. Também não se aplica aoPHP 8.0 Amazon Linux 2filial da plataforma.

O Elastic Beanstalk armazena os pacotes RPM relacionados ao PHP 8.1 para oPHP 8.1 no Amazon Linux 2ramificação da plataforma nas instâncias do EC2 em um diretório local, em vez do repositório Amazon Linux. Você pode usar rpm -i para instalar os pacotes necessários. A partir da versão 3.5.0 da plataforma PHP 8.1, o Elastic Beanstalk armazena os pacotes RPM relacionados à PHP 8.1 no diretório local do EC2 a seguir.

/opt/elasticbeanstalk/RPMS

O exemplo a seguir instala o pacote php-debuginfo.

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

A versão no nome do pacote variará de acordo com a versão real listada no diretório local do EC2 /opt/elasticbeanstalk/RPMS. Use a mesma sintaxe para instalar outros pacotes RPM da plataforma PHP 8.1.

Expanda a seção a seguir para exibir uma lista dos pacotes RPM que fornecemos.

A lista a seguir fornece os pacotes RMP que a plataforma PHP 8.1 do Elastic Beanstalk fornece no Amazon Linux 2. Eles ficam localizados no diretório local /opt/elasticbeanstalk/RPMS.

Os números de versão 8.1.8-1 e 3.7.0-1 nos nomes dos pacotes listados são apenas um exemplo.

  • php-8.1.8-1.amzn2.x86_64.rpm

  • php-bcmath-8.1.8-1.amzn2.x86_64.rpm

  • php-cli-8.1.8-1.amzn2.x86_64.rpm

  • php-common-8.1.8-1.amzn2.x86_64.rpm

  • php-dba-8.1.8-1.amzn2.x86_64.rpm

  • php-dbg-8.1.8-1.amzn2.x86_64.rpm

  • php-debuginfo-8.1.8-1.amzn2.x86_64.rpm

  • php-devel-8.1.8-1.amzn2.x86_64.rpm

  • php-embedded-8.1.8-1.amzn2.x86_64.rpm

  • php-enchant-8.1.8-1.amzn2.x86_64.rpm

  • php-fpm-8.1.8-1.amzn2.x86_64.rpm

  • php-gd-8.1.8-1.amzn2.x86_64.rpm

  • php-gmp-8.1.8-1.amzn2.x86_64.rpm

  • php-intl-8.1.8-1.amzn2.x86_64.rpm

  • php-ldap-8.1.8-1.amzn2.x86_64.rpm

  • php-mbstring-8.1.8-1.amzn2.x86_64.rpm

  • php-mysqlnd-8.1.8-1.amzn2.x86_64.rpm

  • php-odbc-8.1.8-1.amzn2.x86_64.rpm

  • php-opcache-8.1.8-1.amzn2.x86_64.rpm

  • php-pdo-8.1.8-1.amzn2.x86_64.rpm

  • php-pear-1.10.13-1.amzn2.noarch.rpm

  • php-pgsql-8.1.8-1.amzn2.x86_64.rpm

  • php-process-8.1.8-1.amzn2.x86_64.rpm

  • php-pspell-8.1.8-1.amzn2.x86_64.rpm

  • php-snmp-8.1.8-1.amzn2.x86_64.rpm

  • php-soap-8.1.8-1.amzn2.x86_64.rpm

  • php-sodium-8.1.8-1.amzn2.x86_64.rpm

  • php-xml-8.1.8-1.amzn2.x86_64.rpm

  • php-pecl-imagick-3.7.0-1.amzn2.x86_64.rpm

  • php-pecl-imagick-debuginfo-3.7.0-1.amzn2.x86_64.rpm

  • php-pecl-imagick-devel-3.7.0-1.amzn2.noarch.rpm

Você pode usar os pacotes PEAR e PECL para instalar extensões comuns. Para obter mais informações sobre o PEAR, consulte o site PEAR PHP Extension and Application Repository (Repositório de extensão e aplicação do PEAR PHP). Para obter mais informações sobre o PECL, consulte o site de extensões PECL.

Os exemplos de comandos a seguir instalam as extensões Memcached.

$pecl install memcache

Ou você também pode usar o seguinte:

$pear install pecl/memcache

Os exemplos de comando a seguir instalam as extensões Redis.

$pecl install redis

Ou você também pode usar o seguinte:

$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.

Como configurar seu ambiente PHP no console do Elastic Beanstalk

  1. Abra o console do Elastic Beanstalk e, na lista Regiões, selecione sua. Região da AWS

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

    nota

    Se você tiver muitos ambientes, use a barra de pesquisa para filtrar a lista de ambientes.

  3. No painel de navegação, escolha Configuration (Configuração).

  4. Na categoria de configuração Updates, monitoring, and logging (Atualizações, monitoramento e logs), escolha Edit (Editar).

Configurações de PHP

  • Proxy server (Servidor de proxy): o servidor de proxy a ser usado nas instâncias de ambiente. Por padrão, é usado nginx.

  • Document root (Raiz do documento): a pasta que contém a página padrão do site. Se a sua página de boas-vindas não estiver na raiz do pacote de origem, especifique a pasta que a contém relativo ao caminho raiz. Por exemplo, /public se a página de boas-vindas estiver em uma pasta chamada public.

  • Memory limite (Limite de memória): a quantidade máxima de memória que um script tem permissão para alocar. Por exemplo, 512M.

  • Zlib output compression (Compactação de saída Zlib): defina como On para compactar respostas.

  • Allow URL fopen (Permitir URL fopen): defina como Off para impedir o download de arquivos de scripts de locais remotos.

  • Display errors (Exibir erros): defina como On para mostrar mensagens de erro interno para depuração.

  • Max execution time (Tempo de execução máximo): o tempo máximo em segundos que um script pode ser executado antes que o ambiente o encerre.

Opções de log

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

  • Instance profile (Perfil da instância): especifica o perfil da instância que tem permissão para acessar o bucket do Amazon S3 associado à sua aplicação.

  • Enable log file rotation to Amazon S3 (Habilitar a rotação de arquivos de log para o Amazon S3): especifica se os arquivos de log das instâncias do Amazon EC2 da aplicação serão copiados para o bucket do Amazon S3 associado a ela.

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 Propriedades de ambientes e outras configurações de software para obter mais informações.

O namespace aws:elasticbeanstalk:container:php:phpini

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. As opções de configuração podem ser definidas pelo serviço Elastic Beanstalk ou pela plataforma utilizada, e são organizadas em namespaces.

Você pode usar o namespace aws:elasticbeanstalk:environment:proxy para escolher o servidor de proxy do ambiente.

É possível usar o namespace aws:elasticbeanstalk:environment:proxy:staticfiles para configurar o proxy de ambiente para servir arquivos estáticos. Defina mapeamentos de caminhos virtuais para diretórios de aplicativos.

A plataforma PHP define opções no namespace aws:elasticbeanstalk:container:php:phpini, inclusive as que não estão disponíveis no console do Elastic Beanstalk. composer_options define opções personalizadas para usar ao instalar dependências com o Composer por meio de composer.phar install. Para obter mais informações, incluindo as opções disponíveis, acesse http://getcomposer.org/doc/03-cli.md#install.

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:

exemplo .ebextensions/php-settings.config
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
nota

O namespace aws:elasticbeanstalk:environment:proxy:staticfiles não está definido nas ramificações da plataforma PHP de AMI do Amazon Linux (anterior ao Amazon Linux 2).

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.