新用户安装步骤 - Amazon ElastiCache
为新用户安装 PHP 7.x – 8.x为新用户安装 PHP 5.x
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异，请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

新用户安装步骤

为新用户安装 PHP 7.x – 8.x

在 Amazon Linux 2 AMI 上安装 PHP 7.x – 8.x

注意

如有必要，请将 PHP-7.x 替换为您正在使用的版本。

  1. 从 AMI 启动新实例。

  2. 运行以下命令：

    sudo yum install gcc-c++ zlib-devel

  3. 使用 amazon-linux-extras 安装 PHP 7.x

    利用 Amazon Linux 2，您可以使用 Extras 库以在您的实例上安装应用程序和软件更新。这些软件更新称为主题。您可以安装主题的某特定版本或忽略要使用最新版本的版本信息。有关更多信息，请参阅 Extras 库 (Amazon Linux 2)。

    为此，请按照下方步骤操作；

    1. 首先，验证 amazon-linux-extras 是否已安装。

    2. 如果尚未安装，请运行以下命令进行安装：

      sudo yum install -y amazon-linux-extras

    3. 确认 PHP 7.x 主题在 Amazon Linux 2 机器中可用：

      sudo amazon-linux-extras | grep php

    4. 从输出中，查看所有 PHP 7 主题并选择您想要的版本：

      sudo amazon-linux-extras enable php7.x

    5. 从存储库中安装 PHP 程序包。例如：

      sudo yum clean metadata

      sudo yum install php php-devel

  4. 下载 Amazon ElastiCache Cluster Client。

    • 打开 ElastiCache 控制台 (https://console.aws.amazon.com/elasticache/)。

      在 ElastiCache 控制面板下，转到 ElastiCache Cluster Client，然后选择您希望使用的 PHP7 版本。

    • 在命令行中，将 PHP-7.X 替换为所需的 PHP 版本，并将 ARCH 替换为所需的架构（X86 或 arm），而对于版本 >= 7.4 的 PHP，将 OpenSSL 替换为所需的 OpenSSL 版本（openssl1.1 或 openssl3）。如果您使用的 PHP 版本 > 7.4，请删除 OpenSSL 后缀。

      wget https://elasticache-downloads.s3.amazonaws.com/ClusterClient/PHP-7.X/latest-64bit-<ARCH>-<OpenSSL>

  5. 使用 tar -zxvf 提取所下载的文件。

    tar -zxvf latest-64bit-<ARCH>-<OpenSSL>

  6. 在具有 Root 权限的情况下，将提取的工件文件 amazon-elasticache-cluster-client.so 复制到 /usr/lib64/php/modules。

    sudo mv amazon-elasticache-cluster-client.so /usr/lib64/php/modules/

  7. 将 extension=amazon-elasticache-cluster-client.so 添加到文件 /etc/php.ini

  8. 如果您下载了 PHP 7.4 或更高版本的 ElastiCache Cluster Client，请安装 OpenSSL 1.1.x 或更高版本。适用于 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

 

在 Amazon Linux 201609 AMI 上安装 PHP 7.x – 8.x

注意

如有必要，请将 php7.x 替换为您正在使用的版本。

  1. 从 AMI 启动新实例。有关更多信息，请参阅 Amazon EC2 用户指南中的步骤 1：启动实例。

  2. 运行以下命令：

    sudo yum install gcc-c++

  3. 安装 PHP

    sudo yum install php7.x

  4. 下载 Amazon ElastiCache Cluster Client。

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

  5. 提取 latest-64bit。

    tar -zxvf latest-64bit

  6. 在具有 Root 权限的情况下，将提取的构件文件 amazon-elasticache-cluster-client.so 复制到 /usr/lib64/php/7.x/modules/。

    sudo mv artifact/amazon-elasticache-cluster-client.so /usr/lib64/php/7.x/modules/

  7. 创建 50-memcached.ini 文件。

    echo "extension=amazon-elasticache-cluster-client.so" | sudo tee --append /etc/php-7.x.d/50-memcached.ini

  8. 启动或重启 Apache 服务器。

    sudo /etc/init.d/httpd start

 

在 SUSE Linux 15 AMI 上安装 PHP 7.x – 8.x

注意

如有必要，请将 php7.x 替换为您正在使用的版本。

  1. 从 AMI 启动新实例。

  2. 运行以下命令：

    sudo zypper refresh
sudo zypper update -y
sudo zypper install gcc

  3. 安装 PHP

    sudo yum install php7.x

    or

    sudo zypper addrepo //download.opensuse.org/repositories/devel:/languages:/php/openSUSE_Leap_15.3/ php

  4. 下载 Amazon ElastiCache Cluster Client，将 <ARCH> 替换为所需的架构（X86 或 arm）。SUSE 15 内置了 OpenSSL1.1，因此对于版本 >= 7.4 的 PHP，请选择带有 OpenSSL1 的客户端二进制文件。如果您使用的 PHP 版本 < 7.4，请删除 OpenSSL 后缀。

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

  5. 提取 latest-64bit。

    tar -zxvf latest-64bit-<ARCH>-openssl1.1

  6. 在具有 Root 权限的情况下，将提取的构件文件 amazon-elasticache-cluster-client.so 复制到 /usr/lib64/php7/extensions/。

    sudo mv artifact/amazon-elasticache-cluster-client.so /usr/lib64/php7/extensions/

  7. 将 extension=amazon-elasticache-cluster-client.so 行插入到文件 /etc/php7/cli/php.ini。

    echo "extension=amazon-elasticache-cluster-client.so" | sudo tee --append /etc/php7/cli/php.ini

  8. 启动或重启 Apache 服务器。

    sudo /etc/init.d/httpd start

 

在 Ubuntu 22.04 AMI 上安装 PHP 7.x – 8.x

注意

如有必要，请将 php7.x 替换为您正在使用的版本。

  1. 从 AMI 启动新实例。

  2. 运行以下命令：

    sudo apt-get update
sudo apt-get install gcc g++ make zlib1g zlib1g-dev

  3. 安装 PHP

    1. 适用于 PHP 8.1 的安装说明：

      sudo apt install php8.1-cli php8.1-dev

    2. 适用于 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. 下载 Amazon ElastiCache Cluster Client，将 <ARCH> 替换为所需的架构（X86 或 arm）。Ubuntu 22.04 内置了 OpenSSL3，因此对于版本 >= 7.4 的 PHP，请选择带有 OpenSSL3 的客户端二进制文件。如果您使用的 PHP 版本 < 7.4，请删除 OpenSSL 后缀。

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

  5. 提取 latest-64bit。

    tar -zxvf latest-64bit-<ARCH>-openssl3

  6. 在具有 Root 权限的情况下，将提取的构件文件 amazon-elasticache-cluster-client.so 复制到 php 扩展目录 /usr/lib/php/20190902。如果该扩展目录不存在，您可以运行以下命令找到它：php -i | grep extension_dir

  7. 将 extension=amazon-elasticache-cluster-client.so 行插入到文件 /etc/php/7.x/cli/php.ini。

 

为新用户安装 PHP 5.x

在 Amazon Linux AMI 2014.03（64 位和 32 位）上安装 PHP 5

  1. 启动一个 Amazon Linux 实例（64 位或 32 位），然后登录。

  2. 安装 PHP 依赖项：

    $ sudo yum install gcc-c++ php php-pear

  3. 下载适用于您的 Amazon EC2 实例和 PHP 版本的正确 php-memcached 软件包。有关更多信息，请参阅下载安装包。

  4. 安装 php-memcached。URI 应为安装包的下载路径：

    $ sudo pecl install <package download path>

    这是一个关于 PHP 5.4、64 位 Linux 的示例安装命令。在这个示例中，使用实际版本号代替 X.Y.Z：

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

    请务必使用最新版本的安装工件。

  5. 在具有 Root/Sudo 权限的情况下，在 memcached.ini 目录中添加一个名为 /etc/php.d 的新文件，然后在该文件中插入“extension=amazon-elasticache-cluster-client.so”：

    $ echo "extension=amazon-elasticache-cluster-client.so" | sudo tee --append /etc/php.d/memcached.ini

  6. 启动或重启 Apache 服务器。

    sudo /etc/init.d/httpd start

 

在 Red Hat Enterprise Linux 7.0 AMI（64 位和 32 位）上安装 PHP 5

  1. 启动一个 Red Hat Enterprise Linux 实例（64 位或 32 位），然后登录。

  2. 安装 PHP 依赖项：

    sudo yum install gcc-c++ php php-pear

  3. 下载适用于您的 Amazon EC2 实例和 PHP 版本的正确 php-memcached 软件包。有关更多信息，请参阅下载安装包。

  4. 安装 php-memcached。URI 应为安装包的下载路径：

    sudo pecl install <package download path>

  5. 在具有 Root/Sudo 权限的情况下，在 memcached.ini 目录中添加一个名为 /etc/php.d 的新文件，然后在该文件中插入 extension=amazon-elasticache-cluster-client.so。

    echo "extension=amazon-elasticache-cluster-client.so" | sudo tee --append /etc/php.d/memcached.ini

  6. 启动或重启 Apache 服务器。

    sudo /etc/init.d/httpd start

 

在 Ubuntu Server 14.04 LTS AMI（64 位和 32 位）上安装 PHP 5

  1. 启动一个 Ubuntu Linux 实例（64 位或 32 位），然后登录。

  2. 安装 PHP 依赖项：

    sudo apt-get update 
sudo apt-get install gcc g++ php5 php-pear

  3. 下载适用于您的 Amazon EC2 实例和 PHP 版本的正确 php-memcached 软件包。有关更多信息，请参阅下载安装包。

  4. 安装 php-memcached。URI 应为安装包的下载路径。

    $ sudo pecl install <package download path>
    注意

    此安装步骤将构建工件 amazon-elasticache-cluster-client.so 安装到 /usr/lib/php5/20121212* 目录中。请核对构建工件的绝对路径，因为您在下一个步骤中需要使用此路径。

    如果上一个命令不起作用，则需要从下载的 amazon-elasticache-cluster-client.so 文件中手动提取 PHP 客户端工件 *.tgz，将它复制到 /usr/lib/php5/20121212* 目录。

    $ tar -xvf <package download path>
cp amazon-elasticache-cluster-client.so /usr/lib/php5/20121212/

  5. 在具有 Root/Sudo 权限的情况下，在 /etc/php5/cli/conf.d 目录中添加一个名为 memcached.ini 的新文件，然后在该文件中插入“extension=<amazon-elasticache-cluster-client.so 的绝对路径>”。

    $ echo "extension=<absolute path to amazon-elasticache-cluster-client.so>" | sudo tee --append /etc/php5/cli/conf.d/memcached.ini

  6. 启动或重启 Apache 服务器。

    sudo /etc/init.d/httpd start

 

为 SUSE Linux Enterprise Server 11 AMI（64 位或 32 位）安装 PHP 5

  1. 启动一个 SUSE Linux 实例（64 位或 32 位），然后登录。

  2. 安装 PHP 依赖项：

    $ sudo zypper install gcc php53-devel

  3. 下载适用于您的 Amazon EC2 实例和 PHP 版本的正确 php-memcached 软件包。有关更多信息，请参阅下载安装包。

  4. 安装 php-memcached。URI 应为安装包的下载路径。

    $ sudo pecl install <package download path>

  5. 在具有 Root/Sudo 权限的情况下，在 memcached.ini 目录中添加一个名为 /etc/php5/conf.d 的新文件，然后在该文件中插入 extension=amazon-elasticache-cluster-client.so。

    $ echo "extension=amazon-elasticache-cluster-client.so" | sudo tee --append /etc/php5/conf.d/memcached.ini

  6. 启动或重启 Apache 服务器。

    sudo /etc/init.d/httpd start
注意

如果步骤 5 不适用于任何以前的平台，请验证 amazon-elasticache-cluster-client.so 的安装路径。另外，在扩展中指定二进制文件的完整路径。此外，请确认所用的 PHP 是受支持的版本。我们支持版本 5.3 到 5.5。

 

其他 Linux 分配

在某些系统（特别是 CentOS7 和 Red Hat Enterprise Linux (RHEL) 7.1）上，libsasl2.so.3 已替代 libsasl2.so.2。在这些系统上，当您加载 ElastiCache 集群客户端时，它会尝试查找和加载 libsasl2.so.2，但此尝试将失败。要解决此问题，请创建一个指向 libsasl2.so.3 的符号链接，以便在客户端尝试加载 libsasl2.so.2 时将重定向到 libsasl2.so.3。以下代码将创建此符号链接。

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