An implementation of Play 2.0's CacheAPI which provides access to memcached using spymemcached.
Switch branches/tags
Nothing to show
Pull request Compare This branch is 115 commits behind mumoshu:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.

Memcached Plugin for Play framework 2.0

An implementation of CacheAPI for Play 2.0 final. Using spymemcached 2.6 internally, which is the same as Play 1.2.4.


Add the following dependency to your Play project:

  val appDependencies = Seq(
    "com.github.mumoshu" %% "play2-memcached" % "0.2.3-SNAPSHOT"
  val main = PlayProject(appName, appVersion, appDependencies, mainLang = SCALA).settings(
    resolvers += "Sonatype OSS Snapshots Repository" at "",
    resolvers += "Spy Repository" at "" // required to resolve `spymemcached`, the plugin's dependency.

Add a reference to the plugin in play.plugins file. play.plugins file must be put somewhere in the classpath. My recommendation is to put it in conf/ directory.


First of all, in application.conf, disable the EhCachePlugin - Play's default implementation of CacheAPI:


Specify the host name or IP address of the memcached server, and the port number:""

If you have multiple memcached instances over different host names or IP addresses, provide them like:"mumocached1:11211""mumocached2:11211"

Then, you can use the play.api.cache.Cache object to store a value in memcached:

 Cache.set("key", "theValue")

This way, memcached tries to retain the stored value eternally. Of course Memcached does not guarantee eternity of the value, nor can it retain the value on restart.

If you want the value expired after some time:

 Cache.set("key", "theValueWithExpirationTime", 3600)
 // The value expires after 3600 seconds.

To get the value for a key:

 val theValue = Cache.getAs[String]("key")

You can remove the value (It's not yet a part of Play 2.0's Cache API, though):


Additional configurations

Disabling the plugin

You can disable the plugin in a similar manner to Play's build-in Ehcache Plugin. To disable the plugin in application.conf:


Authentication with SASL

If you memcached requires the client an authentication with SASL, provide username/password like:


Configure logging

By default, the plugin (or the spymemcached under the hood) does not output any logs at all. If you need to peek into what's going on, set the log level like:


Version history

0.2.2 Fixed the logging leak issue. You don't get a bunch of INFO messages to play app's default logger anymore. 0.2.3 Allow removing keys in both Java and Scala ways described in Play's documentation. See MemcachedIntegrationSpec.scala for how to remove keys in Scala.

Build status

Build Status