Elastic Beanstalk PHP プラットフォームを使用する - AWS Elastic Beanstalk

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

Elastic Beanstalk PHP プラットフォームを使用する

このトピックでは、Elastic Beanstalk でPHPアプリケーションを設定、構築、実行する方法について説明します。

AWS Elastic Beanstalk は、PHPプログラミング言語のさまざまなバージョンで多数のプラットフォームブランチをサポートしています。これらのプラットフォームは、単独で、または Composer で実行できるPHPウェブアプリケーションをサポートします。のPHP「」を参照してください。 AWS Elastic Beanstalk サポートされているプラットフォームブランチの完全なリストのプラットフォームドキュメント。

Elastic Beanstalk には、Elastic Beanstalk 環境のEC2インスタンスで実行されるソフトウェアをカスタマイズするために使用できる設定オプションが用意されています。アプリケーションに必要な環境変数の設定、Amazon S3 へのログローテーションの有効化、静的ファイルを含むアプリケーションソース内のフォルダのプロキシサーバーが提供するパスへのマッピング、一般的なPHP初期化設定を行うことができます。

設定オプションは実行中の環境の設定を変更するために Elastic Beanstalk コンソールで利用できます。環境を終了したときにその設定が失われないようにするため、保存済み設定を使用して設定を保存し、それを後で他の環境に適用することができます。

ソースコードの設定を保存する場合、設定ファイルを含めることができます。設定ファイルの設定は、環境を作成するたびに、またはアプリケーションをデプロイするたびに適用されます。設定ファイルを使用して、デプロイの間にパッケージをインストールしたり、スクリプトを実行したり、他のインスタンスのカスタマイズオペレーションを実行することもできます。

Composer を使用すると、デプロイの間にパッケージをインストールするために、出典バンドルに composer.json ファイルを含めることができます。

詳細PHP設定およびPHP設定オプションとして指定されていない設定については、設定ファイルを使用して、Elastic Beanstalk によって適用されるデフォルト設定を拡張および上書きできる INI ファイルを提供するか、追加の拡張機能をインストールできます。

Elastic Beanstalk コンソールで適用される設定は、設定ファイルに同じ設定があれば、それらの設定を上書きします。これにより、設定ファイルでデフォルト設定を定義し、コンソールでそのデフォルト設定を環境固有の設定で上書きできます。設定の優先順位の詳細と設定の他の変更方法については、「設定オプション」を参照してください。

Elastic Beanstalk Linux ベースのプラットフォームを拡張するさまざまな方法の詳細については、「Elastic Beanstalk Linux プラットフォームの拡張」を参照してください。

Amazon Linux 2 PHP での 8.1 に関する考慮事項

PHP Amazon Linux 2 プラットフォームブランチで 8.1 を使用している場合は、このセクションをお読みください。

注記

このトピックの情報は、PHPAmazon Linux 2 プラットフォームブランチの 8.1 にのみ適用されます。AL2023 に基づくPHPプラットフォームブランチには適用されません。また、PHP8.0 Amazon Linux 2 プラットフォームブランチにも適用されません。

Elastic Beanstalk はPHP、Amazon Linux 2 プラットフォームブランチの 8.1 関連RPMパッケージを、Amazon Linux リポジトリではなくローカルディレクトリのEC2インスタンスに保存します。 PHP rpm -i を使用してパッケージをインストールできます。PHP 8.1 プラットフォームバージョン 3.5.0 以降、Elastic Beanstalk は PHP 8.1 関連のRPMパッケージを次のローカルEC2ディレクトリに保存します。

/opt/elasticbeanstalk/RPMS

次の例では、 をインストールします。php-debuginfo パッケージ。

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

パッケージ名のバージョンは、EC2ローカルディレクトリ にリストされている実際のバージョンによって異なります/opt/elasticbeanstalk/RPMS。同じ構文を使用して、他の 8.1 PHP RPMパッケージをインストールします。

次のセクションを展開して、提供されているRPMパッケージのリストを表示します。

次のリストは、Elastic Beanstalk 8PHP.1 プラットフォームが Amazon Linux 2 で提供するRMPパッケージを示しています。これらのファイルは、ローカルディレクトリ /opt/elasticbeanstalk/RPMS にあります。

記載されているパッケージ名のバージョン番号 8.1.8-13.7.0-1 はあくまでも一例です。

  • 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

PEAR および PECLパッケージを使用して、一般的な拡張機能をインストールできます。の詳細についてはPEAR、PEARPHP拡張機能とアプリケーションリポジトリのウェブサイトを参照してください。の詳細についてはPECL、拡張機能PECLのウェブサイトを参照してください。

以下のコマンド例では、Memcached 拡張機能をインストールします。

$pecl install memcache

また、以下のコマンドを使用することもできます。

$pear install pecl/memcache

以下のコマンド例では、Redis 拡張機能をインストールします。

$pecl install redis

また、以下のコマンドを使用することもできます。

$pear install pecl/redis

PHP 環境の設定

