Utilisation de la plateforme Elastic Beanstalk PHP

Cette rubrique explique comment configurer, créer et exécuter vos PHP applications sur Elastic Beanstalk.

AWS Elastic Beanstalk prend en charge un certain nombre de branches de plate-forme pour différentes versions du langage de PHP programmation. Ces plateformes prennent en charge les applications PHP Web qui peuvent être exécutées seules ou sous Composer. Consultez PHPle document AWS Elastic Beanstalk Plateformes pour obtenir la liste complète des branches de plateforme prises en charge.

Elastic Beanstalk propose des options de configuration que vous pouvez utiliser pour personnaliser le logiciel qui s'exécute EC2 sur les instances de votre environnement Elastic Beanstalk. Vous pouvez configurer les variables d'environnement requises par votre application, activer la rotation des journaux vers Amazon S3, mapper les dossiers de la source de votre application contenant des fichiers statiques aux chemins desservis par le serveur proxy et définir des paramètres d'PHPinitialisation communs.

Des options de configuration sont disponibles dans la console Elastic Beanstalk pour modifier la configuration d'un environnement en cours d'exécution. Pour éviter de perdre la configuration de votre environnement en le résiliant, vous pouvez utiliser des configurations enregistrées pour enregistrer vos paramètres et les appliquer par la suite à un autre environnement.

Pour enregistrer les paramètres dans votre code source, vous pouvez inclure des fichiers de configuration. Les paramètres des fichiers de configuration sont appliquées chaque fois que vous créez un environnement ou que vous déployez votre application. Vous pouvez également utiliser des fichiers de configuration pour installer des packages, exécuter des scripts ou effectuer d'autres opérations de personnalisation d'instance lors des déploiements.

Si vous utilisez Composer, vous pouvez inclure un fichiercomposer.json dans votre bundle source afin d'installer des packages pendant le déploiement.

Pour PHP la configuration avancée et PHP les paramètres qui ne sont pas fournis sous forme d'options de configuration, vous pouvez utiliser des fichiers de configuration pour fournir un INI fichier capable d'étendre et de remplacer les paramètres par défaut appliqués par Elastic Beanstalk, ou d'installer des extensions supplémentaires.

Les paramètres appliqués dans la console Elastic Beanstalk remplacent les mêmes paramètres des fichiers de configuration, s'ils existent. Cela vous permet d'utiliser les paramètres par défaut dans les fichiers de configuration et de les remplacer par des paramètres spécifiques à l'environnement dans la console. Pour plus d'informations sur la priorité et les autres méthodes de modification des paramètres, consultez Options de configuration.

Pour plus d'informations sur les différentes manières d'étendre une plateforme Elastic Beanstalk basée sur Linux, consultez Extension des plateformes Linux Elastic Beanstalk.

Considérations relatives à la PHP version 8.1 sur Amazon Linux 2

Lisez cette section si vous utilisez la PHPversion 8.1 sur la branche de la plateforme 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

Configuration de votre environnement PHP

Vous pouvez utiliser la console Elastic Beanstalk pour activer la rotation des journaux vers Amazon S3, configurer les variables que votre application peut lire depuis l'environnement et modifier les paramètres. PHP

PHPparamètres

Options du journal

La section Options du journal a deux paramètres :

Fichiers statiques

Pour améliorer les performances, vous pouvez utiliser la section Fichiers statiques pour configurer le serveur proxy pour qu'il diffuse des fichiers statiques (par exemple, HTML ou des images) à partir d'un ensemble de répertoires au sein de votre application Web. Pour chaque répertoire, vous définissez le chemin virtuel sur le mappage de répertoires. Lorsque le serveur proxy reçoit une demande pour un fichier dans le chemin spécifié, il fournit le fichier directement au lieu d'acheminer la demande vers votre application.

Pour en savoir plus sur la configuration des fichiers statiques à l'aide des fichiers de configuration ou de la console Elastic Beanstalk, consultez Service de fichiers statiques.

Propriétés de l'environnement

La section Propriétés de l'environnement vous permet de définir les paramètres de configuration de l'environnement sur EC2 les instances Amazon qui exécutent votre application. Ces paramètres sont passés en tant que paires clé-valeur à l'application.

Votre code d'application peut accéder aux propriétés de l'environnement à l'aide de $_SERVER ou à la fonction get_cfg_var.

$endpoint = $_SERVER['API_ENDPOINT'];

Pour plus d’informations, consultez Propriétés de l'environnement et autres paramètres de logiciel.

Espace de noms aws:elasticbeanstalk:container:php:phpini

Vous pouvez utiliser un fichier de configuration pour définir des options de configuration et exécuter d'autres tâches de configuration d'instance pendant les déploiements. Les options de configuration peuvent être définies par le service Elastic Beanstalk ou la plateforme que vous utilisez et sont organisées en espaces de noms.

Vous pouvez utiliser l'espace de noms aws:elasticbeanstalk:environment:proxy pour choisir le serveur proxy de l'environnement.

Vous pouvez utiliser l'espace de noms aws:elasticbeanstalk:environment:proxy:staticfiles pour configurer le proxy d'environnement afin de traiter les fichiers statiques. Vous définissez les mappages des chemins virtuels vers les répertoires d'applications.

La PHP plate-forme définit des options dans l'espace de aws:elasticbeanstalk:container:php:phpini noms, dont une qui n'est pas disponible dans la console Elastic Beanstalk. composer_optionsdéfinit les options personnalisées à utiliser lors de l'installation de dépendances à l'aide de Composer viacomposer.phar install. Pour plus d'informations et pour connaître les options disponibles, consultez http://getcomposer.org/doc/03-cli.md#install.

L'exemple de fichier de configuration suivant spécifie une option de fichiers statiques qui mappe un répertoire nommé staticimages au chemin /images, d'accès et affiche les paramètres de chacune des options disponibles dans l'espace de noms 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 fournit de nombreuses options de configuration pour personnaliser votre environnement. Outre les fichiers de configuration, vous pouvez également définir les options de configuration à l'aide de la console, des configurations enregistrées, de l'EB CLI ou du AWS CLI. Pour plus d’informations, consultez Options de configuration.