Verwenden der Elastic Beanstalk PHP-Plattform

AWS Elastic Beanstalk bietet und unterstützt verschiedene Plattformzweige für verschiedene Versionen von PHP. Die Plattformen unterstützen PHP-Webanwendungen, die eigenständig oder unter Composer ausgeführt werden. Eine vollständige Liste der unterstützten AWS Elastic Beanstalk Plattformzweige finden Sie unter PHP im Dokument Plattformen.

Elastic Beanstalk bietet Konfigurationsoptionen, mit denen Sie die Software anpassen können, die auf den EC2 Amazon-Instances in Ihrer Elastic Beanstalk Beanstalk-Umgebung ausgeführt wird. Sie können die von Ihrer Anwendung erforderlichen Umgebungsvariablen konfigurieren, die Protokollrotation an Amazon S3 aktivieren, Ordner in der Anwendungsquelle mit statischen Dateien zu vom Proxy-Server verwendeten Pfaden zuordnen und gemeinsame PHP-Initialisierungseinstellungen festlegen.

In der Elastic Beanstalk-Konsole sind Konfigurationsoptionen für das Ändern der Konfiguration einer ausgeführten Umgebung verfügbar. Um zu verhindern, dass die Umgebungskonfiguration beim Beenden verloren geht, können Sie gespeicherte Konfigurationen verwenden, um Ihre Einstellungen zu speichern und sie später für eine andere Umgebung zu übernehmen.

Zum Speichern der Einstellungen im Quellcode können Sie Konfigurationsdateien einschließen. Die Einstellungen in Konfigurationsdateien werden jedes Mal verwendet, wenn Sie eine Umgebung erstellen oder Ihre Anwendung bereitstellen. Mit Konfigurationsdateien können Sie auch Pakete installieren, Skripts ausführen und andere Instance-Anpassungen bei Bereitstellungen vornehmen.

Wenn Sie Composer verwenden, können Sie durch das Einbinden einer composer.json-Datei in das Quell-Bundle die Pakete während der Bereitstellung installieren.

Für eine erweiterte PHP-Konfiguration und PHP-Einstellungen, die nicht als Konfigurationsoptionen verfügbar sind, können Sie mit Konfigurationsdateien eine INI-Datei bereitstellen, mit der die Standardeinstellungen von Elastic Beanstalk erweitert und überschrieben werden, oder Sie können zusätzliche Erweiterungen installieren.

Die in der Elastic Beanstalk-Konsole angewendeten Einstellungen überschreiben die entsprechenden Einstellungen in Konfigurationsdateien, falls vorhanden. So sind Standardeinstellungen in Konfigurationsdateien möglich, die Sie mit umgebungsspezifischen Einstellungen in der Konsole überschreiben können. Für weitere Informationen zur Rangfolge und zu anderen Methoden zum Ändern der Einstellungen siehe Konfigurationsoptionen.

Details zu den verschiedenen Möglichkeiten für das Erweitern einer Linux-basierten Elastic Beanstalk-Plattform finden Sie unter Erweitern von Elastic Beanstalk-Linux-Plattformen.

Das AWS SDK for PHP installieren

Wenn Sie AWS Ressourcen von Ihrer Anwendung aus verwalten müssen, installieren Sie den AWS SDK für PHP. Sie können mit dem SDK for PHP beispielsweise Amazon DynamoDB (DynamoDB) zum Speichern von Benutzer- und Sitzungsinformationen verwenden, ohne eine relationale Datenbank zu erstellen.

Um das SDK for PHP mit Composer zu installieren

$ composer require aws/aws-sdk-php

Weitere Informationen finden Sie auf der AWS SDK for PHPHomepage. Anweisungen finden Sie unter Installieren von AWS SDK for PHP.

Überlegungen zu PHP 8.1 auf Amazon Linux 2

Lesen Sie diesen Abschnitt, wenn Sie den Plattformzweig PHP 8.1 auf Amazon Linux 2 verwenden.

$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

Konfigurieren Ihrer PHP-Umgebung

Mit der Elastic Beanstalk-Konsole können Sie die Protokollrotation für Amazon S3 aktivieren, Variablen konfigurieren, die die Anwendung in der Umgebung lesen kann, und die PHP-Einstellungen ändern.

PHP-Einstellungen

Protokolloptionen

Im Abschnitt mit den Protokolloptionen hat zwei Einstellungen:

Statische Dateien

Um die Leistung zu verbessern, können Sie den Abschnitt Static files (Statische Dateien) benutzen, um den Proxy-Server so zu konfigurieren, dass er statische Dateien (z. B. HTML oder Bilder) aus Verzeichnissen innerhalb Ihrer Webanwendung bereitstellt. Legen Sie für jedes Verzeichnis den virtuellen Pfad zum Verzeichnis-Mapping fest. Wenn der Proxy-Server eine Anfrage nach einer Datei unter dem angegebenen Pfad erhält, stellt er die Datei direkt bereit, anstatt die Anfrage an Ihre Anwendung weiterzuleiten.

Weitere Informationen zum Konfigurieren statischer Dateien mit der Elastic Beanstalk-Konsole finden Sie unter Bereitstellen von statischen Dateien.

Umgebungseigenschaften

Im Abschnitt Umgebungseigenschaften können Sie die Umgebungskonfigurationseinstellungen für die EC2 Amazon-Instances angeben, auf denen Ihre Anwendung ausgeführt wird. Diese Einstellungen werden als Schlüsselwert-Paare an die Anwendung weitergeleitet.

