Installation steps for new users - Amazon ElastiCache
Installing PHP 7.x for new usersInstalling PHP 5.x for new users

Installation steps for new users

Installing PHP 7.x for new users

To install PHP 7 on a Ubuntu server 14.04 LTS AMI (64-bit and 32-bit)

  1. Launch a new instance from the AMI.

  2. Run the following commands:

    sudo apt-get update
sudo apt-get install gcc g++

  3. Install PHP 7.

    sudo yum install php70

  4. Download the Amazon ElastiCache Cluster Client.

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

  5. Extract latest-64bit.

    tar -zxvf latest-64bit

  6. With root permissions, copy the extracted artifact file amazon-elasticache-cluster-client.so into /usr/lib/php/20151012.

    sudo mv artifact/amazon-elasticache-cluster-client.so /usr/lib/php/20151012

  7. Insert the line extension=amazon-elasticache-cluster-client.so into the file /etc/php/7.0/cli/php.ini.

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

  8. Start or restart your Apache server.

    sudo /etc/init.d/httpd start

 

To install PHP 7 on an Amazon Linux 201609 AMI

  1. Launch a new instance from the AMI.

  2. Run the following command:

    sudo yum install gcc-c++

  3. Install PHP 7.

    sudo yum install php70

  4. Download the Amazon ElastiCache Cluster Client.

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

  5. Extract latest-64bit.

    tar -zxvf latest-64bit

  6. With root permission, copy the extracted artifact file amazon-elasticache-cluster-client.so into /usr/lib64/php/7.0/modules/.

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

  7. Create the 50-memcached.ini file.

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

  8. Start or restart your Apache server.

    sudo /etc/init.d/httpd start

 

To install PHP 7 on an SUSE Linux AMI

  1. Launch a new instance from the AMI.

  2. Run the following command:

    sudo zypper install gcc

  3. Install PHP 7.

    sudo yum install php70

  4. Download the Amazon ElastiCache Cluster Client.

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

  5. Extract latest-64bit.

    tar -zxvf latest-64bit

  6. With root permission, copy the extracted artifact file amazon-elasticache-cluster-client.so into /usr/lib64/php7/extensions/.

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

  7. Insert the line extension=amazon-elasticache-cluster-client.so into the file /etc/php7/cli/php.ini.

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

  8. Start or restart your Apache server.

    sudo /etc/init.d/httpd start

 

Installing PHP 5.x for new users

To install PHP 5 on an Amazon Linux AMI 2014.03 (64-bit and 32-bit)

  1. Launch an Amazon Linux instance (either 64-bit or 32-bit) and log into it.

  2. Install PHP dependencies:

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

  3. Download the correct php-memcached package for your Amazon EC2 instance and PHP version. For more information, see Downloading the installation package.

  4. Install php-memcached. The URI should be the download path for the installation package:

    sudo pecl install <package download path>

    Here is a sample installation command for PHP 5.4, 64-bit Linux. In this sample, replace X.Y.Z with the actual version number:

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

    Be sure to use the latest version of the install artifact.

  5. With root/sudo permission, add a new file named memcached.ini in the /etc/php.d directory, and insert "extension=amazon-elasticache-cluster-client.so" in the file: 

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

  6. Start or restart your Apache server.

    sudo /etc/init.d/httpd start

 

To install PHP 5 on a Red Hat Enterprise Linux 7.0 AMI (64-bit and 32-bit)

  1. Launch a Red Hat Enterprise Linux instance (either 64-bit or 32-bit) and log into it.

  2. Install PHP dependencies:

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

  3. Download the correct php-memcached package for your Amazon EC2 instance and PHP version. For more information, see Downloading the installation package.

  4. Install php-memcached. The URI should be the download path for the installation package:

    sudo pecl install <package download path>

  5. With root/sudo permission, add a new file named memcached.ini in the /etc/php.d directory, and insert extension=amazon-elasticache-cluster-client.so in the file.

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

  6. Start or restart your Apache server.

    sudo /etc/init.d/httpd start

 

To install PHP 5 on a Ubuntu server 14.04 LTS AMI (64-bit and 32-bit)

  1. Launch an Ubuntu Linux instance (either 64-bit or 32-bit) and log into it.

  2. Install PHP dependencies:

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

  3. Download the correct php-memcached package for your Amazon EC2 instance and PHP version. For more information, see Downloading the installation package.

  4. Install php-memcached. The URI should be the download path for the installation package. 

    sudo pecl install <package download path>
    Note

    This installation step installs the build artifact amazon-elasticache-cluster-client.so into the /usr/lib/php5/20121212* directory. Verify the absolute path of the build artifact, because you need it in the next step.

    If the previous command doesn't work, you need to manually extract the PHP client artifact amazon-elasticache-cluster-client.so from the downloaded *.tgz file, and copy it to the /usr/lib/php5/20121212* directory.

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

  5. With root/sudo permission, add a new file named memcached.ini in the /etc/php5/cli/conf.d directory, and insert "extension=<absolute path to amazon-elasticache-cluster-client.so>" in the file.

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

  6. Start or restart your Apache server.

    sudo /etc/init.d/httpd start

 

To install PHP 5 for SUSE Linux enterprise server 11 AMI (64-bit or 32-bit)

  1. Launch a SUSE Linux instance (either 64-bit or 32-bit) and log into it.

  2. Install PHP dependencies:

    sudo zypper install gcc php53-devel

  3. Download the correct php-memcached package for your Amazon EC2 instance and PHP version. For more information, see Downloading the installation package.

  4. Install php-memcached. The URI should be the download path for the installation package. 

    sudo pecl install <package download path>

  5. With root/sudo permission, add a new file named memcached.ini in the /etc/php5/conf.d directory, and insert extension=amazon-elasticache-cluster-client.so in the file.

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

  6. Start or restart your Apache server.

    sudo /etc/init.d/httpd start
Note

If Step 5 doesn't work for any of the previous platforms, verify the install path for amazon-elasticache-cluster-client.so. Also, specify the full path of the binary in the extension. In addition, verify that the PHP in use is a supported version. We support versions 5.3 through 5.5.

 

Other Linux distributions

On some systems, notably CentOS7 and Red Hat Enterprise Linux (RHEL) 7.1, libsasl2.so.3 has replaced libsasl2.so.2. On those systems, when you load the ElastiCache cluster client, it attempts and fails to find and load libsasl2.so.2. To resolve this issue, create a symbolic link to libsasl2.so.3 so that when the client attempts to load libsasl2.so.2, it is redirected to libsasl2.so.3. The following code creates this symbolic link.

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