Elastic Beanstalk コンソールを使用して、Amazon S3 へのログローテーションを有効にし、アプリケーションが環境から読み取ることができる変数を設定し、PHP設定を変更できます。

Elastic Beanstalk コンソールでPHP環境を設定するには
  1. Elastic Beanstalk コンソールを開きリージョンリストで を選択します。 AWS リージョン.

  2. ナビゲーションペインで、[環境] を選択し、リストから環境の名前を選択します。

    注記

    環境が多数ある場合は、検索バーを使用して環境リストをフィルタリングします。

  3. ナビゲーションペインで、[設定] を選択します。

  4. [更新、モニタリング、ログ] の設定カテゴリで、[編集] を選択します。

PHP 設定

  • [プロキシサーバー] – 環境インスタンスで使用するプロキシサーバーです。デフォルトでは、nginx が使用されます。

  • Document root (ドキュメントルート) – サイトのデフォルトページを含むフォルダー。ウェルカムページが、出典バンドルのルートにない場合は、ルートパスに関連して、それを含むフォルダを指定します。たとえば、ウェルカムページが、/public というフォルダにある場合は、public にします。

  • Memory limit (メモリ制限) – スクリプトが割り当て許可される最大メモリ容量。例えば、512M と指定します。

  • Zlib output compression (Zlib 出力の圧縮)On に設定して、レスポンスを圧縮します。

  • URL fopen を許可する – スクリプトがリモートの場所からファイルをダウンロードしないようにOffするには、 に設定します。

  • Display errors (表示エラー)On に設定して、デバッグの内部エラーメッセージを表示します。

  • Max execution time (最大実行時間) – 環境によって終了されるまでの、スクリプトを実行許可される最大時間 (秒単位)。

ログオプション

[ログ Options] セクションには、2 つの設定があります。

  • [Instance profile] – アプリケーションに関連付けられた Amazon S3 バケットへのアクセス許可が付与されているインスタンスプロファイルを指定します。

  • Amazon S3 へのログファイルのローテーションを有効にする – アプリケーションの Amazon EC2インスタンスのログファイルをアプリケーションに関連付けられた Amazon S3 バケットにコピーするかどうかを指定します。

静的ファイル

パフォーマンスを向上させるには、静的ファイル セクションを使用して、ウェブアプリケーション内の一連のディレクトリから静的ファイル ( HTMLやイメージなど) を提供するようにプロキシサーバーを設定できます。ディレクトリごとに、仮想パスをディレクトリマッピングに設定します。プロキシサーバーは、指定されたパスのファイルに対するリクエストを受け取ると、アプリケーションにリクエストをルーティングする代わりにファイルを直接  処理します。

設定ファイルまたは、Elastic Beanstalk コンソールを使用した静的ファイルの設定の詳細については、「静的ファイルの提供」を参照してください。

環境プロパティ

環境プロパティセクションでは、アプリケーションを実行している Amazon EC2インスタンスで環境設定を指定できます。これらの設定は、キーバリューのペアでアプリケーションに渡されます。

アプリケーションコードは、$_SERVER または get_cfg_var 関数を使用して環境プロパティにアクセスできます。

$endpoint = $_SERVER['API_ENDPOINT'];

詳細については、「環境プロパティとその他のソフトウェアの設定」を参照してください。

設定の名前空間

設定ファイルを使用して、設定オプションを設定し、デプロイの間、他のインスタンス設定タスクをパフォーマンスできます。設定オプションはプラットフォーム固有でも、Elastic Beanstalk サービス全体のすべてのプラットフォームに適用することもできます。設定オプションは名前空間 に編成されます

次の名前空間は、プロキシサービスとPHP特定のオプションの両方を設定します。

  • aws:elasticbeanstalk:environment:proxy:staticfiles – 静的ファイルを提供するように環境プロキシを設定します。アプリケーションディレクトリへの仮想パスのマッピングを定義します。

  • aws:elasticbeanstalk:environment:proxy – 環境のプロキシサーバーを指定します。

  • aws:elasticbeanstalk:container:php:phpini – PHP特定のオプションを設定します。この名前空間にはcomposer_options、Elastic Beanstalk コンソールでは使用できない が含まれています。このオプションは、 composer.phar install コマンドを使用して Composer を使用して依存関係をインストールするときに使用するカスタムオプションを設定します。使用可能なオプションなど、このコマンドの詳細については、getcomposer.org ウェブサイトの「インストール」を参照してください。

次の設定ファイルの例では、staticimages という名前のディレクトリをパス /images にマップする静的ファイルオプションを指定し、aws:elasticbeanstalk:container:php:phpini 名前空間で使用できる各オプションの設定を示します。

例 .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
注記

aws:elasticbeanstalk:environment:proxy:staticfiles 名前空間は、Amazon Linux AMIPHPプラットフォームブランチ (Amazon Linux 2 より前) では定義されていません。

Elastic Beanstalk には、環境をカスタマイズするための多数の設定オプションが用意されています。設定ファイルに加えて、コンソール、保存された設定、EB 、CLIまたは を使用して設定オプションを設定することもできます。 AWS CLI。 詳細については、設定オプション「」を参照してください。