Étapes d'installation pour les nouveaux utilisateurs - Amazon ElastiCache

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Étapes d'installation pour les nouveaux utilisateurs

Installation de PHP 7.x – 8.x pour les nouveaux utilisateurs

Pour installer PHP 7 – 8.x sur une AMI Amazon Linux 2

Note

Si nécessaire, remplacez PHP-7.x avec la version que vous utilisez.

  1. Lancez une nouvelle instance depuis l'AMI.

  2. Exécutez la commande suivante :

    sudo yum install gcc-c++ zlib-devel
  3. Installez PHP 7.x en utilisant amazon-linux-extras

    Avec Amazon Linux 2, vous pouvez utiliser la bibliothèque Extras pour installer les mises à jour d'application et logicielles sur vos instances. Ces mises à jour logicielles sont appelées rubriques. Vous pouvez installer une version spécifique d'une rubrique ou omettre les informations de version pour utiliser la version la plus récente. Pour plus d'informations, veuillez consulter Bibliothèque Extras (Amazon Linux 2).

    Pour cela, suivez les étapes suivantes :

    1. Tout d'abord, vérifiez si amazon-linux-extras est déjà installé.

    2. S'il n'est pas installé, utilisez la commande suivante pour l'installer :

      sudo yum install -y amazon-linux-extras

    3. Vérifiez que la rubrique PHP 7.x est disponible sur la machine Amazon Linux 2 :

      sudo amazon-linux-extras | grep php

    4. Dans la sortie, passez en revue tous les sujets de PHP 7 et sélectionnez la version que vous voulez :

      sudo amazon-linux-extras enable php7.x

    5. Installez le package PHP à partir des référentiels. Par exemple :

      sudo yum clean metadata

      sudo yum install php php-devel

  4. Téléchargez le client Amazon ElastiCache Cluster.

    • Ouvrez la console ElastiCache à l'adresse https://console.aws.amazon.com/elasticache/.

      Sous le tableau de bord ElastiCache, accédez à Client de cluster ElastiCache, puis choisissez la version PHP7 que vous voulez.

    • Dans la ligne de commande, remplacez PHP-7.X par la version de PHP souhaitée et remplacez ARCH par l'architecture souhaitée (X86 ou arm). Pour PHP >= 7.4, remplacez OpenSSL par la version d'OpenSSL souhaitée (openssl1.1 ou openssl3). Si vous utilisez PHP > 7.4, supprimez le suffixe OpenSSL.

      wget https://elasticache-downloads.s3.amazonaws.com/ClusterClient/PHP-7.X/latest-64bit-<ARCH>-<OpenSSL>
  5. Utiliser tar -zxvf pour extraire le fichier téléchargé.

    tar -zxvf latest-64bit-<ARCH>-<OpenSSL>
  6. Avec les autorisations racine, copiez le fichier artefact extrait amazon-elasticache-cluster-client.so dans /usr/lib64/php/modules.

    sudo mv amazon-elasticache-cluster-client.so /usr/lib64/php/modules/
  7. Addition extension=amazon-elasticache-cluster-client.so dans le fichier /etc/php.ini

  8. Si vous avez téléchargé le client de cluster ElastiCache avec PHP 7.4 ou supérieur, installez OpenSSL 1.1.x ou supérieur. Instructions d'installation pour OpenSSL 1.1.1 :

    sudo yum -y update sudo yum install -y make gcc perl-core pcre-devel wget zlib-devel wget https://www.openssl.org/source/openssl-1.1.1c.tar.gz tar xvf openssl-1.1.1c.tar.gz cd openssl-1.1.1c ./config make sudo make install sudo ln -s /usr/local/lib64/libssl.so.1.1 /usr/lib64/libssl.so.1.1

 

Pour installer PHP 7 – 8.x sur une AMI Amazon Linux 201609

Note

Si nécessaire, remplacez php7.x avec la version que vous utilisez.

  1. Lancez une nouvelle instance depuis l'AMI. Pour plus d'informations, veuillez consulter Étape 1 : Lancer une instance dans le Guide de l'utilisateur Amazon EC2.

  2. Exécutez la commande suivante :

    sudo yum install gcc-c++
  3. Installez PHP

    sudo yum install php7.x
  4. Téléchargez le client Amazon ElastiCache Cluster.

    wget https://elasticache-downloads.s3.amazonaws.com/ClusterClient/PHP-7.x/latest-64bit
  5. Extrayez latest-64bit.

    tar -zxvf latest-64bit
  6. Avec l'autorisation racine, copiez le fichier artefact extrait amazon-elasticache-cluster-client.so dans /usr/lib64/php/7.x/modules/.

    sudo mv artifact/amazon-elasticache-cluster-client.so /usr/lib64/php/7.x/modules/
  7. Créez le fichier 50-memcached.ini.

    echo "extension=amazon-elasticache-cluster-client.so" | sudo tee --append /etc/php-7.x.d/50-memcached.ini
  8. Démarrez ou redémarrez votre serveur Apache.

    sudo /etc/init.d/httpd start

 