Ihr Anwendungscode kann mithilfe der Funktion $_SERVER oder get_cfg_var auf Umgebungseigenschaften zugreifen.

$endpoint = $_SERVER['API_ENDPOINT'];

Weitere Informationen finden Sie unter Umgebungsvariablen und andere Softwareeinstellungen.

Namespaces für die Konfiguration

Mithilfe einer Konfigurationsdatei können Sie im Rahmen der Bereitstellung Konfigurationsoptionen festlegen und andere Instance-Konfigurationsaufgaben durchführen. Die Konfigurationsoptionen können plattformspezifisch sein oder für alle Plattformen im Elastic Beanstalk-Service als Ganzes gelten. Die Konfigurationsoptionen sind in Namespaces organisiert.

Die folgenden Namespaces konfigurieren sowohl Ihren Proxydienst als auch PHP-spezifische Optionen:

Die folgende Beispielkonfigurationsdatei gibt eine Option für statische Dateien an, mit der ein Verzeichnis mit dem Namen staticimages dem Pfad /images zugeordnet wird, und zeigt die Einstellungen jeder der im Namespace aws:elasticbeanstalk:container:php:phpini verfügbaren Optionen an:

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 bietet zahlreiche Konfigurationsoptionen für die Anpassung Ihrer Umgebung. Neben den Konfigurationsdateien können Sie die Konfigurationsoptionen auch unter Verwendung der Konsole, gespeicherter Konfigurationen, der EB CLI oder der AWS CLI einrichten. Weitere Informationen finden Sie unter Konfigurationsoptionen.

Die Abhängigkeiten Ihrer Elastic Beanstalk PHP-Anwendung installieren

In diesem Thema wird beschrieben, wie Sie Ihre Anwendung so konfigurieren, dass sie andere PHP-Pakete installiert, die sie benötigt. Ihre Anwendung ist möglicherweise von anderen PHP-Paketen abhängig. Sie können Ihre Anwendung so konfigurieren, dass diese Abhängigkeiten auf den Amazon Elastic Compute Cloud (Amazon EC2) -Instances der Umgebung installiert werden. Alternativ können Sie die Abhängigkeiten Ihrer Anwendung in das Quell-Bundle einschließen und sie mit der Anwendung bereitstellen. Im folgenden Abschnitt werden beide Möglichkeiten vorgestellt.

Verwenden einer Composer-Datei zum Installieren von Abhängigkeiten von Instances

Verwenden Sie eine composer.json Datei im Stammverzeichnis Ihrer Projektquelle, um mithilfe von Composer Pakete zu installieren, die Ihre Anwendung auf den EC2 Amazon-Instances Ihrer Umgebung benötigt.

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

Wenn eine composer.json-Datei vorhanden ist, führt Elastic Beanstalk composer.phar install aus, um Abhängigkeiten zu installieren. Sie können Optionen für den Befehl anfügen, indem Sie die Option composer_options im Namespace aws:elasticbeanstalk:container:php:phpini festlegen.

Einschließen von Abhängigkeiten in Quell-Bundles

Wenn Ihre Anwendung viele Abhängigkeiten hat, kann die Installation etwas länger dauern. Dies kann die Bereitstellung und Skalierung von Operationen erhöhen, da auf jeder neuen Instance Abhängigkeiten installiert sind.

Um negative Auswirkungen auf die Bereitstellungszeit zu vermeiden, können Sie mit Composer in Ihrer Entwicklungsumgebung Abhängigkeiten auflösen und sie im Ordner vendor zu installieren.

Wenn Elastic Beanstalk einen Ordner vendor in der Instance findet, wird die Datei composer.json ignoriert (selbst, wenn sie vorhanden ist). Ihre Anwendung verwendet dann die Abhängigkeiten im Ordner vendor.

Composer auf Elastic Beanstalk aktualisieren

In diesem Thema wird beschrieben, wie Elastic Beanstalk konfiguriert wird, um Composer auf dem neuesten Stand zu halten. Möglicherweise müssen Sie Composer aktualisieren, wenn beim Versuch, Pakete mit einer Composer-Datei zu installieren, ein Fehler auftritt oder wenn Sie die neueste Plattformversion nicht verwenden können. Zwischen Plattformupdates können Sie Composer in Ihren Umgebungsinstanzen mithilfe der Konfigurationsdateien in Ihrem .ebextensionsOrdner aktualisieren.

Sie können Composer mit der folgenden Konfiguration selbst aktualisieren.

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

Die folgende Optionseinstellung legt die COMPOSER_HOME Umgebungsvariable fest, die den Speicherort des Composer-Cache konfiguriert.

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

Sie können beide in derselben Konfigurationsdatei in Ihrem .ebextensions Ordner kombinieren.

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

Weitere Informationen zu den Elastic-Beanstalk PHP-Plattformen, einschließlich der Composer-Version, finden Sie unter PHP-Plattformversionen im Dokument AWS Elastic Beanstalk -Plattformen.

php.ini in Ihrer Elastic Beanstalk Beanstalk-Konfiguration erweitern

Verwenden Sie eine Konfigurationsdatei mit einem files-Block, um eine .ini-Datei zu /etc/php.d/ auf den Instances der Umgebung hinzuzufügen. Von der Hauptkonfigurationsdatei php.ini werden die Einstellungen aus den Dateien in diesem Ordner in alphabetischer Reihenfolge abgerufen. Viele Erweiterungen werden standardmäßig über die Dateien in diesem Ordner aktiviert.

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