使用 Elastic Beanstalk PHP 平台

AWS Elastic Beanstalk 為不同版本的 PHP 提供和支援各種平台分支。這些平台支援獨立執行或在 Composer 下執行的 PHP Web 應用程式。如需支援平台分支的完整清單，請參閱AWS Elastic Beanstalk 平台文件中的 PHP。

Elastic Beanstalk 提供組態選項，可讓您自訂在 Elastic Beanstalk 環境中的 Amazon EC2 執行個體上執行的軟體。您可以設定應用程式所需的環境變數，啟用 Amazon S3 的日誌輪換，將包含靜態檔案的應用程式來源中的資料夾映射到代理伺服器提供的路徑，並進行常見 PHP 初始化設定。

Elastic Beanstalk 主控台中提供了修改正在執行環境組態的組態選項。要避免在終止環境的組態時遺失組態，您可以使用已儲存組態來儲存您的設定，並在之後套用至另一個環境。

若要將設定儲存於原始程式碼，您可以包含組態檔案。每次您建立環境或部署應用程式，組態檔案裡的設定就會套用。您也可以使用組態檔案來安裝套件、執行指令碼，並在部署期間執行其他執行個體自訂操作。

若使用 Composer，您可將 composer.json 檔案納入您的原始碼套件，藉此於部署期間安裝套件。

以未做為組態選項提供的進階 PHP 組態和 PHP 設定而言，您可以使用組態檔案來提供 INI 檔案，以此擴展並覆寫 Elastic Beanstalk 套用的預設設定，或以此安裝其他延伸模組。

在 Elastic Beanstalk 主控台中套用的設定會覆寫組態檔案中相同的設定 (如存在)。這可讓您在組態檔案中擁有預設設定，並以主控台的環境專屬設定覆寫之。如需優先順序以及其他變更設定方法的詳細資訊，請參閱組態選項。

如需各種擴充 Elastic Beanstalk Linux 類型平台方式的詳細資訊，請參閱 擴充 Elastic Beanstalk Linux 平台。

安裝適用於 PHP 的 AWS SDK

如果您需要從應用程式中管理 AWS 資源，請安裝 適用於 PHP 的 AWS SDK。例如，透過適用於 PHP 的開發套件，您可以使用 Amazon DynamoDB (DynamoDB) 來存放使用者和工作階段資訊，無須建立關聯式資料庫。

使用 Composer 安裝適用於 PHP 的 SDK

$ composer require aws/aws-sdk-php

如需詳細資訊，請參閱 AWS SDK for PHP 首頁。如需說明，請參閱安裝 AWS SDK for PHP。

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來設定組態選項。如需詳細資訊，請參閱組態選項。

安裝 Elastic Beanstalk PHP 應用程式的相依性

本主題說明如何設定應用程式以安裝其所需的其他 PHP 套件。您的應用程式可能會對其他 PHP 套件有相依性。您可以設定應用程式，以在本環境的 Amazon Elastic Compute Cloud (Amazon EC2) 執行個體上安裝相依性。或者也可以將您應用程式的相依性加到原始碼套件內，再與應用程式一同部署。下節會介紹這兩種方式。

使用 Composer 檔案在執行個體上安裝相依性

請使用您專案來源根目錄內的 composer.json 檔案，使用 Composer 在您環境的 Amazon EC2 執行個體上安裝您應用程式所需的套件。

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

當 composer.json 檔案存在時，Elastic Beanstalk 會執行 composer.phar install 來安裝相依性。您可於 aws:elasticbeanstalk:container:php:phpini 命名空間設定 composer_options 選項，藉此新增附加命令的選項。

在原始碼套件中加入相依性

如果您的應用程式擁有相當大量的相依性，安裝過程可能會花上相當長的時間。如此會增加部署和擴展方面的操作，因為每個新的執行個體上都要安裝相依性。

若要避免影響到部署時間，請在您的開發環境中使用 Composer 來解決相依性的問題，並將相依性安裝到 vendor 資料夾。

當 Elastic Beanstalk 找到執行個體上的 vendor 資料夾時，會忽略 composer.json 檔案 (即使存在)。接著您的應用程式會使用來自 vendor 資料夾的相依性。

在 Elastic Beanstalk 上更新 Composer

本主題說明如何設定 Elastic Beanstalk 讓 Composer 保持在最新狀態。如果您在嘗試使用 Composer 檔案安裝套件時遇到錯誤，或者無法使用最新的平台版本，則可能需要更新 Composer。在平台更新之間，您可以透過在 .ebextensions 資料夾中使用組態檔案來更新環境執行個體中的 Composer。

您可以使用下列組態來自行更新 Composer。

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

下列選項設定會設定COMPOSER_HOME環境變數，以設定 Composer 快取的位置。

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

您可以在.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

如需 Elastic Beanstalk PHP 平台的詳細資訊，包括 Composer 版本，請參閱文件《AWS Elastic Beanstalk 平台》中的 PHP 平台版本。

在 Elastic Beanstalk 組態中擴展 php.ini

使用帶有 files 區塊的組態檔案，將 .ini 檔案新增至您環境執行個體上的 /etc/php.d/。主要的組態檔案 php.ini，會自此資料夾依字母順序提取檔案的設定。此資料夾內的檔案預設會啟用許多延伸模組。

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