使用 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 平台。

PHP 8.1 on Amazon Linux 2 注意事項

如果使用的是 PHP 8.1 on 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

設定您的 PHP 環境

您可以使用 Elastic Beanstalk 主控台來啟用至 Amazon S3 的日誌輪換，設定您的應用程式可以從環境讀取的變數，並變更 PHP 設定。

PHP 設定

日誌選項

Log Options (日誌選項) 區段有兩個設定：

靜態檔案

為改善效能，您可以使用 Static files (靜態檔案) 區段來設定代理伺服器，以為來自 Web 應用程式一組目錄中的靜態檔案 (例如 HTML 或影像) 提供服務。對於每個目錄，您可以設定目錄映射的虛擬路徑。代理伺服器收到位於指定路徑下的檔案請求時，會直接提供檔案而非將請求路由至您的應用程式。

如需使用組態檔案或 Elastic Beanstalk 主控台設定靜態檔案的詳細資訊，請參閱提供靜態檔案。

環境屬性

Environment Properties (環境屬性) 的部分可讓您針對執行您應用程式的 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來設定組態選項。如需更多資訊，請參閱組態選項。