Memcached 项目技术文档

1. 安装指南

系统要求

• Ruby 版本：1.8.7 或 1.9.2（其他版本可能可行，但不保证兼容性）
• 额外依赖：libsasl2-dev 和 gettext 库（应通过系统包管理器安装）

安装步骤

1. 确保系统已安装所需版本的 Ruby。
2. 安装依赖库：

   sudo apt-get install libsasl2-dev gettext
   

3. 使用以下命令安装 memcached gem：

   sudo gem install memcached --no-rdoc --no-ri
   

2. 项目的使用说明

启动 Memcached 服务器

在本地网络中启动 Memcached 服务器：

$ memcached -p 11211 &

Ruby 代码示例

1. 引入 memcached 库并创建一个全局 Memcached 实例：

   require 'memcached'
   $cache = Memcached::Client.new("localhost:11211")
   

2. 设置和获取数据：

   value = 'hello'
   $cache.set 'test', value
   $cache.get 'test' # => "hello"
   

3. 设置带有过期时间的数据：

   value = 'hello'
   $cache.set 'test', value, 1
   sleep(2)
   $cache.get 'test' # => nil
   

4. 同时获取多个值：

   value = 'hello'
   $cache.set 'test', value
   $cache.set 'test2', value
   $cache.get ['test', 'test2', 'missing']
     # => {"test" => "hello", "test2" => "hello"}
   

5. 设置计数器并递增：

   start = 1
   $cache.set 'counter', start.to_s, 0, false
   $cache.increment 'counter' # => 2
   $cache.increment 'counter' # => 3
   $cache.get('counter', false).to_i # => 3
   

6. 获取服务器统计信息：

   $cache.stats # => {..., :bytes_written=>[62], :version=>["1.2.4"] ...}
   

3. 项目 API 使用文档

项目提供了对 memcached 的访问，包括设置、获取、删除、递增等操作。以下是一些关键方法的简要说明：

• set(key, value, expiration = nil, flag = nil)：设置键值对，可选的过期时间和标志。
• get(key)：获取指定键的值。
• delete(key)：删除指定键的值。
• increment(key, amount = 1)：递增指定键的值。
• stats：获取服务器的统计信息。

4. 项目安装方式

项目通过 Ruby gem 进行安装。请按照以下步骤进行：

1. 确保系统已安装所需版本的 Ruby 和依赖库。
2. 使用以下命令安装 memcached gem：

   sudo gem install memcached --no-rdoc --no-ri
   

以上步骤将帮助您成功安装和使用 memcached 项目。