Pour installer PHP 7.x – 8.x sur une AMI SUSE Linux 15

Note

Si nécessaire, remplacez php7.x avec la version que vous utilisez.

  1. Lancez une nouvelle instance depuis l'AMI.

  2. Exécutez la commande suivante :

    sudo zypper refresh sudo zypper update -y sudo zypper install gcc
  3. Installez PHP

    sudo yum install php7.x

    or

    sudo zypper addrepo //download.opensuse.org/repositories/devel:/languages:/php/openSUSE_Leap_15.3/ php
  4. Téléchargez le client de cluster Amazon ElastiCache, remplacez <ARCH> par l'architecture souhaitée (X86 ou arm). SUSE 15 est livré avec OpenSSL1.1 intégré, donc pour PHP >= 7.4 choisissez le binaire client avec OpenSSL1. Si vous utilisez PHP < 7.4, supprimez le suffixe OpenSSL.

    wget https://elasticache-downloads.s3.amazonaws.com/ClusterClient/PHP-7.x/latest-64bit-<ARCH>-openssl1.1
  5. Extrayez latest-64bit.

    tar -zxvf latest-64bit-<ARCH>-openssl1.1
  6. Avec l'autorisation racine, copiez le fichier artefact extrait amazon-elasticache-cluster-client.so dans /usr/lib64/php7/extensions/.

    sudo mv artifact/amazon-elasticache-cluster-client.so /usr/lib64/php7/extensions/
  7. Insérez la ligne extension=amazon-elasticache-cluster-client.so dans le fichier /etc/php7/cli/php.ini.

    echo "extension=amazon-elasticache-cluster-client.so" | sudo tee --append /etc/php7/cli/php.ini
  8. Démarrez ou redémarrez votre serveur Apache.

    sudo /etc/init.d/httpd start

 

Pour installer PHP 7.x – 8.x sur une AMI Ubuntu 22.04

Note

Si nécessaire, remplacez php7.x avec la version que vous utilisez.

  1. Lancez une nouvelle instance depuis l'AMI.

  2. Exécutez la commande suivante :

    sudo apt-get update sudo apt-get install gcc g++ make zlib1g zlib1g-dev
  3. Installez PHP

    1. Instructions d'installation pour PHP 8.1 :

      sudo apt install php8.1-cli php8.1-dev
    2. Instructions d'installation pour PHP 7.4 :

      sudo apt -y install software-properties-common sudo add-apt-repository ppa:ondrej/php sudo apt-get update sudo apt -y install php7.4
  4. Téléchargez le client de cluster Amazon ElastiCache, remplacez <ARCH> par l'architecture souhaitée (X86 ou arm). Ubuntu 22.04 est livré avec OpenSSL3 intégré, donc pour PHP >= 7.4 choisissez le binaire client avec OpenSSL3. Si vous utilisez PHP < 7.4, supprimez le suffixe OpenSSL.

    wget https://elasticache-downloads.s3.amazonaws.com/ClusterClient/PHP-7.x/latest-64bit-<ARCH>-openssl3
  5. Effectuez l'extraction de la dernière version 64 bits.

    tar -zxvf latest-64bit-<ARCH>-openssl3
  6. Avec l'autorisation racine, copiez le fichier artefact extrait amazon-elasticache-cluster-client.so dans le répertoire d'extension php /usr/lib/php/20190902. Si ce répertoire d'extension n'existe pas, vous pouvez le trouver en exécutant : php -i | grep extension_dir

  7. Insérez la ligne extension=amazon-elasticache-cluster-client.so dans le fichier /etc/php/7.x/cli/php.ini.

 

Installation de PHP 5.x pour les nouveaux utilisateurs

Pour installer PHP 5 sur une AMI d'Amazon Linux 2014.03 (64 bits et 32 bits)

  1. Lancez une instance Amazon Linux (32 bits ou 64 bits) et connectez-vous.

  2. Installez les dépendances PHP :

    $ sudo yum install gcc-c++ php php-pear
  3. Téléchargez le package php-memcached adéquat pour votre instance Amazon EC2 et la version PHP. Pour de plus amples informations, veuillez consulter Téléchargement du package d'installation.

  4. Installer php-memcached. L'URI doit être le chemin de téléchargement du package d'installation :

    $ sudo pecl install <package download path>

    Voici un exemple de commande installation pour PHP 5.4, Linux 64 bits. Dans cet exemple, remplacez X.Y.Z par le numéro de la version actuelle :

    $ sudo pecl install /home/AmazonElastiCacheClusterClient-X.Y.Z-PHP54-64bit.tgz
    Note

    Veuillez à utiliser la dernière version de l'artefact d'installation.

  5. Avec l'autorisation racine/sudo, ajoutez un nouveau fichier nommé memcached.ini dans l'annuaire /etc/php.d et insérez « extension=amazon-elasticache-cluster-client.so » dans le fichier :

    $ echo "extension=amazon-elasticache-cluster-client.so" | sudo tee --append /etc/php.d/memcached.ini
  6. Démarrez ou redémarrez votre serveur Apache.

    sudo /etc/init.d/httpd start

 

