# 启动时指定协议
memcached -B auto    # 自动检测（默认）
memcached -B ascii   # 只支持文本协议
memcached -B binary  # 只支持二进制协议

# Ubuntu/Debian
sudo apt-get install -y libmemcached-dev

# CentOS/RHEL
sudo yum install -y libmemcached-devel

# macOS
brew install libmemcached

# 源码编译
git clone https://github.com/memcached/libmemcached.git
cd libmemcached
./configure --enable-sasl
make -j$(nproc)
sudo make install

#include <stdio.h>
#include <string.h>
#include <libmemcached/memcached.h>

int main() {
    // 创建客户端实例
    memcached_st *mc = memcached_create(NULL);

    // 配置服务器
    memcached_server_st *servers = memcached_servers_parse("mc1:11211,mc2:11211");
    memcached_server_push(mc, servers);
    memcached_server_list_free(servers);

    // 配置一致性哈希
    memcached_behavior_set(mc, MEMCACHED_BEHAVIOR_DISTRIBUTION,
                           MEMCACHED_DISTRIBUTION_CONSISTENT);
    memcached_behavior_set(mc, MEMCACHED_BEHAVIOR_HASH,
                           MEMCACHED_HASH_MURMUR);

    // SET 操作
    memcached_return_t rc;
    rc = memcached_set(mc, "user:1001", 9,
                       "{\"name\":\"Alice\"}", 18,
                       (time_t)3600, (uint32_t)0);
    if (rc == MEMCACHED_SUCCESS) {
        printf("SET 成功\n");
    }

    // GET 操作
    size_t value_length;
    uint32_t flags;
    char *value = memcached_get(mc, "user:1001", 9,
                                &value_length, &flags, &rc);
    if (rc == MEMCACHED_SUCCESS) {
        printf("GET: %.*s\n", (int)value_length, value);
        free(value);
    }

    // 批量 GET
    const char *keys[] = {"user:1001", "user:1002", "user:1003"};
    size_t key_lengths[] = {9, 9, 9};
    rc = memcached_mget(mc, keys, key_lengths, 3);

    char return_key[MEMCACHED_MAX_KEY];
    size_t return_key_length;
    while ((value = memcached_fetch(mc, return_key, &return_key_length,
                                    &value_length, &flags, &rc)) != NULL) {
        printf("KEY: %s, VALUE: %.*s\n",
               return_key, (int)value_length, value);
        free(value);
    }

    // CAS 操作
    uint64_t cas_value;
    value = memcached_get_by_key(mc, NULL, 0, "balance", 7,
                                 &value_length, &flags, &cas_value, &rc);

    // 使用 CAS 更新
    rc = memcached_cas(mc, "balance", 7, "200", 3,
                       (time_t)0, (uint32_t)0, cas_value);
    if (rc == MEMCACHED_SUCCESS) {
        printf("CAS 更新成功\n");
    } else if (rc == MEMCACHED_DATA_EXISTS) {
        printf("CAS 冲突，需要重试\n");
    }

    // 清理
    memcached_free(mc);
    return 0;
}

# 编译
gcc -o mc_example mc_example.c -lmemcached
./mc_example

// 常用行为配置
memcached_behavior_set(mc, MEMCACHED_BEHAVIOR_NO_BLOCK, 1);        // 非阻塞 I/O
memcached_behavior_set(mc, MEMCACHED_BEHAVIOR_TCP_NODELAY, 1);     // 禁用 Nagle
memcached_behavior_set(mc, MEMCACHED_BEHAVIOR_SOCKET_SEND_SIZE, 1024*1024); // 发送缓冲区
memcached_behavior_set(mc, MEMCACHED_BEHAVIOR_SOCKET_RECV_SIZE, 1024*1024); // 接收缓冲区
memcached_behavior_set(mc, MEMCACHED_BEHAVIOR_CONNECT_TIMEOUT, 1000); // 连接超时(ms)
memcached_behavior_set(mc, MEMCACHED_BEHAVIOR_POLL_TIMEOUT, 1000);   // 轮询超时(ms)
memcached_behavior_set(mc, MEMCACHED_BEHAVIOR_RETRY_TIMEOUT, 5);     // 重试超时(s)
memcached_behavior_set(mc, MEMCACHED_BEHAVIOR_SERVER_FAILURE_LIMIT, 3); // 失败阈值
memcached_behavior_set(mc, MEMCACHED_BEHAVIOR_REMOVE_FAILED_SERVERS, 1); // 自动移除故障节点

# 设置
memcset --servers=localhost:11211 --key=test --value=hello --expire=60

# 获取
memcget --servers=localhost:11211 --key=test

# 删除
memcdelete --servers=localhost:11211 --key=test

# 批量操作
memcslap --servers=localhost:11211 --concurrency=50 --initial-load=1000

# 性能测试
memcping --servers=localhost:11211