Install

Works with Drupal: 7.x

Using Composer to manage Drupal site dependencies

Downloads

Download memcache-7.x-1.7.tar.gztar.gz 59 KB
MD5: 57a6e7c7d547a7b8a0bc4ab5f72c6ac4
SHA-1: 5323871bd671acad5b90c07c3a30fcff62804b0f
SHA-256: a319546f627a029bd26fcee0f116a006349d3f06b91f4233b1475ecd8e5f0e2d
Download memcache-7.x-1.7.zipzip 68.45 KB
MD5: 39f2ee38b11396b8c6ab144fa98f5d2f
SHA-1: 1399ddcbc05ea524677a473810816adb4529ada9
SHA-256: 209628d4c7d67828a9fd767d110bdff7bca826b64949bfb086bca58e61ccfcbe

Release notes

The 20/20 DrupalCon Global Release

Overview

This release contains a number of important bug fixes, and some new features.

Do not use this release if you are using a version of PHP older than PHP 7! Due to an unintended dependency on PHP 7, you must instead upgrade to 7.x-1.8 where this has been fixed.

Performance

As with all Drupal Memcache module releases, we have done extensive load testing to confirm there are no performance regressions compared to earlier releases. For this release we used Goose to consistently simulate and compare realistic high-traffic conditions in multiple configurations.

New Features

ASCII protocol authentication

(#3150893: Add Memcached ascii authentication support)

From README.txt:

#### ASCII Protocol Authentication

If you do not want to enable the binary protocol, you can instead enable token authentication with the default ASCII protocol.

ASCII protocol authentication requires Memcached version 1.5.15 or greater started with the -Y flag, and the PECL memcached client. It was originally documented in the memcached 1.5.15 release notes:
https://github.com/memcached/memcached/wiki/ReleaseNotes1515

While it will work with 1.5.15 or greater, it's strongly recommended you use memcached 1.6.4 or greater due to the following bug fix:
https://github.com/memcached/memcached/wiki/ReleaseNotes164

Additional detail about this feature can be found in the protocol documentation:
https://github.com/memcached/memcached/blob/master/doc/protocol.txt

All your memcached servers need to be started with the -Y option to specify a local path to an authfile which can contain up to 8 "username:pasword" pairs, any of which can be used for authentication. For example, a simple authfile may look as follows:

  foo:bar

You can then configure your website to authenticate with this username and password as follows:

  $conf['memcache_ascii_auth'] = 'foo bar';

Enabling ASCII protocol authentication during load testing resulted in less than 1% overhead.

Configure memcache to behave like DB cache

(#1634506: Allow expired items to make use of stampede protection; ensure that memcache optionally behaves like DB cache)

From README.txt:

## STRICT COMPATIBILITY WITH DB CACHE EXPIRATIONS ##

Due to the way database caching works, the native Drupal cache will return expired cache objects which were set to expire in the future even after their expiration timestamp, because it doesn't clean up cache entries until the cache bins are garbage collected (normally during a cron.php run's general cache wipe). However, memcache can expire cached items at the specific time requested. Therefore the default behavior of the memcache module does not match the Drupal API for cache_set, which states that cache items set to expire in the future are kept at least until the given timestamp, after which they behave like CACHE_TEMPORARY (removed at the next general cache wipe).

If you wish to return to the behavior described in the cache_set API, and allow expired entries to appear valid until a general cache wipe, define the following in settings.php:

  $conf['memcache_expire_wait_gc'] = TRUE;

This setting works independently from stampede support, though it changes the time at which timestamp-cached items are considered expired, and therefore affects the time at which stampede behavior happens (if enabled).

Compression enabled by default with PECL-memcached

(#2996888: enable compression by default with memcached extension (D7 branch))

## Memcached PECL Extension Support

An example configuration block is below, set in settings.php:

  $conf['memcache_options'] = array(
    Memcached::OPT_COMPRESSION => FALSE,
  );

+ Memcached::OPT_COMPRESSION => FALSE,
* This disables compression in the Memcached extension. This may save some CPU cost, but can result in significantly more data being transmitted and stored. See: https://www.drupal.org/project/memcache/issues/2958403

Note: compression was already enabled by default with the PECL-memcache extension.

Upgrade minimum PECL-memcache requirements for PHP 7

(#3155134: pecl memcache module with php 7 requires version 4.0.5+)

The memcache module continues to recommend the PECL memcache extension (instead of the PECL memcached extension) for increased stability. If using PHP7+, it is important to use PECL extension 4.0.5.1 or newer:
https://pecl.php.net/package/memcache

All Changes In This Release

Created by: Jeremy
Created on: 16 Jul 2020 at 05:12 UTC
Last updated: 17 Jul 2020 at 14:47 UTC
Bug fixes
New features

Other releases