Pour installer PHP 5 sur une AMI de Red Hat Enterprise Linux 7,0 (64 bits et 32 bits)

  1. Lancez une instance Red Hat Enterprise Linux (32 bits ou 64 bits) et connectez-vous.

  2. Installez les dépendances PHP :

    sudo yum install gcc-c++ php php-pear
  3. Téléchargez le package php-memcached adéquat pour votre instance Amazon EC2 et la version PHP. Pour de plus amples informations, veuillez consulter Téléchargement du package d'installation.

  4. Installer php-memcached. L'URI doit être le chemin de téléchargement du package d'installation :

    sudo pecl install <package download path>
  5. Avec l'autorisation racine/sudo, ajoutez un nouveau fichier nommé memcached.ini dans l'annuaire /etc/php.d et insérez extension=amazon-elasticache-cluster-client.so dans le fichier :

    echo "extension=amazon-elasticache-cluster-client.so" | sudo tee --append /etc/php.d/memcached.ini
  6. Démarrez ou redémarrez votre serveur Apache.

    sudo /etc/init.d/httpd start

 

Pour installer PHP 5 sur une AMI de serveur Ubuntu 14.04 LTS (64 bits et 32 bits)

  1. Lancez une instance Ubuntu Linux (32 bits ou 64 bits) et connectez-vous.

  2. Installez les dépendances PHP :

    sudo apt-get update sudo apt-get install gcc g++ php5 php-pear
  3. Téléchargez le package php-memcached adéquat pour votre instance Amazon EC2 et la version PHP. Pour de plus amples informations, veuillez consulter Téléchargement du package d'installation.

  4. Installer php-memcached. L'URI doit être le chemin de téléchargement du package d'installation.

    $ sudo pecl install <package download path>
    Note

    Cette étape permet d'installer l'artefact de build amazon-elasticache-cluster-client.so dans le répertoire /usr/lib/php5/20121212*. Vérifiez le chemin d'accès absolu de l'artefact de génération, car vous en avez besoin pour l'étape suivante.

    Si la commande précédente ne fonctionne pas, vous devez extraire manuellement l'artefact de client PHP amazon-elasticache-cluster-client.so du fichier *.tgz téléchargé, et le copier dans l'annuaire /usr/lib/php5/20121212*.

    $ tar -xvf <package download path> cp amazon-elasticache-cluster-client.so /usr/lib/php5/20121212/
  5. Avec l'autorisation racine/sudo, ajoutez un nouveau fichier nommé memcached.ini dans le répertoire /etc/php5/cli/conf.d, et insérez « extension=<absolute path to amazon-ElastiCache-cluster-client.so> » dans ce fichier.

    $ echo "extension=<absolute path to amazon-elasticache-cluster-client.so>" | sudo tee --append /etc/php5/cli/conf.d/memcached.ini
  6. Démarrez ou redémarrez votre serveur Apache.

    sudo /etc/init.d/httpd start

 

Pour installer PHP 5 pour AMI de SUSE Linux Enterprise Server 11 (64 bits ou 32 bits)

  1. Lancez une instance SUSE Linux (32 bits ou 64 bits) et connectez-vous.

  2. Installez les dépendances PHP :

    $ sudo zypper install gcc php53-devel
  3. Téléchargez le package php-memcached adéquat pour votre instance Amazon EC2 et la version PHP. Pour de plus amples informations, veuillez consulter Téléchargement du package d'installation.

  4. Installer php-memcached. L'URI doit être le chemin de téléchargement du package d'installation.

    $ sudo pecl install <package download path>
  5. Avec l'autorisation racine/sudo, ajoutez un nouveau fichier nommé memcached.ini dans l'annuaire /etc/php5/conf.d et insérez extension=amazon-elasticache-cluster-client.so dans le fichier :

    $ echo "extension=amazon-elasticache-cluster-client.so" | sudo tee --append /etc/php5/conf.d/memcached.ini
  6. Démarrez ou redémarrez votre serveur Apache.

    sudo /etc/init.d/httpd start
Note

Si l'étape 5 ne fonctionne pas pour une des plateformes précédentes, vérifiez le chemin d'installation de amazon-elasticache-cluster-client.so. Spécifiez également le chemin d'accès complet du fichier binaire dans l'extension. En outre, vérifiez que la version du PHP en cours d'utilisation est prise en charge. Nous prenons en charge les versions 5.3 via 5.5.

 

Autres distributions Linux

Sur certains systèmes, notamment CentOS7 et Red Hat Enterprise Linux (RHEL) 7.1, libsasl2.so.3 a remplacé libsasl2.so.2. Sur ces systèmes, lorsque vous chargez le client de cluster ElastiCache, il tente de trouver et de charger , mais il n'y parvient pas libsasl2.so.2. Pour résoudre ce problème, créez un lien symbolique vers libsasl2.so.3 afin que lorsque le client tente de charger libsasl2.so.2, il est redirigé vers libsasl2.so.3. Le code suivant crée ce lien symbolique.

cd /usr/lib64 $ sudo ln libsasl2.so.3 libsasl2.so.2