npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

node_memcached

v1.1.3

Published

Memcached client library

Downloads

19,834

Readme

node_memcached

这是一个为 node.js 开发的 memcached 客户端,使用二进制传输协议,支持 SASL 鉴权。特别针对阿里云 OCS 进行优化。

该项目基于 redismemjs 开发。

安装:

npm install node_memcached

从 0.2.x 版本迁移

从 0.2.x 版本迁移的开发者请注意,在所有的命令返回中不再使用 res.val.toString() 得到数据,直接使用即可:

  client.get('key', function(err, res) {
    // 不要这样
    console.log(res.val.toString());
  })

  client.get('key', function(err, res) {
    // 直接获取数据
    console.log(res);
  })

使用方法

  var PORT = 11211;
  var HOST = '127.0.0.1';
  var username = 'myname';
  var password = 'mypass';
  var memcached = require("node_memcached");

  var client = memcached.createClient(PORT, HOST, {
    username: username,
    password: password
  });

  client.on("error", function (err) {
    console.log("Error " + err);
  });

  // 10 为过期时间, 10秒
  client.set('hello', 'world', 10);

  client.get('hello', function(err, res) {
    console.log(err, res);
  });

  // 也可以不用设置过期时间
  client.set('number', 1);

  client.increment('number', 2);

  client.decrement('number', 1);

  client.get('number', function(err, res) {
    console.log(err, res);
  });

API

Connection Events

client 会发送以下事件.

"connect"

client 在与 memcached 服务器建立连接后发送 'connect' 事件, 但并不代表 client 已经可以向 memcached 发送命令。

"ready"

client 在发送 connect 事件后, 如果设置了 username 和 password,那么将在 SASL 鉴权 成功后发送 ready 事件, 否则会立即发送 ready 事件。 在 ready 事件之前,所有的命令都会被加入队列,一旦 ready 发送, 这些命令将会依次执行。

"error"

client 会在遇到无法处理的错误时发送 error 事件。

注意,在 node 中 error 是一个特殊的事件,如果 cliet 发送了这个事件而没有被侦听,那么将会导致 node 进程退出。因此 你应该在创建 client 的时候主动侦听该事件并作出相应处理。例如:

  var client = Memcached.createClient();
  client.on('error', function(err) {
    log('Error', err)
  })

"end"

client 会在与 memcached 断开连接后发送 end 事件。

createClient()

选项

redis.createClient() = redis.createClient(PORT, HOST);

redis.createClient() = redis.createClient(PORT, HOST, { username: '', password: '' })

  • PORT: memcached 服务器的端口号,默认为 11211
  • HOST: memcached 服务器的 IP 地址,默认为 127.0.0.1
  • username: 如果设置了该项,则启用 SASL 鉴权,否则直接连接 memcached 服务器。
  • password: 如果设置了该项,则启用 SASL 鉴权,否则直接连接 memcached 服务器。

createClient() 将返回一个 MemcachedClient 对象.

end()

强制关闭 client 与 memcached 服务器之间的连接。

自动重连

client 断开连接后,如果开发者没有调用 client.end(),则 client 将会自动尝试重新连接 memcached 服务器,初始延时为 150ms, 重连失败后延时加长,最长为 1 分钟并且会持续尝试直到连接成功。

打开调试信息

在运行 node 之前输出环境变量 DEBUG=node_memcached 将会打印调试信息。