使用 Elastic Beanstalk PHP 平台

本主题介绍如何在 Elastic Beanstalk 上配置、构建和运行 PHP 应用程序。

AWS Elastic Beanstalk 对于不同版本的 PHP 编程语言支持多个平台分支。这些平台支持可以单独运行或在 Composer 下运行的 PHP Web 应用程序。有关支持的平台分支的完整列表，请参阅 AWS Elastic Beanstalk 平台文档中的 PHP。

Elastic Beanstalk 提供了配置选项，可供您用于自定义在 Elastic Beanstalk 环境中的 EC2 实例上运行的软件。您可配置应用程序所需的环境变量，启用到 Amazon S3 的日志轮换，将应用程序源中包含静态文件的文件夹映射至代理服务器所提供的路径，并设置常见 PHP 初始化设置。

Elastic Beanstalk 控制台中提供了配置选项，可用于修改运行环境的配置。要避免在终止环境时丢失环境配置，可以使用保存的配置来保存您的设置，并在以后将这些设置应用到其他环境。

要保存源代码中的设置，您可以包含配置文件。在您每次创建环境或部署应用程序时，会应用配置文件中的设置。您还可在部署期间使用配置文件来安装程序包、运行脚本以及执行其他实例自定义操作。

如果使用了 Composer，您可以将 composer.json 文件包含在源包中以在部署期间安装程序包。

对于未提供为配置选项的高级 PHP 配置和 PHP 设置，您可以使用配置文件来提供 INI 文件，该文件可扩展并覆盖由 Elastic Beanstalk 应用的默认设置或者安装其他扩展。

在 Elastic Beanstalk 控制台中应用的设置会覆盖配置文件中的相同设置（如果存在）。这让您可以在配置文件中包含默认设置，并使用控制台中的特定环境设置加以覆盖。有关优先顺序和其他设置更改方法的更多信息，请参阅配置选项。

有关扩展 Elastic Beanstalk 基于 Linux 的平台的各种方法的详细信息，请参阅 扩展 Elastic Beanstalk Linux 平台。

Amazon Linux 2 上的 PHP 8.1 注意事项

如果使用的是 Amazon Linux 2 上的 PHP 8.1 平台分支，请阅读本节。

$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

配置 PHP 环境

您可以使用 Elastic Beanstalk 控制台启用到 Amazon S3 的日志轮换，配置应用程序可以从环境中读取的变量以及更改 PHP 设置。

PHP 设置

日志选项

“日志选项”部分有两个设置：

静态文件

为了提高性能，您可以使用 Static files（静态文件）部分配置代理服务器，以便从 Web 应用程序内的一组目录提供静态文件（例如 HTML 或图像）。对于每个目录，您都将虚拟路径设置为目录映射。当代理服务器收到对指定路径下的某个文件的请求时，它将直接提供此文件，而不是将请求路由至您的应用程序。

有关使用配置文件或 Elastic Beanstalk 控制台配置静态文件的详细信息，请参阅 提供静态文件。

环境属性

在环境属性部分，您可以在运行应用程序的 Amazon EC2 实例上指定环境配置设置。这些设置会以密钥值对的方式传递到应用程序。

您的应用程序代码可使用 $_SERVER 或 get_cfg_var 函数来访问环境属性。

$endpoint = $_SERVER['API_ENDPOINT'];

请参阅环境属性和其他软件设置了解更多信息。

配置的命名空间

您可以使用配置文件设置配置选项并在部署期间执行其他实例配置。配置选项可以特定于平台，也可以应用于整个 Elastic Beanstalk 服务中的所有平台。配置选项被组织到命名空间中。

以下命名空间配置您的代理服务和 PHP 特定选项：

以下示例配置文件指定一个静态文件选项，该选项将名为 staticimages 的目录映射到路径 /images，并显示 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

Elastic Beanstalk 提供了许多用于自定义环境的配置选项。除了配置文件之外，您还可使用控制台、保存的配置、EB CLI 或 AWS CLI 来配置选项。参阅 配置选项 了解更多信息。