1. Download the Memcache API and Integration module, and then add the module to your codebase in the modules/contrib/memcache directory. Acquia recommends that you use Composer to install the module:

   copy

   composer require drupal/memcache

   Note

   After you add the Memcache API and Integration module to your codebase through the preceding command, you do not need to additionally enable this module through the Drupal user interface or by using Drush.

2. For Cloud Classic, do the following:

   1. Add the Composer package that contains the Acquia Memcache settings to your project:

      copy

      composer require acquia/memcache-settings

   2. For each website that requires Memcached, edit the Cloud Platform database require line in settings.php with a PHP require_once statement, similar to the following example:

      copy

      if (file_exists('/var/www/site-php')) {
         require('/var/www/site-php/mysite/mysite-settings.inc');
         // Memcached settings for Acquia Hosting
         $memcache_settings_file = DRUPAL_ROOT . "/../vendor/acquia/memcache-settings/memcache.settings.php";
         if (file_exists($memcache_settings_file)) {
           require_once $memcache_settings_file;
         }
      }

   The same steps must be used for CD environments because CD environments are not supported in Cloud Next.

   Note

   For Cloud Next, you do not need to add anything to your settings.php file as the configuration logic is already included in Cloud Next. If you already have code in settings.php that enables Memcache integration with Cloud Platform, you can opt to remove it. However, if you follow the preceding steps outlined for Cloud Classic, your code can run on a Cloud Classic environment, and is auto-disabled when running in a Cloud Next environment.

3. Rebuild caches by running the following command, replacing [example.com] with the domain name of your website:

   copy

   drush cr --uri=[example.com]

4. Truncate all cache_ tables in the database for the website.

Memcache is now enabled for your website. Continue to read the next section.

If you need assistance, create a Support ticket.

1. Download the Memcache API and Integration module, and then add the module to your codebase in the modules/contrib/memcache directory. Acquia recommends that you use Composer to install the module:

   copy

   composer require drupal/memcache

   Note

   After you add the Memcache API and Integration module to your codebase through the preceding command, you do not need to additionally enable this module through the Drupal user interface or by using Drush.

2. Download cloud-memcache-d7.php, and add the contents of the file to your website’s settings.php file, after the Acquia database require line.

3. Clear caches by running the following command, replacing [example.com] with the domain name of your website:

   copy

   drush cc all --uri=[example.com]
   

4. Truncate all cache_ tables in the database for the website.

Memcache is now enabled for your website. If you need assistance, create a Support ticket.

For environments running on Cloud Next technologies, you can adjust the memory allocated to Memcached as follows:

1. Sign in to the Cloud Platform user interface and select your application and environment.

2. Click Actions > Configure Environment.

3. Click Advanced.

4. In Memcached memory (MB), enter the amount of memory to allocate to Memcached. A value of 64 MB is the default value for applications running on Cloud Platform. However, you can increase the value depending on your application needs. Acquia recommends that you set a mid-range value of 128 MB or 256 MB. Thereafter, you can use the acquia-memcache stats command to determine if you need more or less memory depending on your usage and evictions.

5. Click Save.

For environments running on the Cloud Classic infrastructure, you must create a Support ticket to request that your Memcached memory allocation be modified. Larger amounts of memory can be allocated to Cloud Classic environments with dedicated Memcached infrastructure. Contact your Acquia account team for more information about this advanced configuration.

You can leverage the Memcache binary protocol in Cloud Classic environments. However, Acquia does not recommend its use.

To use this protocol in Cloud Classic environments, ensure that you enable the Memcached::OPT_TCP_NODELAY flag in Memcache options to avoid slow fetches of empty cache items.