MemJS is a pure Node.js client library for accessing the MemCachier service and other memcache servers. It uses the binary protocol and support SASL authentication.
NOTE: while memjs works with MemCachier, MemCachier is configured only to accept connections from authorized hosts (e.g. Heroku's servers). For local development, use memcache -- no code changes are required to work with MemCachier once the app is deployed. See below for local installation instructions.
Supported Node.js versions
MemJS is tested to work with version 0.6 or higher of Node.js.
MemJS is available from the npm registry:
$ npm install memjs
To install from git:
$ git clone git://github.com/alevy/memjs.git $ cd memjs $ npm link
MemJS was designed for the MemCachier memcache service but will work with any memcache server that speaks the binary protocol. Many software repositories have a version of memcacached available for installation:
$ apt-get install memcached
$ brew install memcached
You can start using MemJS immediately from the node console:
$ var memjs = require('memjs') $ var client = memjs.Client.create() $ client.get('hello', console.log)
MemJS understands the following environment variables:
MEMCACHIER_SERVERS- used to determine which servers to connect to. Should be a comma separated list of [hostname:port].
MEMCACHIER_USERNAME- if present with
MEMCACHIER_PASSWORD, MemJS will try to authenticated to the server using SASL.
MEMCACHIER_PASSWORD- if present with
MEMCACHIER_USERNAME, MemJS will try to authenticated to the server using SASL.
MEMCACHE_USERNAME- used if
MEMCACHIER_USERNAMEis not present
MEMCACHE_PASSWORD- used if
MEMCACHIER_PASSWORDis not present
Environment variables are only used as a fallback for explicit parameters.
- Add more commands (increment, decrement, flush)
- Support flags
- Support CAS
Copyright (c) 2012 Amit Levy, MemCachier. See LICENSE for details.